RetrieveYearEndControlTableInfo

Retrieve Year-End Control Table Information

Minor Business Rule

Object Name: N0700480

Parent DLL: CHRM

Location: Client/Server

Language: NER

Data Structure

D0700480 - Retrieve Year-End Control Table Information

Parameter NameData ItemData TypeReq/OptI/O/Both
szYearEndIDIDYEcharREQINPUT

A value you assign to each year-end workfile build. The ID must be unique within each calendar year or information can be overwritten and 
lost. The year-end ID identifies a group of records to be processed for year-end purposes. The year-end ID can also be used to identify 
records for a particular company if the workfile build for that particular ID included employees from only one company.

cProcessTypePTYEcharOPTNONE

A user defined code (07Y/WP) that designates the type of processing for the year-end workfile build.

cVersionType9VTYEcharOPTNONE

A user defined code (07Y/VT) that designates valid version types for creating W-2s and 1099s.

szVersionVERScharOPTNONE

A user-defined set of specifications that control how applications and reports run. You use versions to group and save a set of user-defined 
processing option values and data selection and sequencing options. Interactive versions are associated with applications (usually as a 
menu selection). Batch versions are associated with batch jobs or reports. To run a batch process, you must choose a version.

cTaxIdSummationTIScharOPTNONE

A code that specifies whether companies with the same corporate tax ID are to be summarized into one reporting record. To specify a 
parent, enter a parent company number in the detail area of the Corporate Tax ID form. Access the Corporate Tax ID form from the Taxes and 
Insurance menu, G0744. If you do not specify a parent company, the W-2 Workfile Build uses the lowest company number as the parent. Note:  
When summarizing by tax ID, PeopleSoft recommends that you enter the parent company numbers in the detail area of the Corporate Tax ID 
form.  The parent company number for the parent company is its own company number.

mnFicaAnnualLimitSSDLMATH_NUMERICOPTNONE

The maximum amount of taxable wages to be reported for FICA. The system uses the current year's default value for this field if you define 
the default amount in data dictionary item SSDL.

mnMedicareAnnualLimitMDDLMATH_NUMERICOPTNONE

The maximum amount of taxable wages to be reported for MEDICARE.

mnTierIAnnualLimitT1DLMATH_NUMERICOPTNONE

The maximum amount of taxable wages to be reported for Tier I. The system uses the current year's default value for this field if you define 
the default amount in data dictionary item T1DL.

mnTierIiAnnualLimitT2DLMATH_NUMERICOPTNONE

The maximum amount of taxable wages to be reported for Tier II. The system uses the current year's default value for this field if you define 
the default amount in data dictionary item T2DL.

mnTapeDensityTAPDMATH_NUMERICOPTNONE

The density at which your output tape will be recorded. The densities acceptable to the Social Security Administration and to Revenue 
Canada and to the Ministere du Revenu du Quebec are 1600, 6250, and 38000. To indicate 38000, enter 3800. This will be handled by the 
program. The density to select depends on the tape drive you use.

szMagneticMediaFileIdMMFIcharOPTNONE

The name the system uses internally to identify the tape file. This should always be 'QTAPE'.

szTapeDeviceNameDEVNcharOPTNONE

The name of the tape device to which magnetic media is to be sent.

mnW2LaserCopiesW2LCMATH_NUMERICOPTNONE

Enter the number of laser copies to be printed. If you are NOT printing Laser Forms ALWAYS LEAVE AS "00".

cW2NameFormatW2NFcharOPTNONE

A code that specifies the format of the names for employees and employers the system uses on the W-2 and magnetic media. Valid 
values are: 1 Alpha name (ALPH) 2 First name, middle name, and last name (GNNM, MDNM, and SRNM) Note: The federal government requires 
data entry for an employee name in the following sequence format: first, middle initial, last. Choose the field from the Address Book - Who's Who 
table (F0111) that displays the employee name in this order.

cPrintBenefitStatementsW2PScharOPTNONE

A code which indicates whether the Print Benefit Statement job is to be submitted automatically when the Print W-2 form is submitted. Please 
note that the Special Handling Amounts will be printed on the W-2 for boxes 10, 11, 12, 13 and 14 regardless if you answer Y to this 
option. The Benefit Statement will provide more detail than the information printed on the W-2.

cFederalInfoOnFormsW2FIcharOPTNONE

A code that specifies whether the federal wage and tax information is to be printed on all W-2 forms to be issued to the employee. Valid 
values are:    Y Prints the federal wage and tax information on every form the employee receives.    N Prints only federal wage and tax 
information on the form containing the employee's base state information. Note: For railroad employees, enter N in this field if you have set up 
additional entries for box 14 through special handling.

cAllocateFederalWageW2AWcharOPTNONE

A code specifying whether the the federal wages, tips and other compensation amount should be allocated to each state where the 
employee had earnings. This field applies if you have multiple W-2s for employees. Valid values are:    N Do not allocate the federal wages, tips 
and other compensation to the states. All federal information will print on the W-2             that contains the base state information unless you 
answered Y to Print Federal Information on all forms. In this case, you         will receive the same federal information on all W-2s for the employee.    
Y Allocate the federal wages, tips and other compensation between each state in which the employee has wages. The        allocation will look 
at total state wages and determine each state's percentage of the total. An equal percentage of federal         wages will be allocated to the 
different states.

cPrint2StatesW22ScharOPTNONE

A code that specifies whether the system prints one or two states on each IRS Form W-2 that is issued to an employee. Valid values 
are: Y Yes, print two states per form. N No, print only one state per form. Caution: This value must be set to N if you use 4-part laser forms. This form 
includes only one box for state information and cannot accommodate information for more than one state. Note: If you set the value to Y, you 
cannot sort IRS Form W2 forms by state. All other IRS Form W2 forms (standard and laser) include two boxes for local information and print 
correctly when this value is set to Y.

cStatusYearEnd9FS01charOPTNONE

A user defined code (07Y/SS) that designates the status of the workfile build process for year-end.

cStatusYearEnd99FS02charOPTNONE

A user defined code (07Y/SS) that designates the status of year-end audit reports.

cStatusYearEnd999FS03charOPTNONE

A user defined code (07Y/SS) that designates the print status of the year-end forms.

cStatusYearEnd9999FS04charOPTNONE

A user defined code (07Y/SS) that designates the status of magnetic media processing for year-end.

cStatusYearEnd99999FS05charOPTNONE

A user defined code (07Y/SS) that designates the status of the reset workfile process for year-end.

cStatusYearEnd999999FS06charOPTNONE

A user defined code (07Y/SS) that designates the status of the W-2c workfile build process for year-end.

cStatusYearEnd9999999FS07charOPTNONE

A user defined code (07Y/SS) that designates the status of year-end W-2  printing.

cStatusYearEnd99999999FS08charOPTNONE

A user defined code (07Y/SS) that designates the status of year-end W-2c printing.

cStatusYearEnd999999999FS09charOPTNONE

A user defined code (07Y/SS) that designates the status of year-end W-3  printing.

cStatusYearEnd9999999999FS10charOPTNONE

A user defined code (07Y/SS) that designates the status of year-end W-3c printing.

mnDateYrDTEYMATH_NUMERICREQINPUT

A two-digit number that specifies the applicable year. If you leave this field blank, the program uses the system date.

cBenefitStatementStatusST17charOPTNONE

The Print Status values are:    Blank The form has not been printed.    A        The form is currently printing and is considered active.    1       The 
form has been printed.

cPayrollSequenceCodeSEQCcharOPTNONE

A code which indicates the internal control which applies to this Payroll ID. Internal controls ensure proper sequencing of the payroll cycle. 
Valid codes are:    A Active    S Scheduling Lock. This version is already being accessed by another user. NOTE: You should change this code 
only under extreme circumstances.

mnTransmitterAddressAN8TMATH_NUMERICOPTNONE

The Address Book Number of the person, company, or service that created and sent the magnetic media tape to the respective 
governmental agency.

mnTapeReturnAddressAN8NMATH_NUMERICOPTNONE

The Address Book Number of the person or company to which the magnetic media tape should be returned if problems should occur.

mnAddresNbrInsuranceCoWAN8MATH_NUMERICOPTNONE

The address book number that identifies your 3rd party administrator.

mnContactPersonAddressAN8DMATH_NUMERICOPTNONE

Enter the Address Book Number for the person who should be contacted if there should be a problem with your W-2s, 499R-2s or 1099s.

cOptionFlag9FO01charOPTNONE

A code that designates whether you want the value in the Tax Area (residence) field to be used as the base state when printing year-end 
forms. If you do not use Tax Area (residence) as the base state, the value in the Home State field on the Payroll Revisions form will be used as 
the base state. If you choose not to use the value in Tax Area (residence) as the base state, and the Home State field is blank, the system 
uses the value in Tax Area (residence) as a default for the base state.

cOptionFlag99FO02charOPTNONE

A code that designates whether you want to process 1099s in the workfile build for year-end processing.

cOptionFlag999FO03charOPTNONE

cOptionFlag9999FO04charOPTNONE

A code that designates whether the system will print two localities per W-2  form. Employees with taxation history records for two or more 
localities will receive multiple W-2 forms if you do not print two localities per W-2.

cOptionFlag99999FO05charOPTNONE

mnNumberOfReportsRNUMMATH_NUMERICOPTNONE

The number of reports that still need to complete, as submitted from Report Only.

cBlockingFactorBFTRcharOPTNONE

A mandatory field that tells the system how many records to read when it is copying the magnetic media to tape. Due to legislative 
requirements, you must enter a value in this field. Valid values are:    C Blocking factor for cartridges    R Blocking factor for reels

jdDateUpdatedUPMJJDEDATEOPTNONE

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

mnTimeLastUpdatedUPMTMATH_NUMERICOPTNONE

The time that specifies when the program executed the last update to this record.

szProgramIdPIDcharOPTNONE

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.

szWorkStationIdJOBNcharOPTNONE

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

szUserIdUSERcharOPTNONE

The code that identifies a user profile.

cStatusYearEnd99999999999FS11charOPTNONE

A user defined code (07Y/SS) that designates the status of year-end 1099-MISC forms.

cStatusYearEnd12FS12charOPTNONE

A user defined code (07Y/SS) that designates the status of year-end 1099-R forms.

cStatusYearEnd13FS13charOPTNONE

A user defined code (07Y/SS) that designates the status of year-end 1096  forms.

cStatusYearEnd14FS14charOPTNONE

A user defined code (07Y/SS) that designates the status of a year-end step.

cStatusYearEnd15FS15charOPTNONE

A user defined code (07Y/SS) that designates the status of a year-end step.

Related Functions

None

Related Tables

None