AK PERS DOCUMENTATION
Overview
The entire suite of processes for handling PERS/TRS consists of the PYRERRAKUP screen used to centralize control of various available plans, retirement CDH assignments, etc. Three payroll processes used to 1) extract retirement data from the payroll database, 2) allow direct user update of extracted retirement data and 3) report retirement data and prepare a file for submission to the state. This guide documents only the three payroll processes.
The three payroll processes are available via mask PYRERRAKxx. The report process asks for the name of the output file which can consist of up to eight characters consisting of the letters A-Z and numbers 0-9.
The extract process can be run repeatedly until the desired results are obtained.
Specifying the Period Number at Runtime
For the extract process (PYRERRAKEX), if a “main” period number is input, the process will include the main period and all paid supplemental periods. If a supplemental period is input, the extract process will include only the supplemental period.
For the update process (PYRERRAKUP), one can update all records for the main period and supplemental periods regardless of whether or not a main period or a supplemental period is input. If a new record is added, the record will be tagged with the period number input at runtime.
For the report/file generation process (PYRERRAKRE), if a main period is input, all records will be processed. If a supplemental period is input, only records extracted or new records added via the update process with the runtime period question matching the input supplemental period will be processed.
For example, the extract process and the report/file generation process are run for a main period that may include some paid supplemental periods and the file is submitted to the state. Later another supplemental payroll is run for some reason. Naturally, these employees were not included in the file submission. The extract and report/file generation processes can be run using this additional supplemental period number and 1) the report and file will include only those employees in the supplemental run and 2) the Payroll records will be flagged as a payroll adjustment rather than a normal current payroll.
CDH Setup
A particular miscellaneous code number, e.g., miscellaneous code 5, must be specified via common codes to identify retirement-related CDHs. The value of this “retirement” miscellaneous code will determine the type of processing as follows:
Misc Code Value | Description |
---|---|
R01 | Used for all hour codes that will add to the hours worked and amount subject to retirement |
R02 | Used for Indebt Payment Post-tax |
R03 | Used for Employee Contribution |
R04 | Used for Employee Voluntary/Supplemental |
R05 | Used for Employer Contribution |
R06 | Used for Employer HRA |
R07 | Used for Employer Retiree Medical |
R08 | Used for Employer ODD |
R09 | Used for Indebt Payment Pre-tax |
R10 | Used for Additional Employee Contribution Pre-tax |
R11 | Used for Additional Employee Contribution Post-tax |
R12 | Used for Employer DBUL |
For example, suppose the common code is set so retirement defining miscellaneous codes are to be put in miscellaneous code 5 of the CDH definition. To define hour codes that will contribute to retirement hours and amounts, enter “R01” in miscellaneous code 5 of each of these hour codes. Enter “R03” in miscellaneous code 5 of the deduction(s) used for the employee’s contribution to retirement, etc.
Business Rules
Qualifying Employees for Inclusion in the Retirement Extract
The extract process (PYRERRAKEX) first qualifies employees as subject to retirement. Note that, even if an employee is subject to retirement, the employee may not generate any retirement data (nothing is generated if there is nothing to report). An employee 1) must have a pay cycle that matches the pay cycle of the period being processed and 2) the employee must have a record in PYRERRAKUP to qualify for processing.
Determination of Events
There can be more than one event reported in any particular period, e.g., a STAT and a TERM event are possible within the same period. The following table lists the events and what triggers the event.
Event | Trigger |
---|---|
HIRE | The employee has never been reported or the last event reported was HIRE and the employee has a retirement contribution or deduction assignment starting in the current period. |
TERM | The employee has a retirement contribution or deduction ending in the current period and has no other retirement contribution or deduction assignments active beyond the current period. |
LWP or ALWP | The employee has missed a number of days of work continuously without charging to an hour code with R01 in the retirement miscellaneous code. |
STAT | An employee has charged to an hour code with R01 in the retirement miscellaneous code and had been previously reported with a LWP/AWLP event. The employee has a PM pay assignment starting in the current period and the last event reported was TSE. The employee’s occupation code or status has changed. |
TSE | The employee has a PM pay assignment ending in the current period and does not have another PM pay assignment starting one day later. |
Common Code Setup
PYFG/268AK - Retirement Extract
This common code is used to control the Alaska Retirement Extract Program.
Code Category: PYFG
Code Value: 268AK
Short Description: Set to DEBUGSOV to show the derivation of values on the tail sheet.
Medium Description:
Long Description: Enter your organization name here.
Associated Codes:
Various “key” values can be input to any one of the five Associated Codes. The corresponding Associated Value or Associated Description may be required to clarify the key value. The following table indicates the possible key values and any requirements for the associated value/description.
Assoc. Value | Assoc. Code | Assoc. Description |
---|---|---|
| USER DEBUG | If DEBUGSOV is set, set this value to your user ID you use when you log into IFAS. Note you will get the source of value debug display on your tail sheet but others will not. |
| PAY PERIOD | Set this to either YYCCSNN or YYCCNNS to match your pay period numbering scheme where: YY = Year Use YYCCSNN if your supplemental number falls in the third to last position of your pay period number. Use YYCCNNS if your supplemental number is the last digit of your pay period number. |
Set this to the number of days an employee needs to be LWOP before being reported LWOP. E.g., a value of 20.00000 means an employee must be LWOP for 20 or more continuous days in a row before being reported as LWOP for retirement reporting. The LWOP event will be reported on the 20th day. | EMPLYMENT GAP |
|
Debug Source of Value (DEBUGSOV)
Often questions arise as to how the extract process derives some of the values. A “debug source of value” setting can be made in common code PYFG/268AK which causes the tail sheet to display how it derived the values reported. This is an important analysis tool and should be used before calling the Helpdesk. Note this capability generates a lot of information on the tail sheet so it should be used on only a small set of employees and should be turned off before a production run.
PYFG/368AK - Retirement Edit/Update
This common code is used to control the Alaska Retirement Edit/Update Program.
Code Category: PYFG
Code Value: 368AK
Short Description: Set to DEBUG to show program flow and various values.
Medium Description: Enter the organization’s code.
Long Description: Enter the organization’s name here.
Associated Codes
Various keyword values may be entered in any one of the five Associated Codes lines. The corresponding Associated Value or Associated Description may be required to clarify the keyword value. Unless otherwise indicated, keywords may be entered in any order.
The following table indicates the possible keyword values and any requirements for the Associated Value and/or Description fields.
Assoc. Value | Assoc. Code | Assoc. Description |
---|---|---|
| USER DEBUG ID | Enter the ID of the individual user who wants to see debug statements. Only this user will see debug statements if the word DEBUG is entered in the Short Description field of this common code. Normally set by SBI with their login Id. |
| STARTUP MODE | Enter BROWSE or COLLECT |
PYRERRAKUP - View/Update of Data
On PYRERRAKUP, only previously extracted data from the pay period will be shown. If the user wishes to change the data being displayed/updated to a different pay period, place the page in Find mode and enter the period number in the Period field.
Employee data is displayed in Name sequence for the selected period.
To find data for a specific ID or Name within the currently selected Pay Period, search for the ID/Name and Pay Period.
CDD Reporting
The retirement processing uses the PYRE_EMP_LVL_DTL table to store employee-specific information, e.g., fund code, while the PYRW_WORK_DTL dataset is used to store pay period history detail information. Both tables are “keyed” by Employee ID and extract date (which is the pay period ending date). There is only one PYRW_WORK_DTL record per employee per pay period.
If there is a PYRW_WORK_DTL record for an employee for a period, there can be a number of PYRE_EMP_LVL_DTL records. There will always be one “BASIC INFO” record where PYRE_REC_ID = “BASIC INFO”. There may also be any number of “EVENT” records, one for each EVENT, where PYRE_REC_ID = “EVENT”.
The following table maps field names to the values pertinent to Alaska Retirement.
PYRE_EMP_LVL_DTL table – BASIC INFO record | |
Table Column Name | Content |
HR_PE_ID | Employee ID |
PYRE_EXTRACT_DT | Period End Date |
PYRE_REC_ID | “BASIC INFO” |
PYRE_FLAG01 | Status (“F” = full time, etc.) |
PYRE_FLAG02 | Fund Code (“P” for PERS, etc.) |
PYRE_FLAG03 | Occupation Code (“A”, “D”, etc.) |
PYRE_ALPHA01 | Action Code (<blank>,“NEW”, “CHG”,”NAME”) |
PYRE_ALPHA02 | Plan Code (“DB” OR “DC”) |
PYRE_EMP_LVL_DTL table – EVENT record | |
PYRE_EMP_ID | Employee ID |
PYRE_EXTRACT_DT | Period End Date |
PYRE_REC_ID | “EVENT” |
PYRE_ALPHA01 | Event (“HIRE”, “STAT”, etc.) |
PYRE_DATE01 | Event Date |
PYRW_WORK_DTL table | |
Table Column Name | Content |
HR_PE_ID | Employee ID |
PYRW_EXTRACT_DT | Period End Date |
PYRW_RPT_PERIOD | Period number specified at run time |
PYRW_WAGE_AMT01 | Earnings Amount |
PYRW_WAGE_HRS01 | Hours Worked |
PYRW_CD_AMT01 | Indebt Payment Post-tax |
PYRW_CD_AMT02 | Employee Contribution |
PYRW_CD_AMT03 | Employee Voluntary/Supplemental |
PYRW_CD_AMT04 | Employer Contribution |
PYRW_CD_AMT05 | Employer HRA |
PYRW_CD_AMT06 | Employer Retiree Medical |
PYRW_CD_AMT07 | Employer ODD |
PYRW_CD_AMT08 | Indebt Payment Pre-Tax |
PYRW_CD_AMT09 | Additional Employee Contribution Pre-Tax |
PYRW_CD_AMT10 | Additional Employee Contribution Post-Tax |
PYRW_CD_AMT11 | Employer DBUL |