Skip to main content
Skip table of contents

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
CC = Pay Cycle
NN = Pay Period Number
S = Supplemental Number

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

 

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.