F31172ProcessMasterData

F31172 Process Master Data

Master Business Function

Object Name: N1700410

Parent DLL: CCRIN

Location: Client/Server

Language: NER

Functional Description

Purpose

To perform all inquiries, additions, updates and deletions to the Routing Extension Table (F31172).


Setup Notes and Prerequisites


Definitions

1)"Soft" errors are errors that do not cause the function to stop processing further and exit.
2) "Fatal" errors are errors that cause the function to stop processing further and exit. 

3)Any error (Soft or Fatal) will prevent database commits to occur.



Special Logic

The business function will currently recognize "CSMS" process module calls. 



Technical Specification


1.// Initialize work and output fields.
2.Error Message ID (DTAI) = " "

3.If Update Master File (EV01) <> '1' And <> '0' Then

4. Update Master File (EV01) = '0'

5.End IF

6.//

7.If Action Code (ACTN) = 'I' Then

8. Fetch Record from F31172 using DOCO, OPSQ, OPSC, and MCU. Return data to I/O Parameters.

9. If Failed Then Set Error 017F, Error Message ID (DTAI) = "017F"

10.End If

11.

12.If Update Master File (EV01) = '1' And Error Message ID (DTAI) = " " And Action Code <> 'I' 

Then

13. If Action Code (ACTN) = 'A' Then

14. Call B9800100 to retrieve USER, JOBN, UPMJ, TDAY

15. Add Record to F31172 using all I/O Parameters.

16. If Failed Then Set Error 026P, Error Message ID (DTAI) = "026P"

17. Else If Action Code (ACTN) = 'C' Then

18. Call B9800100 to retrieve USER, JOBN, UPMJ, TDAY

19. Update Record to F31172 using all I/O Parameters and DOCO, OPSQ, OPSC and MCU as Keys.

20. If Failed Then Set Error 026N, Error Message ID (DTAI) = "026N"

21. Else If Action Code (ACTN) = 'D' Then

22. Delete Record from F31172 using DOCO, OPSQ, OPSC and MCU as Keys.

23. If Failed Then Set Error 026O, Error Message ID (DTAI) = "026O"

24. End If

25.End If



Data Structure

D1700410 - F31172 Process Master Data

Parameter NameData ItemData TypeReq/OptI/O/Both
cActionCodeACTNcharOPTNONE

A code that specifies the action that is performed. Valid values are: A Add C Change

cUpdateMasterFileEV01charOPTNONE

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

cSuppressErrorMessageSUPPScharOPTNONE

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

cProcessEditsEV01charOPTNONE

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

szErrorMessageIDDTAIcharOPTNONE

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.

szProgramVersionForProcOptsVERScharOPTNONE

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.

szProgramIdForProcOptsPIDcharOPTNONE

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.

szProcessModuleVC04AcharOPTNONE

This is a generic field used as a work field in Everest.

mnOrderNumberDOCOMATH_NUMERICOPTNONE

A number that identifies an original document. This document can be a voucher, a sales order, an invoice, unapplied cash, a journal entry, 
and so on.

mnOperationSequenceNumberOPSQMATH_NUMERICOPTNONE

A number used to indicate an order of succession. In routing instructions, a number that sequences the fabrication or assembly steps in the 
manufacture of an item. You can track costs and charge time by operation. In bills of material, a number that designates the routing step in the 
fabrication or assembly process that requires a specified component part. You define the operation sequence after you create the routing 
instructions for the item. The Shop Floor Management system uses this number in the backflush/preflush by operation process. In engineering 
change orders, a number that sequences the assembly steps for the engineering change. For repetitive manufacturing, a number that 
identifies the sequence in which an item is scheduled to be produced. Skip To fields allow you to enter an operation sequence that you want to begin 
the display of information. You can use decimals to add steps between existing steps. For example, use 12.5 to add a step between steps 
12 and 13.

szTypeOperationCodeOPSCcharOPTNONE

A user defined code (30/OT) that indicates the type of operation. Valid values include: A Alternate routing   TT Travel time   IT Idle time   T Text

szBusinessUnitMCUcharOPTNONE

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.

cPayableYNPAYABcharOPTNONE

This field specifies whether a general ledger account should be paid. Valid values are:    Y The account should be paid.    N The account 
should not be paid.

cBillableYNBILLcharOPTNONE

Specifies whether a general ledger account should be billed. Valid codes are:    Y Yes, the account should be billed.    N No, it should not be 
billed.    1   It is eligible only for invoicing.    2   It is eligible only for revenue recognition.    4   It is eligible only for cost. Note: Codes 1, 2, and 4 
relate only to the Service Billing system.

mnActBillableRateACRTBMATH_NUMERICOPTNONE

The actual billable rate associated with a transaction.

mnActPayableRateACRTPMATH_NUMERICOPTNONE

The actual payable rate associated with a transaction.

mnEstimatedAmountEBILLMATH_NUMERICOPTNONE

mnActualDollarsAMTAMATH_NUMERICOPTNONE

The actual dollars accumulated for the work order.

mnAmountOriginalDollarsAMTOMATH_NUMERICOPTNONE

The estimated monetary amount that is budgeted for this work order.

mnEstimatedBillableRateESRTBMATH_NUMERICOPTNONE

The estimated billable rate associated with a service.

mnEstimatedPayableRateESRTPMATH_NUMERICOPTNONE

The estimated payable rate associated with a transaction.

mnEstimatedPaymentAmountEPAAPMATH_NUMERICOPTNONE

This is the estimated payment amount used in service billing.

mnTotalBilledTOTBMATH_NUMERICOPTNONE

The total amount billed through this application number.

mnClaimAmountCLAMTMATH_NUMERICOPTNONE

The amount requested for providing a service.

jdBillDateDTBILJDEDATEOPTNONE

In service billing, the date a customer was billed for a service.

jdPaidDateDTPAYJDEDATEOPTNONE

The date a service provider was paid for a service.

mnPaymentAmountPAAPMATH_NUMERICOPTNONE

In the Accounts Payable system, the amount of the payment. In the Accounts Receivable system, the amount of the receipt. This amount 
must balance to the total amount applied to the invoice pay items.

mnLaborRatePerHour1LBR1MATH_NUMERICOPTNONE

Under a Service Contract, the labor rate per hour charged while providing the service for each day of the week and for holidays.  For 
example, the hourly rate charged during a Help Desk Call or the hourly rate charged repairing the equipment on a Service Work Order.

jdActualStartDateD2JJDEDATEOPTNONE

Enter the actual start date for a project or job in this field. Use this information for reporting purposes.

mnStartTimeSTTIMATH_NUMERICOPTNONE

This is the start time for an operation or an order.

mnEstimatedEndingTimeEPETMMATH_NUMERICOPTNONE

The estimated ending time associated with a work order.

szCostTypeCOSTcharOPTNONE

A code that designates each element of cost for an item. Examples of the cost object types are:   o  A1  Purchased raw material   o  B1  
Direct labor routing rollup   o  B2  Setup labor routing rollup   o  C1  Variable burden routing rollup   o  C2  Fixed burden routing rollup   o  Dx  Outside 
operation routing rollup   o  Xx  Extra add-ons, such as electricity and water  The optional add-on computations usually operate with the type 
Xx extra add-ons. This cost structure allows you to use an unlimited number of cost components to calculate alternative cost rollups. The 
system then associates these cost components with one of six user defined summary cost buckets.

szUserIdUSERcharOPTNONE

The code that identifies a user profile.

szProgramIdPIDcharOPTNONE

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

szWorkStationIdJOBNcharOPTNONE

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

jdDateUpdatedUPMJJDEDATEOPTNONE

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

mnTimeOfDayTDAYMATH_NUMERICOPTNONE

The computer clock in hours:minutes:seconds.

szPriceAdjustScheduleServiceASN2charOPTNONE

This user defined code (40/AS) identifies a price and adjustment schedule. A price and adjustment schedule contains one or more 
adjustment types for which a customer or an item might be eligible. The system applies the adjustments in the sequence that you specify in the 
schedule. You link customers to a price and adjustment schedule through the customer billing instructions. When you enter a sales order, the 
system copies the schedule attached to the sold to address into the order header. You can override this schedule at the detail line level.

szPriceAdjustScheduleFourASN4charOPTNONE

A user defined code (40/AS) identifying a price and adjustment schedule. A price and adjustment schedule contains one or more 
adjustment types for which a customer or an item might be eligible. The system applies the adjustments in the sequence that you specify in the 
schedule. You link customers to a price and adjustment schedule through the customer billing instructions. When you enter a sales order, the 
system copies the schedule attached to the sold to address into the order header. You can override this schedule at the detail line level.

mnPercentCoveredPCOVRMATH_NUMERICOPTNONE

The percentage covered under warranty or contract. This is used to calculate the amount to bill or the amount to cost for the line item being 
processed on the service order or call.

cMethodofPricingMTHPRcharOPTNONE

A code used to determine if this type of service should be priced based on a flat rate or based on actual time and materials. Valid values 
are:    F        Charges for labor are based on one flat rate. Charges for parts are already included in the flat rate.    T        Charges for labor are 
based on actual labor hours. Charges for parts are based on actual parts used.    Blank A blank value is only valid when defining the Method of 
Pricing for a service provider. It is used to indicate that the service provider is an internal service provider and should not be paid.

mnServiceAddressNumberSAIDMATH_NUMERICOPTNONE

A unique numeric identifier for a physical location at which utility service is delivered.  A service address often corresponds to a parcel of 
land or a unit in an apartment building, etc.  This identifier will be assigned by the system through Next Numbers if it is not provided when 
adding a new service address.

szProductFamilyPRODFcharOPTNONE

A code that classifies an inventory item into a group for customer service. Some examples include: Laser Printer, Inkjet, or Fax.

szProductModelPRODMcharOPTNONE

A code that classifies an inventory item into a model for customer service. Some examples include: Laser Printer, Inkjet or Fax.

szCoverageGroupCOVGRcharOPTNONE

A user defined code that specifies the Coverage Group. The Coverage Group consists of unlimited cost codes and the percentage 
covered for each cost code.

cPayPricingMethodPMTHPcharOPTNONE

A code used to determine if this type of service should be priced based on a flat rate or based on actual time and materials. Valid values 
are:    F Flat Rate. Charges for labor are based on one flat rate. Charges for parts are already included in the flat rate.    T Time and Materials. 
Charges for labor are based on actual labor hours. Charges for parts are based on actual parts used.    blank None. A blank value is only 
valid when defining the Method of Pricing for a service provider. It is used to indicate that the service provider is an internal service provider and 
should not be paid.

cPayServProviderForPartsPYPRTcharOPTNONE

A code to indicate if the service provider should be paid for parts used during a repair. Valid values are:        Y or 1 - Pay the service provider 
for parts used.        N or 0 - Do not pay the service provider for parts used.

szEntitlementCheckENTCKcharOPTNONE

A user defined code (17/ER) to indicate the results of an entitlement check. Valid values are:    0   Not entitled    1   Transaction entitled    2   
Contract found, but no existing service type    3   Contract found, but no day and date assigned    4   Covered under default warranty

szGLCategoryNonCoveredGLCNCcharOPTNONE

A user defined code (41/9) that identifies the G/L Offset to use when the system is searching for the account to which it will post the 
non-covered portion of the accounting transaction. If you do not want to specify a G/L Offset, you can enter four asterisks in this field or you can leave 
this field blank. If you leave the field blank, the system uses the G/L Offset from Inventory.

szGLCategoryCoveredGLCCVcharOPTNONE

A user defined code (41/9) that identifies the G/L Offset to use when the system is searching for the account to which it will post the covered 
portion (by warranty or contract) of the accounting transaction. If you do not want to specify a G/L Offset, you can enter four asterisks in this 
field or you can leave this field blank. If you leave this field blank, the system uses the G/L Offset from Inventory.

szBaseCurrencyCRDCcharOPTNONE

A code that identifies the domestic (base) currency of the company on a transaction. 

szBillableCurrencyBCRCDcharOPTNONE

The currency for the billable amounts of a service order.

mnBillableExchangeRateBCRRMATH_NUMERICOPTNONE

The rate that the system uses to convert foreign currency amounts to domestic currency amounts. The system uses this rate specifically for 
converting billable amounts.

cBillableCurrencyModeBCRRMcharOPTNONE

A code that specifies whether the system uses the foreign currency (currency of the customer) or the domestic currency for billable 
amounts. Valid values are: F Foreign   D Domestic

szPayableCurrencyPCRCDcharOPTNONE

A code that indicates the currency of the payable amounts on a work order or claim.

mnPayableExchangeRatePCRRMATH_NUMERICOPTNONE

The rate that the system uses to convert foreign currency amounts to domestic currency amounts. The system uses this rate specifically for 
converting payable amounts.

cPayableCurrencyModePCRRMcharOPTNONE

A code that specifies whether payable amounts are in the foreign currency (currency of the service provider) or in the domestic currency. 
Valid values are: F Foreign   D Domestic

mnForeignEstBillUnitFESUNBMATH_NUMERICOPTNONE

The estimated unit rate that is billable in the currency of the customer.

mnForeignEstBillAmountFEBILLMATH_NUMERICOPTNONE

The estimated billable amount in the currency of the customer.

mnForeignActBillUnitFACUNBMATH_NUMERICOPTNONE

The actual unit rate that is billable in the currency of the customer.

mnForeignActBillAmountFTOTBMATH_NUMERICOPTNONE

The actual amount that is billable in the currency of the customer.

mnForeignActPayAmountFPAAPMATH_NUMERICOPTNONE

The actual payable amount that is recorded in the foreign currency of the service provider.

mnForeignEstPayUnitFESUNPMATH_NUMERICOPTNONE

The estimated unit rate that is payable in the currency of the service provider.

mnForeignEstPayAmountFEPAAPMATH_NUMERICOPTNONE

The estimated payable amount in the currency of the service provider.

mnForeignActPayUnitFACUNPMATH_NUMERICOPTNONE

The actual unit rate that is payable in the currency of the service provider.

szCostCenterCausalMCUCSLcharOPTNONE

The business unit that is related to the causal portion of the claim.

szVendorLotNumberRLOTcharOPTNONE

The supplier's lot number for the item.

mnSRVendorNoSRVENDMATH_NUMERICOPTNONE

The address book number of the vendor to be used for supplier recovery.

mnUniqueKeyPricingUKIDPMATH_NUMERICOPTNONE

szFailureCodeFAILCDcharOPTNONE

A user defined code (17/FC) that indicates the type of defect.

jdDateSubmittedDTSUBJDEDATEOPTNONE

The date that a supplier recovery claim was submitted to the interoperability tables for Warranty Claim/Supplier Recovery 
Processing(F4801Z2 and F4801TZ2).

mnTimeSubmittedTMSUBMATH_NUMERICOPTNONE

The time that a supplier recovery claim was submitted to the interoperability tables.

mnCausalPartCSLPRTMATH_NUMERICOPTNONE

The item number that indicates which part failed and caused the equipment failure.

cInvoiceRequiredINVREQcharOPTNONE

A code that determines whether an invoice is required. Valid values are: 0 An invoice is not required. 1 An invoice is required.

cInvoiceReceivedINVRECcharOPTNONE

A code that indicates whether an invoice is received. Valid values are: 0 An invoice is not received. 1 An invoice is received.

szRTSSystem_VMRS31VMRS31charOPTNONE

A user defined code (17/C6) that indicates a specific system, such as the air conditioning system, that is associated with a piece of 
equipment. The system uses the UDCs for the system, the assembly, and the part to identify a particular position within the equipment.

szRTSAssembly_VMRS32VMRS32charOPTNONE

A user defined code (17/C7) that indicates the location of a specific assembly, such as the air conditioning compressor, within a piece of 
equipment. The system uses the UDCs for the system, the assembly, and the part to identify a particular position within the equipment.

szRTSPart_VMRS33VMRS33charOPTNONE

A user defined code (17/C8) that indicates the location of a specific part, such as the fuse to the air conditioning compressor clutch,  within a 
piece of equipment. The system uses the UDCs for the system, the assembly, and the part to identify a particular position within the 
equipment.

cLaborSource_LSRCELSRCEcharOPTNONE

A user defined code (17/LS) that specifies whether the system tracks labor amounts and information or whether it tracks third-party invoice 
amounts and information.

Related Functions

None

Related Tables

None