F31171ProcessMasterData

F31171 Process Master Data

Master Business Function

Object Name: N1700400

Parent DLL: CCRIN

Location: Client/Server

Language: NER

Functional Description

Purpose

To perform all inquiries, additions, updates and deletions to the Parts List Extension Table (F31171).


Setup Notes and Prerequisites


Special Logic

Modes:

Add     = 'A'

Change  = 'C'

Delete  = 'D'

Inquire = 'I'


Any other values will not allow the commit to the database.


Update Master File:

No updates, edit only (Default) = 0

Update the database             = 1



Technical Specification

2.4      Processing 

•  // Initialize work and output fields.
• Error Message ID (DTAI) = " "
• If Update Master File (EV01) <> '1' And <> '0' Then
• Update Master File (EV01) = '0'
• End IF
• //
• If Action Code (ACTN) = 'I' Then
• Fetch Record from F31171 using UKID. Return data to I/O Parameters.
• If Failed Then Set Error 017F, Error Message ID (DTAI) = "017F"
• End If
• 
• If Update Master File (EV01) = '1' And Error Message ID (DTAI) = " " And Action Code <> 'I' Then
• If Action Code (ACTN) = 'A' Then
•  Call B9800100 to retrieve USER, JOBN, UPMJ, TDAY
•  Add Record to F31171 using all I/O Parameters.
•  If Failed Then Set Error 026P, Error Message ID (DTAI) = "026P"
• Else If Action Code (ACTN) = 'C' Then
•  Call B9800100 to retrieve USER, JOBN, UPMJ, TDAY
•  Update Record to F31172 using all I/O Parameters and UKID as Key.
•  If Failed Then Set Error 026N, Error Message ID (DTAI) = "026N"
• Else If Action Code (ACTN) = 'D' Then
•  Delete Record from F31172 using UKID as Key.
•  If Failed Then Set Error 026O, Error Message ID (DTAI) = "026O"
• End If
• End If



Data Structure

D1700400 - F31171 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.

mnUniqueKeyIDUKIDMATH_NUMERICOPTNONE

This field is a unique number used to identify a record in a file.

mnEstimatedUnitCostESUNCMATH_NUMERICOPTNONE

Estimated unit cost associated with a transaction.

mnEstimatedUnitBillableESUNBMATH_NUMERICOPTNONE

The estimated unit cost for billing.

mnEstimatedUnitPayableESUNPMATH_NUMERICOPTNONE

The estimated unit cost of the payable.

mnEstimatedPaymentAmountEPAAPMATH_NUMERICOPTNONE

This is the estimated payment amount used in service billing.

mnAmountOriginalDollarsAMTOMATH_NUMERICOPTNONE

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

mnEstimatedAmountEBILLMATH_NUMERICOPTNONE

mnActualUnitCostACUNCMATH_NUMERICOPTNONE

The actual unit cost associated with a transaction.

mnActualUnitBillableACUNBMATH_NUMERICOPTNONE

The actual unit billable amount.

mnActualUnitPayableACUNPMATH_NUMERICOPTNONE

The actual unit payable amount.

mnActualDollarsAMTAMATH_NUMERICOPTNONE

The actual dollars accumulated for the work order.

mnTotalBilledTOTBMATH_NUMERICOPTNONE

The total amount billed through this application number.

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.

mnClaimAmountCLAMTMATH_NUMERICOPTNONE

The amount requested for providing a service.

mnPrimaryLastSupplierVENDMATH_NUMERICOPTNONE

The address book number of the preferred provider of this item.

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.

jdPaidDateDTPAYJDEDATEOPTNONE

The date a service provider was paid for a service.

jdBillDateDTBILJDEDATEOPTNONE

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

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.

szNonCoveredGLCategoryGLCNCcharOPTNONE

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.

szCoveredGLCategoryGLCCVcharOPTNONE

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.

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

szReference02VR02charOPTNONE

A field available to record reference numbers, such as the supplier's bid document number, quote document, sales order, work order, or 
job number.

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.

szProductModelPRODMcharOPTNONE

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

szProductFamilyPRODFcharOPTNONE

A code that classifies an inventory item into a group 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.

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

mnForeignActualBillAmountFTOTBMATH_NUMERICOPTNONE

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

mnForeignActBillableUnitFACUNBMATH_NUMERICOPTNONE

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

mnForeignEstBillableAmountFEBILLMATH_NUMERICOPTNONE

The estimated billable amount in the currency of the customer.

mnForeignEstBillableUnitFESUNBMATH_NUMERICOPTNONE

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

mnForeignActualPayAmountFPAAPMATH_NUMERICOPTNONE

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

mnForeignActualPayUnitFACUNPMATH_NUMERICOPTNONE

The actual 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.

mnForeignEstPayUnitFESUNPMATH_NUMERICOPTNONE

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

szCausalCostCenterMCUCSLcharOPTNONE

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

cTaxableYNTAX1charOPTNONE

A code that indicates whether the item is subject to sales tax when you sell it. The system calculates tax on the item only if the customer is 
also taxable.

mnCausalPartCSLPRTMATH_NUMERICOPTNONE

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

mnTimeSubmittedTMSUBMATH_NUMERICOPTNONE

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

jdDateSubmittedDTSUBJDEDATEOPTNONE

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

cReturnPolicyRETPOLcharOPTNONE

A user defined code (17/RT) that specifies whether to return the part with the claim.

szFailureCodeFAILCDcharOPTNONE

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

szCompCdGrpSys_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.

szCompCdSysAsbly_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.

szCompCdSysAsblyPart_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.

Related Functions

None

Related Tables

None