TransferSuppData

Transfer Supp Data on Hire/Terminate Employee

Minor Business Rule

Object Name: N0800029

Parent DLL: CFND

Location: Client/Server

Language: NER

Functional Description

This NER is called when an employee is terminated or when an applicant is hired.  NER reads the F08094 (supp data x-reference file), calls N0000158
to do the transfer. N0000158 verifies that the TO and FROM structures are in F00091, then transfers the supplemental data from applicant to employee
supplemental database or vice versa in file F00092.

SetUp Notes

If the FROM or TO structures do not exist in F00091, and error message is returned and records that cause the error are not deleted.

Technical Specifications

Parameters

Data Item Data Structure DescriptionI/ORequiredNotes
AN8Address Number  IYAddress no. of supplemental data to be transferred
CSRFCross Reference Type  IYEither H for Hire, or T for Terminate
SUPPSSuppress Error Messages  IY0 to return when the first error is encountered; 1 to continue
until all data in F00092 are considered
DTAIError Message ID  OYError ID that caused the error; otherwise it will be blank
USERUser ID  INIf blank, it will be retrieved by N0000158 using Get Audit
Info
PIDProgram ID   INIf blank, N0000158 will assign "N000158"
SUPPSError Flag  OY1 if an error occurred while transferring supp. data, 0 if
not USER and PID are used with converted records in F00092

Related Tables

Table Table DescriptionAccessed by
F08094Profile Database, Cross ReferenceN0800029
F00090Supplemental Database SetupN0000158
F00091Supplemental Database Data TypesN0000158
F00092Supplemental DataN0000158

Processing

Determine direction of supplemental data transfer.
If mode = H(ire)
Set Source Database Code (TYDT) = A
Set Target Database Code (TYDT)  = E

If mode = T(erminate)
Set Source Database Code (TYDT) = E
Set Target Database Code (TYDT)  = A

Select and process all records in F00092 based on the list in F08094.
Records in F00092 are converted using the COPY function in N0000158.
Check Delete Flag (YNDL) from F08094 record,
If flag is 'Y' and no error occurred while copying, then call N0000158 to delete supplemental data.
End.

Data Structure

DN0800029 - Transfer Supp Data on Hire/Terminate

Parameter Name Data Item Data Type Req/Opt I/O/Both

cCrossReferenceType CSRF char REQ INPUT

The type of cross-reference table to be used for transferring profile data between the employee and applicant supplemental
databases. Valid codes are:    H When you hire an applicant, transfer applicant profile data to the employee supplemental database.    T When you
terminate an employee, transfer employee profile data to the applicant supplemental database.

mnAddressNumber AN8 MATH_NUMERIC REQ INPUT

A number that identifies an entry in the Address Book system, such as employee, applicant, participant, customer, supplier, tenant, or
location.

cSuppressErrorMessages SUPPS char REQ INPUT

A flag indicating whether or not runtime error messaging will occur when an error message is issued from a business function.        0 = allow
runtime error message handling.        1 = suppress runtime error message handling.

szErroMessageID DTAI char REQ OUTPUT

A code that identifies and defines a unit of information. It is an alphanumeric code up to 8 characters long that does not allow blanks or
special characters such as %, &, or +. You create new data items using system codes 55-59. You cannot change the alias.

szUserId USER char OPT INPUT

The code that identifies a user profile.

szProgramId PID char OPT INPUT

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.

cErrorFlag SUPPS char REQ OUTPUT

A flag indicating whether or not runtime error messaging will occur when an error message is issued from a business function.        0 = allow
runtime error message handling.        1 = suppress runtime error message handling.

Related Functions

None

Related Tables

None

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
cCrossReferenceType	CSRF	char	REQ	INPUT
The type of cross-reference table to be used for transferring profile data between the employee and applicant supplemental databases. Valid codes are: H When you hire an applicant, transfer applicant profile data to the employee supplemental database. T When you terminate an employee, transfer employee profile data to the applicant supplemental database.
mnAddressNumber	AN8	MATH_NUMERIC	REQ	INPUT
A number that identifies an entry in the Address Book system, such as employee, applicant, participant, customer, supplier, tenant, or location.
cSuppressErrorMessages	SUPPS	char	REQ	INPUT
A flag indicating whether or not runtime error messaging will occur when an error message is issued from a business function. 0 = allow runtime error message handling. 1 = suppress runtime error message handling.
szErroMessageID	DTAI	char	REQ	OUTPUT
A code that identifies and defines a unit of information. It is an alphanumeric code up to 8 characters long that does not allow blanks or special characters such as %, &, or +. You create new data items using system codes 55-59. You cannot change the alias.
szUserId	USER	char	OPT	INPUT
The code that identifies a user profile.
szProgramId	PID	char	OPT	INPUT
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.
cErrorFlag	SUPPS	char	REQ	OUTPUT
A flag indicating whether or not runtime error messaging will occur when an error message is issued from a business function. 0 = allow runtime error message handling. 1 = suppress runtime error message handling.