GetHRConstantsInformation

F08040 - Get HR Constants Information

Minor Business Rule

Object Name: N0800069

Parent DLL: CFND

Location: Client/Server

Language: NER

Functional Description

This NER returns the values in the F08040 (Payroll Company Constants/HR History Constants) table.  If the key value is Null then the NER assumes 

that the file is still a single record table and returns the values of the first record found.  If the key value is non-Null then the NER will return the values 

in the record with the matching key.  All error conditions are returned in cErrorCode; no hard errors are generated.   


SetUp Notes


Technical Specifications


Parameters


Data Item Data Structure DescriptionI/ORequired  TableNotes

DTALszDataFileLibraryI/O  F08040If specified, will match record.

HRSSszHrSubSystemI/O  F08040If specified, will match record.

EMPHcemployeeHistoryOF08040

EH01cEmpHistoryPrompt001OF08040

EH02cEmpHistoryPrompt002OF08040

EH03cEmpHistoryPrompt003OF08040

EH04cEmpHistoryPrompt004OF08040

EH05cEmpHistoryPrompt005OF08040

EH06cEmpHistoryPrompt006OF08040

EH07cEmpHistoryPrompt007OF08040

EH08cEmpHistoryPrompt008OF08040

EH09cEmpHistoryPrompt009OF08040

EH10cEmpHistoryPrompt010OF08040

USERszUserIdOF08040

PIDszProgramIdOF08040

UPMJjdDateUpdatedOF08040

JOBNszWorkStationIdOF08040

FLXCmnFlexCreditsPerDollarOF08040

YORNcUseAssignmentWindowOF08040

PRSRcPayRateSourceOF08040

SPRScStepProgressionRateSourcOF08040

PBF1cPositionBudgetEditSalaryOF08040

PBF2cPositionBudgetEditFTEOF08040

PBF3cPositionBudgetEditHoursOF08040

PBF4cPositionBudgetEditHeadctOF08040

PRF1cPayRangeEditOF08040

SDFScSalaryDefaultSourceOF08040

SIPcSalaryIncreasesinProjectOF08040

SALDcSalaryDisplayOF08040

EV01cErrorCodeO


cErrorCode values:


0 = no errors; program processed successfully 

1 = No record found

2 = Record not found


Related Tables 


Table Table Description

F08040HR History Constants


Processing 


cErrorCode = 0

if szDataFileLibrary is not blank or szHrSubSystem is not blank

    FetchSingle the F08040 record and return all values

    if File_IO_Status is equal to CO_Error then

        cErrorCode = 2

    end if

else    /* Both szDataFileLibrary and szHrSubSystem are blank  */

    Open F08040 table

    Select All F08040

    FetchNext the F08040 record and return all values

    if File_IO_Status is equal to CO_Error then

        cErrorCode = 1

    end if

end if


Data Structure

DN0800069 - F08040 - Get HR Constants Information

Parameter NameData ItemData TypeReq/OptI/O/Both
szDataFileLibraryDTALcharOPTBOTH

The name of the data file library in which the data queue exists.  Whenever a change is made to the History Constants Information, the 
program automatically determines which library the Employee Master file is in and creates the data queue in the same library.  This library is 
normally called the Production Library.

szHrSubSystemHRSScharOPTBOTH

This is the name of the HR subsystem. This subsystem is created (if it doesn't already exist) when the option to start the HR subsystem is 
selected. Since the HR monitor executes this subsystem, it is important to know the name of the subsystem so you can determine if the monitor 
is running.

cEmployeeHistoryEMPHcharOPTOUTPUT

A code that determines whether the system creates employee history records when you enter or change employee information. The 
system can create employee history records for only that information that is stored in the Employee Master table (F060116). To specify the 
information for which you want to track history, use the program, Select Data Items for History Tracking (P08041). Employee history records are 
stored in the HR History table (F08042). For World:  Before the system can create history records, you must start the Human Resources subsystem 
and monitor.

cEmpHistoryPrompt001EH01charOPTOUTPUT

A code that indicates the date on which the system creates employee history and turnover records, in relation to the date of the change. 
This field controls the dates that appear on history and turnover reports and review forms. It does not function as a suspense operation that 
allows you to enter a change now, and update the history and turnover tables at a later time. When this field is activated, the system tracks both 
the effective date of a change and the date that the change was entered into the system. Valid values for World are:    Y  Yes, use the effective 
date of the change (data item EFTO) to track employee history and turnover    N  No, instead of using the effective date of change, use the 
date on which you entered changes into the system  Valid values for OneWorld are:    On  Use the effective date of the change (data item EFTO) 
to track employee history and turnover    Off  Instead of using the effective date of change, use the date on which you entered changes into the 
system If you choose  to use the effective date of the change, the system prompts you to enter an effective date each time you change any 
employee information for which you are tracking history or turnover. If you choose to use the effective date of the change, you must also 
choose to track employee history, employee turnover, or both.

cEmpHistoryPrompt002EH02charOPTOUTPUT

A code that determines whether the system creates employee turnover records when you change employee information. Turnover 
information consists of any records in the Employee Turnover Analysis table (F08045) with a change reason that is not blank. For World: Before the 
system can create turnover records, you must start the Human Resources subsystem and monitor.

cEmpHistoryPrompt003EH03charOPTOUTPUT

A code that indicates whether you want the system to create records in the Position Activity table (F08111) when you enter or change 
position-related information for an employee. If you choose to use this feature, you must also choose to track employee history.

cAutoReqPromptEH04charOPTOUTPUT

This field specifies whether the system automatically creates a requisition for the position when you terminate an employee.

cPositionControlPromptEH05charOPTOUTPUT

This code determines whether you are using the position control feature and,if so, whether all employees are required to have a position 
ID. Valid codes are:    1   Position ID is required.    2   Position ID is optional. The Position ID field appears on the HR Employee Entry form.    3   
Position ID is not required, and the Position ID field does not appear on the HR Employee Entry form. If you leave this field blank, the system 
assumes that the Position ID is optional (code 2). When you set this option to position ID required, the job ID associated with a position in the 
Position Master table becomes the default job for the employee.

cEmpHistoryPrompt006EH06charOPTOUTPUT

An HR Employee History flag reserved for future use.

cEmpHistoryPrompt007EH07charOPTOUTPUT

An HR Employee History flag reserved for future use.

cEmpHistoryPrompt008EH08charOPTOUTPUT

An HR Employee History flag reserved for future use.

cEmpHistoryPrompt009EH09charOPTOUTPUT

An HR Employee History flag reserved for future use.

cEmpHistoryPrompt010EH10charOPTOUTPUT

An HR Employee History flag reserved for future use.

szUserIdUSERcharOPTOUTPUT

The code that identifies a user profile.

szProgramIdPIDcharOPTOUTPUT

The number that identifies the batch or interactive program (batch or interactive object). For example, the number of the Sales Order Entry 
interactive program is P4210, and the number of the Print Invoices batch process report is R42565. The program ID is a variable length value. 
It is assigned according to a structured syntax in the form TSSXXX, where: T The first character of the number is alphabetic and identifies the 
type, such as P for Program, R for Report, and so on. For example, the value P in the number P4210 indicates that the object is a 
program. SS The second and third characters of the number are numeric and identify the system code. For example, the value 42 in the number P4210 
indicates that this program belongs to system 42, which is the Sales Order Processing system. XXX The remaining characters of the numer are 
numeric and identify a unique program or report. For example, the value 10 in the number P4210 indicates that this is the Sales Order Entry 
program.

jdDateUpdatedUPMJJDEDATEOPTOUTPUT

The date that specifies the last update to the file record.

szWorkStationIdJOBNcharOPTOUTPUT

The code that identifies the work station ID that executed a particular job.

mnFlexCreditsPerDollarFLXCMATH_NUMERICOPTOUTPUT

This field determines how many Flex Credits equal one Dollar.  This field is for informational purposes only and will not affect how the 
Employee DBA Instructions are created during Benefit Enrollment. For instance:  If you allow "leftover" Flex Credits to be deposited into an 
employee's 401K plan but want to encourage the employees to be well insured,you can specify that only one dollar will go into the 401K plan for 
every two Flex Credits leftover.

cUseAssignmentWindowYORNcharOPTOUTPUT

This field specifies whether the system displays the Employee Assignment window when an employee changes to a new job, position, or 
home business unit. You use the employee assignment window to update requisition information for the requisitions affected by the change.

cPayRateSourcePRSRcharOPTOUTPUT

This constant specifies the default source for employee pay rates. When you add or change employee information, the system uses this 
constant to locate a pay rate for an employee when you leave the salary and hourly rate fields blank. Pay Rate Source    1   Pay Rate Tables    
2   Pay Grade Step Table    3   None You choose a pay rate source in Setting Up System Options. To calculate a salary for the employee, the 
system multiplies the employee's standard hours per year by the hourly rate from the table.

cStepProgressionRateSourcSPRScharOPTOUTPUT

This field specifies the default pay grade step that the system uses to locate a pay rate for employees who have a salary forecast change 
date. The system uses this rate to calculate annual position budget amounts that are based on employee records. Step Progression Rate:    
1   Same Grade Step    2   Next Grade Step 

cPositionBudgetEditSalaryPBF1charOPTOUTPUT

This field specifies whether you want the system to use position budget editing, and if so, whether the system displays a warning or error 
message when you enter or change a salary that is over the budgeted salary for the position. The system checks (edits) the Salary, Hourly 
Rate and Position fields on P0801CMP against the Position Master Table (F08101).   Valid values are:    Blank No edit    1       Warning message 
if over budget, but allowed to continue.    2       Hard error if over budget, processing stops, no table updates.

cPositionBudgetEditFTEPBF2charOPTOUTPUT

This field specifies whether you want the system to use position budget editing for full-time equivalents (FTE), and if so, whether the system 
displays a warning or error message when a change to the the full-time equivalent field is not within the budgeted full-time equivalents for the 
position.   Allowed values are:    Blank No edit    1       Warning message if over budget, but allowed to continue.    2       Hard error if over budget, 
processing stops, no table updates.

cPositionBudgetEditHoursPBF3charOPTOUTPUT

This field specifies whether you want the system to use position budget editing for work hours, and if so, whether the system displays a 
warning or error message when the employee's work hours are not within the budgeted effective hours for the position.   Allowed values are:    
Blank No edit    1       Warning message if over budget, but allowed to continue.    2       Hard error if over budget, processing stops, no table 
updates.

cPositionBudgetEditHeadctPBF4charOPTOUTPUT

This field specifies whether you want the system to use position budget editing for headcount, and if so, whether the system displays a 
warning or error message when you enter or change headcount that is not within the budgeted effective headcount for the position.   Allowed 
values are:    Blank No edit    1       Warning message if over budget, but allowed to continue.    2       Hard error if over budget, processing stops, no 
table updates.

cPayRangeEditPRF1charOPTOUTPUT

This field specifies pay range minimum and maximum, or pay grade step amount editing.    Allowed values are:    blank No Edit    1       
Warning message if out of range for pay grade or not the pay grade step amount, processing allowed to continue.    2       Hard error if out of range 
for pay grade or not the pay grade step amount, processing stops, no file updates.

cSalaryDefaultSourceSDFScharOPTOUTPUT

This field specifies the salary/rate default source for creating new positions or defining vacancies when the Create Next Year's Position 
program (P081820) is run. Allowed values are:    blank None    1       Pay Grade Minimum    2       Pay Grade Midpoint    3       Pay Grade Maximum    4  
     Pay Grade Step Amount When the pay grade step is the source, that table's calculated hours/year (hours per day times days per  year) 
will be used as the default standard hours per year.  If this data does not exist in the table, the normal defaults will be used to  determine the 
standard hours per year basis:     o Home Company Standard Hours Per Year     o Default Company Standard Hours Per Year     o Data 
Dictionary     o 2080 

cSalaryIncreasesinProjectSIPcharOPTOUTPUT

This constant determines if future rate changes, based on an employee's salary forecast change date, will be taken into account in the 
calculation of position projected year end values. Valid values are:    Y Yes    N No 

cSalaryDisplaySALDcharOPTOUTPUT

A field that specifies whether the system displays annual or effective salaries for employees. An employee's annual salary is the number of 
hours per year that the employee works multiplied by the employee's hourly rate. The effective salary is (annual salary divided by pay 
frequency) multiplied by periods to pay. For employees whose jobs are associated with a contract calendar, the system recalculates the effective 
salary if you enter a mid-calendar salary adjustment for the employee. After you enter a mid-calendar adjustment, the effective salary 
equals the salary that is to be paid to the employee from the time of the adjustment to the end of the contract. You can set up your system to use the 
Pay Grade Step table as the source of employee pay rates. The pay rates in the Pay Grade Step table are based on the table's number of 
hours worked per year (hours per day time days per year). When the employee's standard hours per year are different than the amount in 
the table, the employee's hours per year times the table's hourly rate is the employee's effective salary. When the table hours and employee 
hours are the same, the employee's effective and annual salaries are the same. For OneWorld:    Valid values are:         On   Display annual 
salaries         Off   Display effective salaries For World:    Valid values are:         A     Display annual salaries         E     Display effective salaries 

cErrorCodeEV01charOPTOUTPUT

An option that specifies the type of processing for an event.

Related Functions

None

Related Tables

None