EmployeeHireAddressBookEdit

Process Other Tables For Employee Hire

Minor Business Rule

Object Name: N0500710

Parent DLL: CHRM

Location: Client/Server

Language: NER

Function Name:  Employee Hire Address Book Edit

Purpose:


This function edits address book information for new employees.


Data Structure:


Data Item Data Structure DescriptionI/ORequiredNotes

AN8mnAddressNumberIY

EV01cABRecordExsistsFlagIN1 - This address number is already in the F01010 table 

0 - This is a new address number

EV01cSuppressErrorFlagIN

DATIszErrorMessageIdON

PIDszProgramIdIN

VERSszVersionIN

AT1szSearchTypeIN

TAXszTaxIdIN

ALPHszNameAlphaIN

MLNMszNameMailingIN

MCUszCostCenterIN

ADD1szAddressLine1IN

ADD2szAddressLine2IN

ADD3szAddressLine3IN

ADD4szAddressLine4IN

CTY1szCityIN

ADDSszStateIN

ADDZszZipCodePostalIN

COUNszCountyAddressIN

CTRszCountryIN

AR1szPhoneAreaCode1IN

PH1szPhoneNumber1IN

AR3szPhoneAreaCode2IN

PH3szPhoneNumber2IN

MLNMszContactNameMailingIN

AR4szContactPhoneAreaCodeIN

PH4szContactPhoneNumberIN

REM1szEmailIN

CCPRszCountryForPayrollIN

AC01szReportCodeAddBook001IN

AC02szReportCodeAddBook002IN

AC03szReportCodeAddBook003IN

AC04szReportCodeAddBook004IN

AC05szReportCodeAddBook005IN

AC06szReportCodeAddBook006IN

AC07szReportCodeAddBook007IN

AC08szReportCodeAddBook008IN

AC09szReportCodeAddBook009IN

AC10szReportCodeAddBook010IN

AC11szReportCodeAddBook011IN

AC12szReportCodeAddBook012IN

AC13szReportCodeAddBook013IN

AC14szReportCodeAddBook014IN

AC15szReportCodeAddBook015IN

AC16szReportCodeAddBook016IN

AC17szReportCodeAddBook017IN

AC18szReportCodeAddBook018IN

AC19szReportCodeAddBook019IN

AC20szReportCodeAddBook020IN

AC21szCategoryCodeAddressBk21IN

AC22szCategoryCodeAddressBk22IN

AC23szCategoryCodeAddressBk23IN

AC24szCategoryCodeAddressBk24IN

AC25szCategoryCodeAddressBk25IN

AC26szCategoryCodeAddressBk26IN

AC27szCategoryCodeAddressBk27IN

AC28szCategoryCodeAddressBk28IN

AC29szCategoryCodeAddressBk29IN

AC30szCategoryCodeAddressBk30IN

CCPRszPODefaultCountryForPayrollIN

TYCcPOEmergencyContactTypeIN

PHTPszPOHomePhoneNumberTypeIN

PHTPszPOWorkPhoneNumberTypeIN


Related Tables :


Table Table Description

F0101Address Book

F0111Whos Who

F0115Phones

F0116Date Effective Addresses


Related Business Functions:


Source NameFunction Name

N0100041Address Book MBF


Processing:


=======================================================================

NAMED ER: Employee Hire Address Book Edit

=======================================================================

If BF cABRecordExsistsFlag is equal to  Or BF cABRecordExsistsFlag is equal to 

   // Find Out if New or Exsisting Record

   V0101M.Select

      BF mnAddressNumber =  TK Address Number

   If SV File_IO_Status is equal to CO SUCCESS

      BF cABRecordExsistsFlag = "1"

   Else

      BF cABRecordExsistsFlag = "0"

   End If

End If

If BF szCountryForPayroll is equal to  Or BF szCountryForPayroll is equal to 

   BF szCountryForPayroll = BF szPODefaultCountryForPayroll

End If

If BF cABRecordExsistsFlag is equal to "1" And BF mnAddressNumber is not equal to  And BF 

mnAddressNumber is not equal to  And BF mnAddressNumber is not equal to 

   // Perform Edit Only of Address Book Fields

   Address Book - MBF

      "C" -> cActionCode

      UNDEFINED X cUpdateMasterFile

      UNDEFINED X cProcessEdits

      BF cSuppressErrorFlag -> cSuppressErrorMessages

      BF szErrorMessageId <- szErrorMessageID

      UNDEFINED X szVersion

      UNDEFINED X mnSameAsExcept

      BF mnAddressNumber -> mnAddressBookNumber

      UNDEFINED X szLongAddressNumber

      BF szTaxId -> szTaxId

      BF szSearchType -> szSearchType

      BF szNameAlpha -> szAlphaName

      UNDEFINED X szSecondaryAlphaName

      BF szNameMailing -> szMailingName

      UNDEFINED X szSecondaryMailingName

      UNDEFINED X szDescriptionCompressed

      BF szCostCenter -> szBusinessUnit

      BF szAddressLine1 -> szAddressLine1

      BF szAddressLine2 -> szAddressLine2

      BF szAddressLine3 -> szAddressLine3

      BF szAddressLine4 -> szAddressLine4

      BF szZipCodePostal -> szPostalCode

      BF szCity -> szCity

      BF szCountyAddress -> szCounty

      BF szState -> szState

      BF szCountry -> szCountry

      UNDEFINED X szCarrierRoute

      UNDEFINED X szBulkMailingCenter

      BF szPhoneAreaCode1 -> szPrefix1

      BF szPhoneNumber1 -> szPhoneNumber1

      BF szPOWorkPhoneNumberType -> szPhoneNumberType1

      BF szPhoneAreaCode2 -> szPhoneAreaCode2

      BF szPhoneNumber2 -> szPhoneNumber2

      BF szPOHomePhoneNumberType -> szPhoneNumberType2

      UNDEFINED X cPayablesYNM

      UNDEFINED X cReceivablesYN

      UNDEFINED X cEmployeeYN

      UNDEFINED X cUserCode

      UNDEFINED X cARAPNettingY

      UNDEFINED X cSubledgerInactiveCode

      UNDEFINED X cPersonCorporationCode

      UNDEFINED X szCertificate

      UNDEFINED X szAddlIndTaxID

      UNDEFINED X szCreditMessage

      UNDEFINED X szLanguage

      UNDEFINED X szIndustryClassification

      UNDEFINED X cEMail

      UNDEFINED X mn1stAddressNumber

      UNDEFINED X mn2ndAddressNumber

      UNDEFINED X mn3rdAddressNumber

      UNDEFINED X mn4thAddressNumber

      UNDEFINED X mn5thAddressNumber

      UNDEFINED X mnFactorSpecialPayee

      UNDEFINED X mnParentNumber

      UNDEFINED X cAddressType3YN

      UNDEFINED X cAddressType4YN

      UNDEFINED X cAddressType5YN

      BF szReportCodeAddBook001 -> szCategoryCode01

      BF szReportCodeAddBook002 -> szAccountRepresentative

      BF szReportCodeAddBook003 -> szCategoryCode03

      BF szReportCodeAddBook004 -> szGeographicRegion

      BF szReportCodeAddBook005 -> szCategoryCode05

      BF szReportCodeAddBook006 -> szCategoryCode06

      BF szReportCodeAddBook007 -> sz1099Reporting

      BF szReportCodeAddBook008 -> szCategoryCode08

      BF szReportCodeAddBook009 -> szCategoryCode09

      BF szReportCodeAddBook010 -> szCategoryCode10

      BF szReportCodeAddBook011 -> szSalesRegion

      BF szReportCodeAddBook012 -> szCategoryCode12

      BF szReportCodeAddBook013 -> szLineOfBusiness

      BF szReportCodeAddBook014 -> szSalesVolume

      BF szReportCodeAddBook015 -> szCategoryCode15

      BF szReportCodeAddBook016 -> szCategoryCode16

      BF szReportCodeAddBook017 -> szCategoryCode17

      BF szReportCodeAddBook018 -> szCategoryCode18

      BF szReportCodeAddBook019 -> szCategoryCode19

      BF szReportCodeAddBook020 -> szCategoryCode20

      BF szCategoryCodeAddressBk21 -> szCategoryCode21

      BF szCategoryCodeAddressBk22 -> szCategoryCode22

      BF szCategoryCodeAddressBk23 -> szCategoryCode23

      BF szCategoryCodeAddressBk24 -> szCategoryCode24

      BF szCategoryCodeAddressBk25 -> szCategoryCode25

      BF szCategoryCodeAddressBk26 -> szCategoryCode26

      BF szCategoryCodeAddressBk27 -> szCategoryCode27

      BF szCategoryCodeAddressBk28 -> szCategoryCode28

      BF szCategoryCodeAddressBk29 -> szCategoryCode29

      BF szCategoryCodeAddressBk30 -> szCategoryCode30

      UNDEFINED X szGlBankAccount

      UNDEFINED X mnTimeScheduledIn

      UNDEFINED X jdDateScheduledIn

      UNDEFINED X cClearedY

      UNDEFINED X szRemark

      UNDEFINED X szUserReservedCode

      UNDEFINED X jdUserReservedDate

      UNDEFINED X mnUserReservedAmount

      UNDEFINED X mnUserReservedNumber

      UNDEFINED X szUserReservedReference

      UNDEFINED X jdDateEffective

      BF szProgramId -> szProgramId

      BF szEmail -> szRemark1

      UNDEFINED X mnAddNumParentOriginal

      UNDEFINED X OKToDelete

      UNDEFINED X szVersionconsolidated

      UNDEFINED X cDirectionIndicator

      UNDEFINED X cEdiSuccessfullyProcess

      BF szCountryForPayroll -> szCountryForPayroll

      UNDEFINED X szShortcutClientType

   If SV Error_Status is not equal to CO SUCCESS

      If BF szErrorMessageId is equal to  Or BF szErrorMessageId is equal to 

         BF szErrorMessageId = "2737"

      End If

   End If

Else

   If BF mnAddressNumber is not equal to  And BF mnAddressNumber is not equal to  And BF 

mnAddressNumber is not equal to 

      Address Book - MBF

         "A" -> cActionCode

         UNDEFINED X cUpdateMasterFile

         UNDEFINED X cProcessEdits

         BF cSuppressErrorFlag -> cSuppressErrorMessages

         BF szErrorMessageId <- szErrorMessageID

         UNDEFINED X szVersion

         UNDEFINED X mnSameAsExcept

         BF mnAddressNumber -> mnAddressBookNumber

         UNDEFINED X szLongAddressNumber

         BF szTaxId -> szTaxId

         BF szSearchType -> szSearchType

         BF szNameAlpha -> szAlphaName

         UNDEFINED X szSecondaryAlphaName

         BF szNameMailing -> szMailingName

         UNDEFINED X szSecondaryMailingName

         UNDEFINED X szDescriptionCompressed

         BF szCostCenter -> szBusinessUnit

         BF szAddressLine1 -> szAddressLine1

         BF szAddressLine2 -> szAddressLine2

         BF szAddressLine3 -> szAddressLine3

         BF szAddressLine4 -> szAddressLine4

         BF szZipCodePostal -> szPostalCode

         BF szCity -> szCity

         BF szCountyAddress -> szCounty

         BF szState -> szState

         BF szCountry -> szCountry

         UNDEFINED X szCarrierRoute

         UNDEFINED X szBulkMailingCenter

         BF szPhoneAreaCode1 -> szPrefix1

         BF szPhoneNumber1 -> szPhoneNumber1

         BF szPOWorkPhoneNumberType -> szPhoneNumberType1

         BF szPhoneAreaCode2 -> szPhoneAreaCode2

         BF szPhoneNumber2 -> szPhoneNumber2

         BF szPOHomePhoneNumberType -> szPhoneNumberType2

         UNDEFINED X cPayablesYNM

         UNDEFINED X cReceivablesYN

         UNDEFINED X cEmployeeYN

         UNDEFINED X cUserCode

         UNDEFINED X cARAPNettingY

         UNDEFINED X cSubledgerInactiveCode

         UNDEFINED X cPersonCorporationCode

         UNDEFINED X szCertificate

         UNDEFINED X szAddlIndTaxID

         UNDEFINED X szCreditMessage

         UNDEFINED X szLanguage

         UNDEFINED X szIndustryClassification

         UNDEFINED X cEMail

         UNDEFINED X mn1stAddressNumber

         UNDEFINED X mn2ndAddressNumber

         UNDEFINED X mn3rdAddressNumber

         UNDEFINED X mn4thAddressNumber

         UNDEFINED X mn5thAddressNumber

         UNDEFINED X mnFactorSpecialPayee

         UNDEFINED X mnParentNumber

         UNDEFINED X cAddressType3YN

         UNDEFINED X cAddressType4YN

         UNDEFINED X cAddressType5YN

         BF szReportCodeAddBook001 -> szCategoryCode01

         BF szReportCodeAddBook002 -> szAccountRepresentative

         BF szReportCodeAddBook003 -> szCategoryCode03

         BF szReportCodeAddBook004 -> szGeographicRegion

         BF szReportCodeAddBook005 -> szCategoryCode05

         BF szReportCodeAddBook006 -> szCategoryCode06

         BF szReportCodeAddBook007 -> sz1099Reporting

         BF szReportCodeAddBook008 -> szCategoryCode08

         BF szReportCodeAddBook009 -> szCategoryCode09

         BF szReportCodeAddBook010 -> szCategoryCode10

         BF szReportCodeAddBook011 -> szSalesRegion

         BF szReportCodeAddBook012 -> szCategoryCode12

         BF szReportCodeAddBook013 -> szLineOfBusiness

         BF szReportCodeAddBook014 -> szSalesVolume

         BF szReportCodeAddBook015 -> szCategoryCode15

         BF szReportCodeAddBook016 -> szCategoryCode16

         BF szReportCodeAddBook017 -> szCategoryCode17

         BF szReportCodeAddBook018 -> szCategoryCode18

         BF szReportCodeAddBook019 -> szCategoryCode19

         BF szReportCodeAddBook020 -> szCategoryCode20

         BF szCategoryCodeAddressBk21 -> szCategoryCode21

         BF szCategoryCodeAddressBk22 -> szCategoryCode22

 

Data Structure

D0500710A - Employee Hire Address Book Edit

Parameter NameData ItemData TypeReq/OptI/O/Both
mnAddressNumberAN8MATH_NUMERICREQINPUT

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

cABRecordExsistsFlagEV01charOPTINPUT

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

cSuppressErrorFlagEV01charOPTINPUT

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

szErrorMessageIdDTAIcharOPTOUTPUT

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.

szProgramIdPIDcharOPTINPUT

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.

szVersionVERScharOPTINPUT

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.

szSearchTypeAT1charOPTNONE

A user defined code (01/ST) that specifies the kind of address book record to search for. Examples include: E Employees   X Ex-employees  
V Suppliers   C Customers  P    Prospects M Mail distribution lists   TAX Tax authorities

szTaxIdTAXcharOPTNONE

The identification code required by various tax authorities. This can be a social security number, federal or state corporate tax ID, sales tax 
number, and so on. The system verifies the number and prints the separators in their correct format, according to the value of TAXC 
(Person/Corporation Code). If no value exists for TAXC, the system uses the Corporate Entity. Attention Accounts Payable users: The Supplier Master 
record supplies the default value for the tax ID for 1099 processing.

szNameAlphaALPHcharOPTNONE

The text that names or describes an address. This 40-character alphabetic field appears on a number of forms and reports. You can enter 
dashes, commas, and other special characters, but the system cannot search on them when you use this field to search for a name.

szNameMailingMLNMcharOPTNONE

The company or person to whom billing or correspondence is addressed.

szCostCenterMCUcharOPTNONE

An alphanumeric code that identifies a separate entity within a business for which you want to track costs. For example, a business unit 
might be a warehouse location, job, project, work center, branch, or plant. You can assign a business unit to a document, entity, or person for 
purposes of responsibility reporting. For example, the system provides reports of open accounts payable and accounts receivable by 
business unit to track equipment by responsible department. Business unit security might prevent you from viewing information about business units 
for which you have no authority.

szAddressLine1ADD1charOPTNONE

The first line of a mailing address for an employee, customer, or supplier in the Address Book system. The U.S. Internal Revenue Service 
(IRS) restricts the size of the address that prints on an employee's year-end tax return. To comply with IRS regulations, the system has the 
following restrictions:   o  On W-2 returns, the system prints only the last three nonblank address lines plus the city, state, and postal code.   o  On 
1099 returns, the system prints only the last nonblank address line plus the city, state, and postal code.   o  On other U.S. federal magnetic 
media, the system prints only the last nonblank address line plus the city, state, and postal code.

szAddressLine2ADD2charOPTNONE

The second line of the mailing address for an employee, customer, or supplier in the Address Book system. Attention Payroll users: The 
Internal Revenue Service (IRS) restricts the size of the address that prints on employee's year-end forms. To comply with IRS regulations, the 
address that prints on W-2 forms includes only the last three nonblank address lines plus the city, state, and postal code. The address that 
prints on 1099 forms includes only the last nonblank address line plus the city, state, and postal code. If you process year-end information using 
the federal magnetic media format, the address that prints on those forms contains only the last nonblank address line plus the city, state, 
and postal code.

szAddressLine3ADD3charOPTNONE

The third line of the mailing address for an employee, customer, or supplier in the Address Book system. Attention Payroll users: The 
Internal Revenue Service (IRS) restricts the size of the address that prints on employee's year-end forms. To comply with IRS regulations, the 
address that prints on W-2 forms includes only the last three nonblank address lines plus the city, state, and postal code. The address that prints 
on 1099 forms includes only the last nonblank address line plus the city, state, and postal code. If you process year-end information using 
the federal magnetic media format, the address that prints on those forms contains only the last nonblank address line plus the city, state, and 
postal code.

szAddressLine4ADD4charOPTNONE

The fourth line of the mailing address for an employee, customer, or supplier in the Address Book system. Attention Payroll users: The 
Internal Revenue Service (IRS) restricts the size of the address that prints on employee's year-end forms. To comply with IRS regulations, the 
address that prints on W-2 forms includes only the last three nonblank address lines plus the city, state, and postal code. The address that 
prints on 1099 forms includes only the last nonblank address line plus the city, state, and postal code. If you process year-end information using 
the federal magnetic media format, the address that prints on those forms contains only the last nonblank address line plus the city, state, and 
postal code.

szCityCTY1charOPTNONE

A name that indicates the city associated with the address.

szStateADDScharOPTNONE

A user defined code (00/S) that specifies the state or province. This code is usually a postal service abbreviation.

szZipCodePostalADDZcharOPTNONE

The United States ZIP code or the postal code that specifies where a letter is to be routed.  Attach this code to the address for delivery in 
other countries. This code is used as the low end value when doing Postal Code Transaction range processing.

szCountyAddressCOUNcharOPTNONE

The name of a county, parish, or other political district that is necessary for the address or for tax purposes.

szCountryCTRcharOPTNONE

A user defined code (00/CN) that identifies a country. The country code has no effect on currency conversion. The Address Book system 
uses the country code for data selection and address formatting.

szPhoneAreaCode1AR1charOPTNONE

The first segment of a telephone number. In the United States, the prefix is the three-digit area code.

szPhoneNumber1PH1charOPTNONE

A number without the prefix or special characters, such as hyphens or periods, that makes up the telephone number for an entity. You can 
use any applicable telephone number format for a country. This field is used in conjunction with the Prefix field (AR1), where you enter the first 
segment of the telephone number, which is called the area code in the United States. When you search for an address using a phone 
number, you must enter the number exactly as it is set up in the Address Book system, including any special characters.

szPhoneAreaCode2AR3charOPTNONE

The prefix for telephone number 3. The default format for the Phone Prefix data dictionary item is set to the United States prefix (area code). 
This format is three characters enclosed in parentheses. For example, (303). If you require an alternate format to accommodate a non-United 
States prefix, you must change the data display rules in the data dictionary.

szPhoneNumber2PH3charOPTNONE

The telephone number has been established in free form to allow incorporation of extension numbers and local telephone oddities. For 
example, Laramie, Wyoming could be expressed as 21-5223; and Singapore could be expressed as 011-65-469-8382. If all phone numbers 
are to follow a consistent format, you may specify an edit code in the data dictionary for the phone number (e.g., ___-____).  Note: In using the 
phone search capability of the Address Book, you must spell the search in the same manner that you recorded the phone numbers.

szContactNameMailingMLNMcharOPTNONE

The company or person to whom billing or correspondence is addressed.

szContactPhoneAreaCodeAR4charOPTNONE

The prefix for telephone number 4. The default format for the Phone Prefix data dictionary item is set to the United States prefix (area code). 
This format is three characters enclosed in parentheses. For example, (303). If you require an alternate format to accommodate a non-United 
States prefix, you must change the data display rules in the data dictionary.

szContactPhoneNumberPH4charOPTNONE

The telephone number has been established in free form to allow incorporation of extension numbers and local telephone oddities. For 
example, Laramie, Wyoming could be expressed as 21-5223; and Singapore could be expressed as 011-65-469-8382. If all phone numbers 
are to follow a consistent format, you may specify an edit code in the data dictionary for the phone number (e.g., ___-____).   Note: In using the 
phone search capability of the Address Book,you must spell the search in the same manner that you recorded the phone numbers.

szEmailREM1charOPTNONE

A 40-character field that you can use to enter text.

szCountryForPayrollCCPRcharOPTNONE

A user defined code list 00/CN that indicates the country in which the employee resides.

szReportCodeAddBook001AC01charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to group address book 
records for reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples of category codes 
include: Category code 01   Location or Branch Category code 02 Salesperson Category code 03   Product Category code 04   Credit officer

szReportCodeAddBook002AC02charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user-defined (system 01, types 01 through 30). Examples: Category code 01 - Location or 
Branch  Category code 02 - Account Representative  Category code 03 - New tenant  Category code 04 - Credit officer

szReportCodeAddBook003AC03charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user-defined (system 01, types 01 through 30). Examples: Category code 01 - Location or 
Branch  Category code 02 - Salesperson  Category code 03 - New tenant  Category code 04 - Credit officer

szReportCodeAddBook004AC04charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user-defined (system 01, types 01 through 30). Examples: Category code 01 - Location or 
Branch  Category code 02 - Salesperson  Category code 03 - New tenant  Category code 04 - Credit officer

szReportCodeAddBook005AC05charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user-defined (system 01, types 01 through 30). Examples: Category code 01               Location 
or Branch Category code 02               Salesperson Category code 03               New tenant Category code 04               Credit officer

szReportCodeAddBook006AC06charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user-defined (system 01, types 01 through 30). Examples: Category code 01               Location 
or Branch Category code 02               Salesperson Category code 03               New tenant Category code 04               Credit officer

szReportCodeAddBook007AC07charOPTNONE

One of 30 reporting codes that you can assign to an address in the Address Book system. Category Code 07 is used in the 1099 process to 
identify the box on the 1099 form in which a voucher or pay item should be reported. Examples include: 01 Rents 13 Nontaxable 
distributions 61  Interest income A7  Nonemployee compensation

szReportCodeAddBook008AC08charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook009AC09charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook010AC10charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook011AC11charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook012AC12charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook013AC13charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook014AC14charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook015AC15charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook016AC16charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user-defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook017AC17charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user-defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook018AC18charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user-defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook019AC19charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user-defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook020AC20charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk21AC21charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk22AC22charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk23AC23charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk24AC24charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk25AC25charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk26AC26charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk27AC27charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk28AC28charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk29AC29charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk30AC30charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szPODefaultCountryForPayrollCCPRcharOPTNONE

A user defined code list 00/CN that indicates the country in which the employee resides.

cPOEmergencyContactTypeTYCcharOPTNONE

A user defined code (01/W0) that identifies the Who's Who entry. Examples include: A Attention name B Billing C Contact name E Emergency 
Contact O Other T 1099 legal name 

szPOHomePhoneNumberTypePHTPcharOPTNONE

A user defined code (01/PH) that indicates either the location or use of a telephone number. Valid values include: Blank Business telephone 
number FAX Fax telephone number HOM Home telephone number

szPOWorkPhoneNumberTypePHTPcharOPTNONE

A user defined code (01/PH) that indicates either the location or use of a telephone number. Valid values include: Blank Business telephone 
number FAX Fax telephone number HOM Home telephone number

Related Functions

None

Related Tables

None
EmployeeHireAddressBookUpdate

EmployeeHireAddressBookUpdate

Process Other Tables For Employee Hire

Minor Business Rule

Object Name: N0500710

Parent DLL: CHRM

Location: Client/Server

Language: NER

Function Name:  Employee Hire Address Book Update

Purpose:


This function updates the address book tables for new employees.


Data Structure:


Data Item Data Structure DescriptionI/ORequiredNotes

AN8mnAddressNumberIY

EV01cABRecordExsistsFlagIN1 - This address number is already in the F01010 table 

0 - This is a new address number

EV01cSuppressErrorFlagIN

DATIszErrorMessageIdON

PIDszProgramIdIN

VERSszVersionIN

JOBNszWorkStationIdIN

UPMJjdDateUpdatedIN

UPMTmnTimeLastUpdatedIN

AT1szSearchTypeIN

TAXszTaxIdIN

ALPHszNameAlphaIN

MLNMszNameMailingIN

MCUszCostCenterIN

ADD1szAddressLine1IN

ADD2szAddressLine2IN

ADD3szAddressLine3IN

ADD4szAddressLine4IN

CTY1szCityIN

ADDSszStateIN

ADDZszZipCodePostalIN

COUNszCountyAddressIN

CTRszCountryIN

AR1szPhoneAreaCode1IN

PH1szPhoneNumber1IN

AR3szPhoneAreaCode2IN

PH3szPhoneNumber2IN

MLNMszContactNameMailingIN

AR4szContactPhoneAreaCodeIN

PH4szContactPhoneNumberIN

REM1szEmailIN

CCPRszCountryForPayrollIN

AC01szReportCodeAddBook001IN

AC02szReportCodeAddBook002IN

AC03szReportCodeAddBook003IN

AC04szReportCodeAddBook004IN

AC05szReportCodeAddBook005IN

AC06szReportCodeAddBook006IN

AC07szReportCodeAddBook007IN

AC08szReportCodeAddBook008IN

AC09szReportCodeAddBook009IN

AC10szReportCodeAddBook010IN

AC11szReportCodeAddBook011IN

AC12szReportCodeAddBook012IN

AC13szReportCodeAddBook013IN

AC14szReportCodeAddBook014IN

AC15szReportCodeAddBook015IN

AC16szReportCodeAddBook016IN

AC17szReportCodeAddBook017IN

AC18szReportCodeAddBook018IN

AC19szReportCodeAddBook019IN

AC20szReportCodeAddBook020IN

AC21szCategoryCodeAddressBk21IN

AC22szCategoryCodeAddressBk22IN

AC23szCategoryCodeAddressBk23IN

AC24szCategoryCodeAddressBk24IN

AC25szCategoryCodeAddressBk25IN

AC26szCategoryCodeAddressBk26IN

AC27szCategoryCodeAddressBk27IN

AC28szCategoryCodeAddressBk28IN

AC29szCategoryCodeAddressBk29IN

AC30szCategoryCodeAddressBk30IN

CCPRszPODefaultCountryForPayrollIN

TYCcPOEmergencyContactTypeIN

PHTPszPOHomePhoneNumberTypeIN

PHTPszPOWorkPhoneNumberTypeIN


Related Tables :


Table Table Description

F0101Address Book

F0111Whos Who

F0115Phones

F0116Date Effective Addresses


Related Business Functions:


Source NameFunction Name

N0100041Address Book MBF


Processing:


=======================================================================

NAMED ER: Employee Hire Address Book Update

=======================================================================

evt_szLongAddressNumber_ALKY

evt_szSecondaryAlpha_ALP1

evt_szSecondaryMailingName_MLN

evt_szDescripCompressed_DC

evt_szCarrierRoute_CRTE

evt_szBulkMailingCenter_MKML

evt_AddressTypePayables_ATP

evt_AddressTypeReceivables_ATR

evt_AddressTypeEmployee_ATE

evt_cUserCode_ATPR

evt_cARAPNettingY_AT2

evt_SubledgerInactiveCode_SBLI

evt_PersonCorporationCode_TAXC

evt_CertificateTaxExempt_TXCT

evt_szAddllndTaxID_TX2

evt_CreditMessage_CM

evt_LanguagePreference_LNGP

evt_szIndustryClassificati_SIC

evt_cEmail_AB3

evt_mnAddressNumber1st_AN81

evt_mnAddressNumber2nd_AN82

evt_mnAddressNumber3rd_AN83

evt_mnAddressNumber4th_AN84

evt_mnFactorSpecialPayee_AN85

evt_mnAddressNumberParent_PA8

evt_AddressType3_AT3

evt_AddressType4_AT4

evt_AddressType5_AT5

evt_GlBankAccount_GLBA

evt_TimeScheduledIn_PTI

evt_DateScheduledIn_PDI

evt_ActionMessageControl_MSGA

evt_szNameRemark_RMK

evt_UserReservedCode_URCD

evt_UserReservedDate_URDT

evt_UserReservedAmount_URAT

evt_UserReservedNumber_URAB

evt_UserReservedReference_URRF

evt_mnAddressNumber5th_AN86

evt_mnContactLineNumberID_IDLN

evt_mnSequenceNumber_RCK7

evt_szNameAlpha_ALPH

If BF szSearchType is not equal to "N"

   BF szSearchType = "E"

End If

If BF cABRecordExsistsFlag is equal to  And BF mnAddressNumber is not equal to  And BF 

mnAddressNumber is not equal to  Or BF cABRecordExsistsFlag is equal to  And BF 

mnAddressNumber is not equal to  And BF mnAddressNumber is not equal to 

   // Check if record exsits

   V0101F.Fetch Single

      BF mnAddressNumber =  TK Address Number

      VA evt_szNameAlpha_ALPH <- TK Name - Alpha

   If SV File_IO_Status is equal to CO SUCCESS

      BF cABRecordExsistsFlag = "1"

   Else

      BF cABRecordExsistsFlag = "0"

   End If

End If

// if it exsists then inquire on  fields that we do not want to update to save

// values before updating those values we have

If BF cABRecordExsistsFlag is equal to "1"

   Address Book - MBF

      "I" -> cActionCode

      UNDEFINED X cUpdateMasterFile

      UNDEFINED X cProcessEdits

      BF cSuppressErrorFlag -> cSuppressErrorMessages

      UNDEFINED X szErrorMessageID

      UNDEFINED X szVersion

      UNDEFINED X mnSameAsExcept

      BF mnAddressNumber <> mnAddressBookNumber

      VA evt_szLongAddressNumber_ALKY <- szLongAddressNumber

      UNDEFINED X szTaxId

      UNDEFINED X szSearchType

      UNDEFINED X szAlphaName

      VA evt_szSecondaryAlpha_ALP1 <- szSecondaryAlphaName

      UNDEFINED X szMailingName

      VA evt_szSecondaryMailingName_MLN <- szSecondaryMailingName

      VA evt_szDescripCompressed_DC <- szDescriptionCompressed

      UNDEFINED X szBusinessUnit

      UNDEFINED X szAddressLine1

      UNDEFINED X szAddressLine2

      UNDEFINED X szAddressLine3

      UNDEFINED X szAddressLine4

      UNDEFINED X szPostalCode

      UNDEFINED X szCity

      UNDEFINED X szCounty

      UNDEFINED X szState

      UNDEFINED X szCountry

      VA evt_szCarrierRoute_CRTE <- szCarrierRoute

      VA evt_szBulkMailingCenter_MKML <- szBulkMailingCenter

      UNDEFINED X szPrefix1

      UNDEFINED X szPhoneNumber1

      UNDEFINED X szPhoneNumberType1

      UNDEFINED X szPhoneAreaCode2

      UNDEFINED X szPhoneNumber2

      UNDEFINED X szPhoneNumberType2

      VA evt_AddressTypePayables_ATP <- cPayablesYNM

      VA evt_AddressTypeReceivables_ATR <- cReceivablesYN

      VA evt_AddressTypeEmployee_ATE <- cEmployeeYN

      VA evt_cUserCode_ATPR <- cUserCode

      VA evt_cARAPNettingY_AT2 <- cARAPNettingY

      VA evt_SubledgerInactiveCode_SBLI <- cSubledgerInactiveCode

      VA evt_PersonCorporationCode_TAXC <- cPersonCorporationCode

      VA evt_CertificateTaxExempt_TXCT <- szCertificate

      VA evt_szAddllndTaxID_TX2 <- szAddlIndTaxID

      VA evt_CreditMessage_CM <- szCreditMessage

      VA evt_LanguagePreference_LNGP <- szLanguage

      VA evt_szIndustryClassificati_SIC <- szIndustryClassification

      VA evt_cEmail_AB3 <- cEMail

      VA evt_mnAddressNumber1st_AN81 <- mn1stAddressNumber

      VA evt_mnAddressNumber2nd_AN82 <- mn2ndAddressNumber

      VA evt_mnAddressNumber3rd_AN83 <- mn3rdAddressNumber

      VA evt_mnAddressNumber4th_AN84 <- mn4thAddressNumber

      VA evt_mnAddressNumber5th_AN86 <- mn5thAddressNumber

      VA evt_mnFactorSpecialPayee_AN85 <- mnFactorSpecialPayee

      VA evt_mnAddressNumberParent_PA8 <- mnParentNumber

      VA evt_AddressType3_AT3 <- cAddressType3YN

      VA evt_AddressType4_AT4 <- cAddressType4YN

      VA evt_AddressType5_AT5 <- cAddressType5YN

      UNDEFINED X szCategoryCode01

      UNDEFINED X szAccountRepresentative

      UNDEFINED X szCategoryCode03

      UNDEFINED X szGeographicRegion

      UNDEFINED X szCategoryCode05

      UNDEFINED X szCategoryCode06

      UNDEFINED X sz1099Reporting

      UNDEFINED X szCategoryCode08

      UNDEFINED X szCategoryCode09

      UNDEFINED X szCategoryCode10

      UNDEFINED X szSalesRegion

      UNDEFINED X szCategoryCode12

      UNDEFINED X szLineOfBusiness

      UNDEFINED X szSalesVolume

      UNDEFINED X szCategoryCode15

      UNDEFINED X szCategoryCode16

      UNDEFINED X szCategoryCode17

      UNDEFINED X szCategoryCode18

      UNDEFINED X szCategoryCode19

      UNDEFINED X szCategoryCode20

      UNDEFINED X szCategoryCode21

      UNDEFINED X szCategoryCode22

      UNDEFINED X szCategoryCode23

      UNDEFINED X szCategoryCode24

      UNDEFINED X szCategoryCode25

      UNDEFINED X szCategoryCode26

      UNDEFINED X szCategoryCode27

      UNDEFINED X szCategoryCode28

      UNDEFINED X szCategoryCode29

      UNDEFINED X szCategoryCode30

      VA evt_GlBankAccount_GLBA <- szGlBankAccount

      VA evt_TimeScheduledIn_PTI <- mnTimeScheduledIn

      VA evt_DateScheduledIn_PDI <- jdDateScheduledIn

      VA evt_ActionMessageControl_MSGA <- cClearedY

      VA evt_szNameRemark_RMK <- szRemark

      VA evt_UserReservedCode_URCD <- szUserReservedCode

      VA evt_UserReservedDate_URDT <- jdUserReservedDate

      VA evt_UserReservedAmount_URAT <- mnUserReservedAmount

      VA evt_UserReservedNumber_URAB <- mnUserReservedNumber

      VA evt_UserReservedReference_URRF <- szUserReservedReference

      UNDEFINED X jdDateEffective

      BF szProgramId -> szProgramId

      UNDEFINED X szRemark1

      UNDEFINED X mnAddNumParentOriginal

      UNDEFINED X OKToDelete

      UNDEFINED X szVersionconsolidated

      UNDEFINED X cDirectionIndicator

      UNDEFINED X cEdiSuccessfullyProcess

      UNDEFINED X szCountryForPayroll

      UNDEFINED X szShortcutClientType

End If

If BF szCountryForPayroll is equal to  Or BF szCountryForPayroll is equal to 

   BF szCountryForPayroll = BF sxPODefaultCountryForPayroll

End If

VA evt_AddressTypeEmployee_ATE = "Y"

// Update or Add record based on exsistance

If BF cABRecordExsistsFlag is equal to "1"

   Address Book - MBF

      "C" -> cActionCode

      "1" -> cUpdateMasterFile

      UNDEFINED X cProcessEdits

      BF cSuppressErrorFlag -> cSuppressErrorMessages

      BF szErrorMessageId <- szErrorMessageID

      BF szVersion -> szVersion

      UNDEFINED X mnSameAsExcept

      BF mnAddressNumber <> mnAddressBookNumber

      VA evt_szLongAddressNumber_ALKY -> szLongAddressNumber

      BF szTaxId -> szTaxId

      BF szSearchType -> szSearchType

      BF szNameAlpha -> szAlphaName

      VA evt_szSecondaryAlpha_ALP1 -> szSecondaryAlphaName

      BF szNameMailing -> szMailingName

      VA evt_szSecondaryMailingName_MLN -> szSecondaryMailingName

      VA evt_szDescripCompressed_DC -> szDescriptionCompressed

      BF szCostCenter -> szBusinessUnit

      BF szAddressLine1 -> szAddressLine1

      BF szAddressLine2 -> szAddressLine2

      BF szAddressLine3 -> szAddressLine3

      BF szAddressLine4 -> szAddressLine4

      BF szZipCodePostal -> szPostalCode

      BF szCity -> szCity

      BF szCountyAddress -> szCounty

      BF szState -> szState

      BF szCountry -> szCountry

      VA evt_szCarrierRoute_CRTE -> szCarrierRoute

      VA evt_szBulkMailingCenter_MKML -> szBulkMailingCenter

      BF szPhoneAreaCode1 -> szPrefix1

      BF szPhoneNumber1 -> szPhoneNumber1

      BF szPOWorkPhoneNumberType -> szPhoneNumberType1

      BF szPhoneAreaCode2 -> szPhoneAreaCode2

      BF szPhoneNumber2 -> szPhoneNumber2

      BF szPOHomePhoneNumberType -> szPhoneNumberType2

      VA evt_AddressTypePayables_ATP -> cPayablesYNM

      VA evt_AddressTypeReceivables_ATR -> cReceivablesYN

      VA evt_AddressTypeEmployee_ATE -> cEmployeeYN

      VA evt_cUserCode_ATPR -> cUserCode

      VA evt_cARAPNettingY_AT2 -> cARAPNettingY

      VA evt_SubledgerInactiveCode_SBLI -> cSubledgerInactiveCode

      VA evt_PersonCorporationCode_TAXC -> cPersonCorporationCode

      VA evt_CertificateTaxExempt_TXCT -> szCertificate

      VA evt_szAddllndTaxID_TX2 -> szAddlIndTaxID

      VA evt_CreditMessage_CM -> szCreditMessage

      VA evt_LanguagePreference_LNGP -> szLanguage

      VA evt_szIndustryClassificati_SIC -> szIndustryClass

Data Structure

D0500710B - Employee Hire Address Book Update

Parameter NameData ItemData TypeReq/OptI/O/Both
mnAddressNumberAN8MATH_NUMERICREQINPUT

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

cABRecordExsistsFlagEV01charOPTINPUT

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

cSuppressErrorFlagEV01charOPTINPUT

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

szErrorMessageIdDTAIcharOPTOUTPUT

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.

szProgramIdPIDcharOPTINPUT

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.

szVersionVERScharOPTINPUT

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.

szWorkStationIdJOBNcharOPTINPUT

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

jdDateUpdatedUPMJJDEDATEOPTINPUT

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

mnTimeLastUpdatedUPMTMATH_NUMERICOPTINPUT

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

szSearchTypeAT1charOPTNONE

A user defined code (01/ST) that specifies the kind of address book record to search for. Examples include: E Employees   X Ex-employees  
V Suppliers   C Customers  P    Prospects M Mail distribution lists   TAX Tax authorities

szTaxIdTAXcharOPTNONE

The identification code required by various tax authorities. This can be a social security number, federal or state corporate tax ID, sales tax 
number, and so on. The system verifies the number and prints the separators in their correct format, according to the value of TAXC 
(Person/Corporation Code). If no value exists for TAXC, the system uses the Corporate Entity. Attention Accounts Payable users: The Supplier Master 
record supplies the default value for the tax ID for 1099 processing.

szNameAlphaALPHcharOPTNONE

The text that names or describes an address. This 40-character alphabetic field appears on a number of forms and reports. You can enter 
dashes, commas, and other special characters, but the system cannot search on them when you use this field to search for a name.

szNameMailingMLNMcharOPTNONE

The company or person to whom billing or correspondence is addressed.

szCostCenterMCUcharOPTNONE

An alphanumeric code that identifies a separate entity within a business for which you want to track costs. For example, a business unit 
might be a warehouse location, job, project, work center, branch, or plant. You can assign a business unit to a document, entity, or person for 
purposes of responsibility reporting. For example, the system provides reports of open accounts payable and accounts receivable by 
business unit to track equipment by responsible department. Business unit security might prevent you from viewing information about business units 
for which you have no authority.

szAddressLine1ADD1charOPTNONE

The first line of a mailing address for an employee, customer, or supplier in the Address Book system. The U.S. Internal Revenue Service 
(IRS) restricts the size of the address that prints on an employee's year-end tax return. To comply with IRS regulations, the system has the 
following restrictions:   o  On W-2 returns, the system prints only the last three nonblank address lines plus the city, state, and postal code.   o  On 
1099 returns, the system prints only the last nonblank address line plus the city, state, and postal code.   o  On other U.S. federal magnetic 
media, the system prints only the last nonblank address line plus the city, state, and postal code.

szAddressLine2ADD2charOPTNONE

The second line of the mailing address for an employee, customer, or supplier in the Address Book system. Attention Payroll users: The 
Internal Revenue Service (IRS) restricts the size of the address that prints on employee's year-end forms. To comply with IRS regulations, the 
address that prints on W-2 forms includes only the last three nonblank address lines plus the city, state, and postal code. The address that 
prints on 1099 forms includes only the last nonblank address line plus the city, state, and postal code. If you process year-end information using 
the federal magnetic media format, the address that prints on those forms contains only the last nonblank address line plus the city, state, 
and postal code.

szAddressLine3ADD3charOPTNONE

The third line of the mailing address for an employee, customer, or supplier in the Address Book system. Attention Payroll users: The 
Internal Revenue Service (IRS) restricts the size of the address that prints on employee's year-end forms. To comply with IRS regulations, the 
address that prints on W-2 forms includes only the last three nonblank address lines plus the city, state, and postal code. The address that prints 
on 1099 forms includes only the last nonblank address line plus the city, state, and postal code. If you process year-end information using 
the federal magnetic media format, the address that prints on those forms contains only the last nonblank address line plus the city, state, and 
postal code.

szAddressLine4ADD4charOPTNONE

The fourth line of the mailing address for an employee, customer, or supplier in the Address Book system. Attention Payroll users: The 
Internal Revenue Service (IRS) restricts the size of the address that prints on employee's year-end forms. To comply with IRS regulations, the 
address that prints on W-2 forms includes only the last three nonblank address lines plus the city, state, and postal code. The address that 
prints on 1099 forms includes only the last nonblank address line plus the city, state, and postal code. If you process year-end information using 
the federal magnetic media format, the address that prints on those forms contains only the last nonblank address line plus the city, state, and 
postal code.

szCityCTY1charOPTNONE

A name that indicates the city associated with the address.

szStateADDScharOPTNONE

A user defined code (00/S) that specifies the state or province. This code is usually a postal service abbreviation.

szZipCodePostalADDZcharOPTNONE

The United States ZIP code or the postal code that specifies where a letter is to be routed.  Attach this code to the address for delivery in 
other countries. This code is used as the low end value when doing Postal Code Transaction range processing.

szCountyAddressCOUNcharOPTNONE

The name of a county, parish, or other political district that is necessary for the address or for tax purposes.

szCountryCTRcharOPTNONE

A user defined code (00/CN) that identifies a country. The country code has no effect on currency conversion. The Address Book system 
uses the country code for data selection and address formatting.

szPhoneAreaCode1AR1charOPTNONE

The first segment of a telephone number. In the United States, the prefix is the three-digit area code.

szPhoneNumber1PH1charOPTNONE

A number without the prefix or special characters, such as hyphens or periods, that makes up the telephone number for an entity. You can 
use any applicable telephone number format for a country. This field is used in conjunction with the Prefix field (AR1), where you enter the first 
segment of the telephone number, which is called the area code in the United States. When you search for an address using a phone 
number, you must enter the number exactly as it is set up in the Address Book system, including any special characters.

szPhoneAreaCode2AR3charOPTNONE

The prefix for telephone number 3. The default format for the Phone Prefix data dictionary item is set to the United States prefix (area code). 
This format is three characters enclosed in parentheses. For example, (303). If you require an alternate format to accommodate a non-United 
States prefix, you must change the data display rules in the data dictionary.

szPhoneNumber2PH3charOPTNONE

The telephone number has been established in free form to allow incorporation of extension numbers and local telephone oddities. For 
example, Laramie, Wyoming could be expressed as 21-5223; and Singapore could be expressed as 011-65-469-8382. If all phone numbers 
are to follow a consistent format, you may specify an edit code in the data dictionary for the phone number (e.g., ___-____).  Note: In using the 
phone search capability of the Address Book, you must spell the search in the same manner that you recorded the phone numbers.

szContactNameMailingMLNMcharOPTNONE

The company or person to whom billing or correspondence is addressed.

szContactPhoneAreaCodeAR4charOPTNONE

The prefix for telephone number 4. The default format for the Phone Prefix data dictionary item is set to the United States prefix (area code). 
This format is three characters enclosed in parentheses. For example, (303). If you require an alternate format to accommodate a non-United 
States prefix, you must change the data display rules in the data dictionary.

szContactPhoneNumberPH4charOPTNONE

The telephone number has been established in free form to allow incorporation of extension numbers and local telephone oddities. For 
example, Laramie, Wyoming could be expressed as 21-5223; and Singapore could be expressed as 011-65-469-8382. If all phone numbers 
are to follow a consistent format, you may specify an edit code in the data dictionary for the phone number (e.g., ___-____).   Note: In using the 
phone search capability of the Address Book,you must spell the search in the same manner that you recorded the phone numbers.

szEmailREM1charOPTNONE

A 40-character field that you can use to enter text.

szCountryForPayrollCCPRcharOPTNONE

A user defined code list 00/CN that indicates the country in which the employee resides.

szReportCodeAddBook001AC01charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to group address book 
records for reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples of category codes 
include: Category code 01   Location or Branch Category code 02 Salesperson Category code 03   Product Category code 04   Credit officer

szReportCodeAddBook002AC02charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user-defined (system 01, types 01 through 30). Examples: Category code 01 - Location or 
Branch  Category code 02 - Account Representative  Category code 03 - New tenant  Category code 04 - Credit officer

szReportCodeAddBook003AC03charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user-defined (system 01, types 01 through 30). Examples: Category code 01 - Location or 
Branch  Category code 02 - Salesperson  Category code 03 - New tenant  Category code 04 - Credit officer

szReportCodeAddBook004AC04charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user-defined (system 01, types 01 through 30). Examples: Category code 01 - Location or 
Branch  Category code 02 - Salesperson  Category code 03 - New tenant  Category code 04 - Credit officer

szReportCodeAddBook005AC05charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user-defined (system 01, types 01 through 30). Examples: Category code 01               Location 
or Branch Category code 02               Salesperson Category code 03               New tenant Category code 04               Credit officer

szReportCodeAddBook006AC06charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user-defined (system 01, types 01 through 30). Examples: Category code 01               Location 
or Branch Category code 02               Salesperson Category code 03               New tenant Category code 04               Credit officer

szReportCodeAddBook007AC07charOPTNONE

One of 30 reporting codes that you can assign to an address in the Address Book system. Category Code 07 is used in the 1099 process to 
identify the box on the 1099 form in which a voucher or pay item should be reported. Examples include: 01 Rents 13 Nontaxable 
distributions 61  Interest income A7  Nonemployee compensation

szReportCodeAddBook008AC08charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook009AC09charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook010AC10charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook011AC11charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook012AC12charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook013AC13charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook014AC14charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook015AC15charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook016AC16charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user-defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook017AC17charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user-defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook018AC18charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user-defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook019AC19charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user-defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szReportCodeAddBook020AC20charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk21AC21charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk22AC22charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk23AC23charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk24AC24charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk25AC25charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk26AC26charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk27AC27charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk28AC28charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk29AC29charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk30AC30charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

sxPODefaultCountryForPayrollCCPRcharOPTNONE

A user defined code list 00/CN that indicates the country in which the employee resides.

cPOEmergencyContactTypeTYCcharOPTNONE

A user defined code (01/W0) that identifies the Who's Who entry. Examples include: A Attention name B Billing C Contact name E Emergency 
Contact O Other T 1099 legal name 

szPOHomePhoneNumberTypePHTPcharOPTNONE

A user defined code (01/PH) that indicates either the location or use of a telephone number. Valid values include: Blank Business telephone 
number FAX Fax telephone number HOM Home telephone number

szPOWorkPhoneNumberTypePHTPcharOPTNONE

A user defined code (01/PH) that indicates either the location or use of a telephone number. Valid values include: Blank Business telephone 
number FAX Fax telephone number HOM Home telephone number

Related Functions

None

Related Tables

None
EmployeeHireApplicantUpdate

EmployeeHireApplicantUpdate

Process Other Tables For Employee Hire

Minor Business Rule

Object Name: N0500710

Parent DLL: CHRM

Location: Client/Server

Language: NER

Function Name:  Employee Hire Applicant Update

Purpose:


This function updates the applicant and supplemental data records for a new employee.


Parameters: 


Data Item Data Structure DescriptionI/ORequiredNotes

AN8mnAddressNumberIY

EV01cSuppressErrorFlagIN

DTAIszErrorMessageIdON

PIDszProgramIdIN

VERSszVersionIN

JOBNszWorkStationIdIN

UPMJjdDateUpdatedIN

UPMTmnTimeLastUpdatedIN

VERszApplicantVersionIN

CCPRszCountryForPayrollIN

EFTOjdDateEffectiveOnIN


Related Tables:


Table Table Description

F08401Applicant Master

F08402Applicant Master - Append Table


Related Business Functions:


Source NameFunction Name

N0500055F08401 Fetch Applicant Information

N0000158F00092 Update Supplemental Data

N0800029Transfer Supp Data on Hire/Terminate Employee


Processing:


=======================================================================

NAMED ER: Employee Hire Applicant Update

=======================================================================

evt_cErrorFlag_EV01

evt_szApplicantHireStatus_APS

evt_cTranserSupData_EV01

evt_szSuppDataErrorCode_DTAI

// update applicant status and date

F08401 Fetch Applicant Information

   BF mnAddressNumber -> mnAddressNumber

   UNDEFINED X szNameAlpha

   UNDEFINED X szApplicantStatus

   UNDEFINED X szSocialSecurityNumber

   UNDEFINED X szCostCenter

   UNDEFINED X szPositionID

   UNDEFINED X szJobCategory

   UNDEFINED X szJobStep

   UNDEFINED X szJobCategoryEeo

   UNDEFINED X cSexMaleFemale

   UNDEFINED X cI9Status

   UNDEFINED X cVeteran

   UNDEFINED X cDisabledVeteran

   UNDEFINED X cHandicapped

   UNDEFINED X jdDateBirth

   UNDEFINED X mnRtSalaryAsking

   UNDEFINED X cEverestEventPoint01

   VA evt_cErrorFlag_EV01 <- cErrorCode

   UNDEFINED X szDataItem

   UNDEFINED X szCostCenterHome

   UNDEFINED X szMinorityEeo

If VA evt_cErrorFlag_EV01 is equal to 

   If BF szWorkStationId is equal to  Or BF szWorkStationId is equal to 

      Get Audit Information

         UNDEFINED X szUserName

         UNDEFINED X jdDate

         BF mnTimeLastUpdated <- mnTime

         BF szWorkStationId <- szWorkstation_UserId

         UNDEFINED X szMachineKey

   End If

   Get Applicant Processing Options

      VA evt_szApplicantHireStatus_APS <- szApplicantHireStatus

      UNDEFINED X cUseReqn

      UNDEFINED X cJobDefaultInfo

      VA evt_cTranserSupData_EV01 <- cXferProfile

      UNDEFINED X mnNotifyID

      UNDEFINED X cDeleteProfile

      UNDEFINED X cRequiredFields

      UNDEFINED X cStatus

      BF szVersion -> szVersion

   F08401.Update

      BF mnAddressNumber =  TK Address Number

      VA evt_szApplicantHireStatus_APS -> TK Status - Applicant

      SL UserID                          -> TK User ID

      BF szProgramId -> TK Program ID

      SL DateToday                       -> TK Date - Updated

      BF szWorkStationId -> TK Work Station ID

   F00092 Update Supplemental Data

      "A" -> szSupplementalDatabaseCode

      "A" -> cActionCode

      UNDEFINED X szBusinessUnit

      UNDEFINED X szKeyCompany

      BF mnAddressNumber -> mnNumericKey1

      UNDEFINED X mnNumericKey2

      UNDEFINED X szAlphaKey1

      UNDEFINED X szAlphaKey2

      "A" -> szDataType

      UNDEFINED X szCopyToBusinessUnit

      UNDEFINED X szCopyToKeyCompany

      UNDEFINED X mnCopyToNumericKey1

      UNDEFINED X mnCopyToNumericKey2

      UNDEFINED X szCopyToAlphanumericKey1

      UNDEFINED X szCopyToAlphanumericKey2

       -> szCopyToDataType

      VA evt_szApplicantHireStatus_APS -> szUserDefinedCodeValue

      UNDEFINED X szUDCAssociatedDescription

      SL DateToday                       -> jdEffectiveDate

      UNDEFINED X jdEndingEffectiveDate

      UNDEFINED X jdTickleDate

      UNDEFINED X mnUserDefinedAmount1

      UNDEFINED X mnUserDefinedAmount2

      UNDEFINED X szRemark1

      UNDEFINED X szRemark2

      UNDEFINED X mnUserDefinedDays

      UNDEFINED X mnUserDefinedAddressNumber

      UNDEFINED X jdUserDefinedDate

      SL UserID                          -> szUserID

      BF szProgramId -> szProgramID

      UNDEFINED X cSuppressErrorMessage

      UNDEFINED X szErrorMessageID

      UNDEFINED X mnUserDefinedQuantity

      UNDEFINED X szCopyToSuppDatabaseCode

      UNDEFINED X szRelatedPoSoNumber

      UNDEFINED X szRelatedOrderType

      UNDEFINED X cNoAssignedEndDate

   F08402.Fetch Single

      BF mnAddressNumber =  TK Address Number

   If SV File_IO_Status is equal to CO SUCCESS

      F08402.Update

         BF mnAddressNumber =  TK Address Number

         BF jdDateEffectiveOn -> TK Date - Effective On

         BF szCountryForPayroll -> TK Country Code

         SL UserID                          -> TK User ID

         BF szProgramId -> TK Program ID

         SL DateToday                       -> TK Date - Updated

         BF szWorkStationId -> TK Work Station ID

   Else

      F08402.Insert

         BF mnAddressNumber -> TK Address Number

         BF jdDateEffectiveOn -> TK Date - Effective On

         BF szCountryForPayroll -> TK Country Code

         SL UserID                          -> TK User ID

         BF szProgramId -> TK Program ID

         SL DateToday                       -> TK Date - Updated

         BF szWorkStationId -> TK Work Station ID

   End If

   If SV File_IO_Status is not equal to CO SUCCESS

      // Insert or Update Failed return error id

      BF szErrorMessageId = "103I"

   End If

   If VA evt_cTranserSupData_EV01 is equal to "1"

      Transfer Supp Data on Hire/Terminate Employee

         "H" -> cCrossReferenceType

         BF mnAddressNumber -> mnAddressNumber

         "1" -> cSuppressErrorMessages

         VA evt_szSuppDataErrorCode_DTAI <- szErroMessageID

         SL UserID                          -> szUserId

         BF szProgramId -> szProgramId

         VA evt_cErrorFlag_EV01 <- cErrorFlag

   End If

End If


Data Structure

D0500710D - Employee Hire Applicant Update

Parameter NameData ItemData TypeReq/OptI/O/Both
mnAddressNumberAN8MATH_NUMERICREQINPUT

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

cSuppressErrorFlagEV01charOPTINPUT

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

szErrorMessageIdDTAIcharOPTOUTPUT

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.

szProgramIdPIDcharOPTINPUT

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.

szVersionVERcharOPTINPUT

Identifies a specific set of data selection and sequencing settings for the application. Versions may be named using any combination of 
alpha and numeric characters. Versions that begin with 'XJDE' or 'ZJDE' are set up by J.D. Edwards.

szWorkStationIdJOBNcharOPTINPUT

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

jdDateUpdatedUPMJJDEDATEOPTINPUT

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

mnTimeLastUpdatedUPMTMATH_NUMERICOPTINPUT

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

szCountryForPayrollCCPRcharOPTNONE

A user defined code list 00/CN that indicates the country in which the employee resides.

jdDateEffectiveOnEFTOJDEDATEOPTNONE

A future date when all changes will take effect or the date when the changes went into effect. If you do not enter a date in this field, the system 
uses the current date as the effective date.

Related Functions

None

Related Tables

None
EmployeeHireRequisitionEdit

EmployeeHireRequisitionEdit

Process Other Tables For Employee Hire

Minor Business Rule

Object Name: N0500710

Parent DLL: CHRM

Location: Client/Server

Language: NER

Data Structure

D0500710F - Employee Hire Requisition Edit

Parameter NameData ItemData TypeReq/OptI/O/Both
mnAddressNumberAN8MATH_NUMERICREQINPUT

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

cSuppressErrorFlagEV01charOPTINPUT

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

szErrorMessageIdDTAIcharOPTOUTPUT

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.

mnRequisitionNumberREQNMATH_NUMERICOPTNONE

The number that identifies the position requisition. This number must be unique. The next number program assigns this number if no other 
number is provided when the requisition is initially entered.

szPositionIDPOScharOPTNONE

A code that you use for budgetary (position) control purposes. The position ID consists of:   o  Position (position code and its description)     
o  Fiscal year     o  Home business unit  For example, you can identify position A0-1 as Accounting Manager for fiscal year 2005-2006, for 
home business unit 41. You might choose to set up positions so that the position IDs are the same as the corresponding job IDs. Within a home 
business unit, positions appear in the alphanumeric sequence of their position IDs. For example, position A0-1 appears before position A0-2.

jdDateEffectiveOnEFTOJDEDATEOPTNONE

A future date when all changes will take effect or the date when the changes went into effect. If you do not enter a date in this field, the system 
uses the current date as the effective date.

szCandidateRequisitionStatCRSTcharOPTNONE

The current activity level of a candidate record that is attached to a requisition. The system retrieves these codes from user defined code 
table 08/CN. You can group candidate requisition status codes based on the hard-coded special handling code values in the table. These 
hard-coded values are: CAN Any candidate code   DET Any code indicating that the position is detached or no longer filled   FIL Any code 
indicating that the position has been filled   REJ Rejected TMP Temporarily filled  Candidate requisition status codes that have a special handling 
code of either FIL or TMP update the Filled Headcount field. However, only those status codes that have special handling codes of FIL can 
cause the system to change the requisition status to "Filled and Closed."

szJobCategoryJBCDcharOPTNONE

A user defined code (07/G) that defines the jobs within your organization. You can associate pay and benefit information with a job type and 
apply that information to the employees who are linked to that job type.

szJobStepJBSTcharOPTNONE

A user defined code (07/GS) that designates a specific level within a particular job type. The system uses this code in conjunction with job 
type to determine pay rates by job in the Pay Rates table.

Related Functions

None

Related Tables

None
EmployeeHireRequisitionUpdate

EmployeeHireRequisitionUpdate

Process Other Tables For Employee Hire

Minor Business Rule

Object Name: N0500710

Parent DLL: CHRM

Location: Client/Server

Language: NER

Data Structure

D0500710C - Employee Hire Requisition Update

Parameter NameData ItemData TypeReq/OptI/O/Both
mnAddressNumberAN8MATH_NUMERICREQINPUT

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

cSuppressErrorFlagEV01charOPTNONE

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

szErrorMessageIdDTAIcharOPTOUTPUT

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.

szProgramIdPIDcharOPTINPUT

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.

szVersionVERScharOPTINPUT

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.

szWorkStationIdJOBNcharOPTINPUT

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

jdDateUpdatedUPMJJDEDATEOPTINPUT

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

mnTimeLastUpdatedUPMTMATH_NUMERICOPTINPUT

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

mnRequisitionNumberREQNMATH_NUMERICOPTNONE

The number that identifies the position requisition. This number must be unique. The next number program assigns this number if no other 
number is provided when the requisition is initially entered.

szPositionIDPOScharOPTNONE

A code that you use for budgetary (position) control purposes. The position ID consists of:   o  Position (position code and its description)     
o  Fiscal year     o  Home business unit  For example, you can identify position A0-1 as Accounting Manager for fiscal year 2005-2006, for 
home business unit 41. You might choose to set up positions so that the position IDs are the same as the corresponding job IDs. Within a home 
business unit, positions appear in the alphanumeric sequence of their position IDs. For example, position A0-1 appears before position A0-2.

jdDateEffectiveOnEFTOJDEDATEOPTNONE

A future date when all changes will take effect or the date when the changes went into effect. If you do not enter a date in this field, the system 
uses the current date as the effective date.

szCandidateRequisitionStatCRSTcharOPTNONE

The current activity level of a candidate record that is attached to a requisition. The system retrieves these codes from user defined code 
table 08/CN. You can group candidate requisition status codes based on the hard-coded special handling code values in the table. These 
hard-coded values are: CAN Any candidate code   DET Any code indicating that the position is detached or no longer filled   FIL Any code 
indicating that the position has been filled   REJ Rejected TMP Temporarily filled  Candidate requisition status codes that have a special handling 
code of either FIL or TMP update the Filled Headcount field. However, only those status codes that have special handling codes of FIL can 
cause the system to change the requisition status to "Filled and Closed."

Related Functions

None

Related Tables

None
EmployeeHireTaxOverrideUpdate

EmployeeHireTaxOverrideUpdate

Process Other Tables For Employee Hire

Minor Business Rule

Object Name: N0500710

Parent DLL: CHRM

Location: Client/Server

Language: NER

Function Name:  Employee Hire Tax Override Update

Purpose:


This function adds the FEDERAL tax override record to the F06017 table for new US employees.


Parameters:


Data Item Data Structure DescriptionI/ORequiredNotes

AN8mnAddressNumberIY

EV01cSuppressErrorFlagIN

DTAIszErrorMessageIdON

PIDszProgramIdIN

VERSszVersionIN

JOBNszWorkStationIdIN

UPMJjdDateUpdatedIN

UPMTmnTimeLastUpdatedIN

PTAXszPayrollTaxTypeIN

TAROszTaxAreaOverriddenIN

FT01cAdditionalFlatTax001IN

SC01szStatutoryCode1IN

CCPRszCountryForPayrollIN


Related Tables:


Table Table Description

F0617Employee Tax Exemptions/Overrides


Processing:


=======================================================================

NAMED ER: Employee Hire Tax Override Update

=======================================================================

// Add Default FEDERAL tax override to F06017 - US Employee's Only

If BF szCountryForPayroll is equal to "US"

   If BF szPayrollTaxType is equal to  Or BF szPayrollTaxType is equal to 

      BF szPayrollTaxType = "A"

   End If

   If BF szTaxAreaOverridden is equal to  Or BF szTaxAreaOverridden is equal to 

      BF szTaxAreaOverridden = "FEDERAL"

   End If

   If BF szStatutoryCode1 is equal to  Or BF szStatutoryCode1 is equal to 

      BF szStatutoryCode1 = ""

   End If

   If BF cAdditionalFlatTax001 is equal to  Or BF cAdditionalFlatTax001 is equal to 

      BF cAdditionalFlatTax001 = "A"

   End If

   F06017.Fetch Single

      BF mnAddressNumber =  TK Address Number

      BF szStatutoryCode1 =  TK Statutory Code 01

      BF cAdditionalFlatTax001 <- TK Additional/Flat Tax1

      BF szPayrollTaxType =  TK Tax Type

      BF szTaxAreaOverridden =  TK Tax Area Overridden

   If SV File_IO_Status is not equal to CO SUCCESS

      F06017.Insert

         BF mnAddressNumber -> TK Address Number

         BF szStatutoryCode1 -> TK Statutory Code 01

         BF cAdditionalFlatTax001 -> TK Additional/Flat Tax1

         BF szPayrollTaxType -> TK Tax Type

         BF szTaxAreaOverridden -> TK Tax Area Overridden

   End If

   If SV File_IO_Status is not equal to CO SUCCESS

      // Insert failed return error id

      BF szErrorMessageId = "103I"

   End If

End If




Data Structure

D0500710E - Employee Hire Tax Override Update

Parameter NameData ItemData TypeReq/OptI/O/Both
mnAddressNumberAN8MATH_NUMERICREQINPUT

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

cSuppressErrorFlagEV01charOPTINPUT

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

szErrorMessageIdDTAIcharOPTOUTPUT

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.

szProgramIdPIDcharOPTINPUT

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.

szVersionVERScharOPTINPUT

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.

szWorkStationIdJOBNcharOPTINPUT

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

jdDateUpdatedUPMJJDEDATEOPTINPUT

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

mnTimeLastUpdatedUPMTMATH_NUMERICOPTINPUT

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

szPayrollTaxTypePTAXcharOPTNONE

A code that specifies the type of payroll tax being processed. This is a user defined code (07/TX). To set up state minimum wage amounts, 
you must enter MW in this field. To do so, you must first add MW to UDC 07/TX. However, you should not change the codes and definitions 
that J.D. Edwards provides with the software.

szTaxAreaOverriddenTAROcharOPTNONE

A code identifying a geographical location and the tax authorities therein. Authorities include both employee and employer statutory 
requirements. Refer to the Quantum for Payroll Tax System's "Master GEO Code List" for valid codes for your locations. This tax area code is used 
for overriding all tax types at the Employee Master level.

cAdditionalFlatTax001FT01charOPTNONE

A code that represents the method in which the additional tax is calculated. The code that you enter in this field indicates the function that is 
performed by the value that you enter in the Additional Federal Withholding field. Valid values are:    %   A percentage that replaces the tax rate 
from the tax table.    A An amount that is added to the tax computed from the tax table.    F An amount that replaces the tax computed from the 
tax table.    X An additional amount added to the standard exemption amount and deducted (exempt) from the annualized gross pay to 
determine taxable pay.    Y An amount that overrides the standard exemption amount and is subtracted from the annualized gross pay prior to the 
tax calculations.

szStatutoryCode1SC01charOPTNONE

A code that allows you to override supplemental taxes for federal and state taxes and to add additional local residence taxes. Valid values 
are:    F Override the federal supplemental tax for this employee.    S Override the state supplemental tax for this employee.    R Add 
additional local residence tax. When you override supplemental taxes, you must leave the Tax Area and Tax Type fields blank.

szCountryForPayrollCCPRcharOPTNONE

A user defined code list 00/CN that indicates the country in which the employee resides.

Related Functions

None

Related Tables

None
D>charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk23AC23charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk24AC24charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk25AC25charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk26AC26charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk27AC27charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk28AC28charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk29AC29charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

szCategoryCodeAddressBk30AC30charOPTNONE

One of thirty reporting codes that you can assign to an address in the Address Book system. Use these codes to identify addresses for 
reports, mailings, and so on. Category codes are user defined (system 01, types 01 through 30). Examples:    Category code 01               Location 
or Branch    Category code 02               Salesperson    Category code 03               New tenant    Category code 04               Credit officer

sxPODefaultCountryForPayrollCCPRcharOPTNONE

A user defined code list 00/CN that indicates the country in which the employee resides.

cPOEmergencyContactTypeTYCcharOPTNONE

A user defined code (01/W0) that identifies the Who's Who entry. Examples include: A Attention name B Billing C Contact name E Emergency 
Contact O Other T 1099 legal name 

szPOHomePhoneNumberTypePHTPcharOPTNONE

A user defined code (01/PH) that indicates either the location or use of a telephone number. Valid values include: Blank Business telephone 
number FAX Fax telephone number HOM Home telephone number

szPOWorkPhoneNumberTypePHTPcharOPTNONE

A user defined code (01/PH) that indicates either the location or use of a telephone number. Valid values include: Blank Business telephone 
number FAX Fax telephone number HOM Home telephone number

Related Functions

None

Related Tables

None
EmployeeHireApplicantUpdate

EmployeeHireApplicantUpdate

Process Other Tables For Employee Hire

Minor Business Rule

Object Name: N0500710

Parent DLL: CHRM

Location: Client/Server

Language: NER

Function Name:  Employee Hire Applicant Update

Purpose:


This function updates the applicant and supplemental data records for a new employee.


Parameters: 


Data Item Data Structure DescriptionI/ORequiredNotes

AN8mnAddressNumberIY

EV01cSuppressErrorFlagIN

DTAIszErrorMessageIdON