LaunchGenericYearEndPrograms

Launch Generic Year-End Programs

Minor Business Rule

Object Name: B0700780

Parent DLL: CHRM

Location: Client/Server

Language: C

Data Structure

D0700780 - DS for Luanch Generic Year-End Programs

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.

mnDateYrDTEYMATH_NUMERICREQINPUT

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

szProgramIdPIDcharREQINPUT

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.

szVersionVERScharREQINPUT

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.

cProcessTypePTYEcharOPTINPUT

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

cVersionTypeVTYEcharOPTINPUT

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

cTaxIdSummationTIScharOPTINPUT

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.

cAllocateFederalWageW2AWcharOPTINPUT

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.

cPrint2StatesW22ScharOPTINPUT

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.

cPrint2LocalitiesFO04charOPTINPUT

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.

cResStateEqBaseStFO01charOPTINPUT

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.

mnFicaAnnualLimitSSDLMATH_NUMERICOPTINPUT

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.

mn3rdPartyAdminWAN8MATH_NUMERICOPTINPUT

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

cW2NameFormatW2NFcharOPTINPUT

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.

szNewJerseyPOSVLcharOPTINPUT

The data selection value.  A special facility has been provided to allow selection of multiple specific values.  By entering '*VALUES' in the 
selection field, a special display screen will be displayed allowing the entry of up to 45 specific values.  If you specify '*VALUES' in multiple 
selections of the original display, you will be prompted for multiple values lists. Enter the value '*BLANKS' if you are searching on a blank 
value.  You cannot leave the values field blank to search on blanks, it will default to '*ALL'. Enter the value '*ZEROS' when searching for amounts 
equal to zero. The '*RANGE' keyword will display a special display screen which will allow the entry of a range of values (i.e., from 1 to 50).  
The first value MUST be LESS than the second value. If it is equal or greater than, it will not work. If you want to select all values for a field, enter 
'*ALL'.

mnTimeLastUpdatedUPMTMATH_NUMERICREQINPUT

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

jdDateUpdatedUPMJJDEDATEREQINPUT

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

szWorkStationIdJOBNcharREQINPUT

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

szUserIdUSERcharREQINPUT

The code that identifies a user profile.

cReturnCodeEV01charOPTOUTPUT

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

Related Functions

None

Related Tables

F983051 Versions List