You specify pay dates (check dates) when you define your payroll. The default pay date is the day on which the pay period ends. If your agency issues its checks later than the pay period, you can enter an offset, the number of days that elapse between the end of the pay period and your pay date. For previously defined payrolls, you can change the pay dates you maintain in Oracle HRMS by running the Check Date Setup process.
See: Defining Pay Dates
If you do not use the Oracle HRMS Payroll window to maintain your pay period dates and pay dates, you can have the application call a user hook GHR_AGENCY_GENERAL to return the pay dates from your code.
The following table includes the information that the application supplies.
| User Hook information | Values |
|---|---|
| File name | GHR_AGENCY_GENERAL |
| Package name | ghagngen.pkg |
| Function names | get_agency_check_date get_agency_last_check_date |
| Input Parameters | Person_id, Assignment_id, Effective_Date, Payroll_id |
The effective date is the pay period end date. Your code returns the pay date for that pay period. For example, for a pay period running from November 1 to November 15, the application uses November 15 as the effective date. If you maintain a pay date offset of four days, your code returns a pay date of November 19.
The user hook includes two functions:
get_agency_check_date supplies the pay date as of the effective date (the pay period end date)
get_agency_last_check_date returns the last pay date that falls in same calendar year as the effective date
For example, if the pay period runs from December 10 to December 24, and your pay date offset is four days, you would return December 28 as the last pay date for the calendar year. The application uses this last pay date as a basis for de-enrolling employees from TSP Catch-up at the end of the year.