F1207UpdateRow

F1207 Update Row

Major Business Rule

Object Name: B1200080

Parent DLL: CAEC

Location: Client/Server

Language: C

Purpose
This function will be used to update a row in the Maintenance Schedule table (F1207) by the user input index/key combination.

Setup Notes and Prerequisites

The following are the allowed index/key combinations.  Partial keys may be used.
1 = NUMB, SRVT, CPLD

2 = WONA

3 = APID, MSTS, SRVT, CPLD

4 = NUMB, MSTS, SRVT, CPLD

^

Data Structure

D1200080 - F1207 Update Row

Parameter NameData ItemData TypeReq/OptI/O/Both
mnAssetItemNumberNUMBMATH_NUMERICOPTINPUT

An 8-digit number that uniquely identifies an asset.

szServiceTypeSRVTcharOPTINPUT

A user defined code (12/ST) that describes the preventive maintenance service to be performed. Examples of codes include CLUTCH for 
adjust clutch, OIL for change oil, and 10H for 10 hour service.

jdCompletedDateCPLDJDEDATEOPTINPUT

This is the actual date that the maintenance was completed.

mnWorkOrderNoAssignedWONAMATH_NUMERICOPTINPUT

The Work Order Number related to a particular Equipment Maintenance line item. The system assigns this number from next numbers.

szUnitNumberAPIDcharOPTINPUT

A 12-character alphanumeric code used as an alternate identification number for an asset. This number is not required, nor does the 
system assign a number if you leave the field blank when you add an asset. If you use this number, it must be unique. For equipment, this is 
typically the serial number.

szMaintenanceStatusMSTScharOPTINPUT

A user defined code (12/MS) that indicates the maintenance status of a piece of equipment, such as 50 for maintenance due or 60 for 
waiting for parts. Note: Status code 98 is reserved for cancelled maintenance. Status code 99 is reserved for completed maintenance. Status code 
01 (default) is reserved for initial maintenance setup.

szSerialNumberASIDcharOPTINPUT

A 25-character alphanumeric number that you can use as an alternate asset identification number. You might use this number to track 
assets by the manufacturer's serial number. You are not required to use a serial number to identify an asset. Every serial number that you enter 
must be unique.

cMaintenancePriorityMPRIcharOPTINPUT

This field is used to indicate the relative priority that this maintenance has in relation to all other maintenance.

szUserDefinedCodeKYcharOPTINPUT

A list of valid codes for a specific user defined code list.

mnAssignedToAddressNumberANPMATH_NUMERICOPTINPUT

The address book number of the person assigned to do the work.

szRemarkRMKcharOPTINPUT

A generic field that you use for a remark, description, name, or address.

mnServiceDaysSRVDMATH_NUMERICOPTINPUT

The number of days to elapse before you schedule maintenance.

mnServiceFuelSRVHMATH_NUMERICOPTINPUT

The amount of fuel to be consumed before you schedule maintenance. To determine if maintenance is due, the Update PM Schedule 
Status program (R12807) uses this quantity and the threshold percent from the Maintenance Rules table (F1393). For example, it calculates the 
total fuel as the service fuel plus the fuel consumed as of the last date you performed a maintenance. It then compares this quantity to the actual 
fuel consumed from the AA ledger for the FMA automatic accounting instruction to determine if maintenance is due. Note: You can define 
other statistical units appropriate to your organization within the FMA automatic accounting instructions.

jdScheduleDateTDTJDEDATEOPTINPUT

The date that you want to receive a reminder message about an asset.

mnCompletedMilesCPLMMATH_NUMERICOPTINPUT

Actual miles at completion of maintenance.

mnConsumedFuelCPLHMATH_NUMERICOPTINPUT

Actual quantity of fuel consumed at completion of maintenance.

mnLastCompletedMilesLSTMMATH_NUMERICOPTINPUT

Number of miles at last maintenance.

mnLastCompletedFuelConsumedLSTHMATH_NUMERICOPTINPUT

Fuel consumed at last maintenance.

mnOrderNumberDOCOMATH_NUMERICOPTINPUT

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.

mnPercentDueMPCMATH_NUMERICOPTINPUT

A percentage measure that indicates how close a piece of equipment is to requiring maintenance. This percentage is based on the greater 
of the actual date, miles, hours, or fuel consumption compared to the threshold date, miles,hours, or fuel consumption. A percentage of 090 
means that the piece of equipment is 10% away from requiring maintenance. A percentage greater than 100 means that maintenance is past 
due.

mnServiceHoursSRVFMATH_NUMERICOPTINPUT

The hours to be expended before you schedule maintenance. To determine if maintenance is due, the Update PM Schedule Status 
program uses this quantity and the threshold percent from the maintenance rules table. It calculates the total hours as the service hours plus the 
hours run as of the last date you performed a maintenance. It then compares this amount to the actual hours from the AA ledger for the AT00 
automatic accounting instruction to determine if maintenance is due. NOTE: Hours is only an example of a statistical unit. You can define other 
statistical units appropriate to your organization within the AT00 automatic accounting instructions.

mnCompletedHoursCPLFMATH_NUMERICOPTINPUT

Actual hours at completion of maintenance.

mnLastCompletedHoursLSTFMATH_NUMERICOPTINPUT

Number of hours at last maintenance.

cMultipleWOMLTWcharOPTINPUT

This code determines whether maintenance service types can be rescheduled and can come due again before the maintenance task for 
the originally scheduled service type has been completed. Valid vlaues are:    Blank One Cycle (default). Maintenance is not rescheduled 
until the original maintenance task has been completed.    1       Multiple Cycle with Multiple Work Orders. When the service type has come due, 
it is automatically rescheduled to come due again regardless if the original maintenance is completed. Multiple work orders can accrue.    2   
    Multiple Cycle. When the service type has come due, it is automatically rescheduled to come due again regardless if the original 
maintenance is completed. Only one work order can accrue.    3       Maintenance Loop. The Update PM Schedule program assigns the Maintenance 
Loop code to PM schedules generated through maintenance loops. These PM schedules are not repeated in the PM cycle. Maintenance 
tasks for all equipment indicated in the maintenance loop are performed under a single work order.    4       Warranty. A code that indicates that 
the equipment is under warranty. The system provides a warning on the Work Order Inventory Issues form and the Purchase Request form 
(when accessed from the Work Order Parts List).            When a PM that includes warranty service types is completed, the system includes the 
warranty service in the PM history record, but does not reschedule the warranty service types.

mnOriginalMilesORGMMATH_NUMERICOPTINPUT

The balance for the statistical account which tracks the original miles meter reading.

mnOriginalFuelORGFMATH_NUMERICOPTINPUT

The balance for the statistical account which tracks the original fuel meter reading.

mnOccurencesOCCUMATH_NUMERICOPTINPUT

The estimated number of occurrences per year for the service type. The PM Projections program uses information from this field, in 
combination with the last completed date, to project future schedule requirements. You can use processing options to automatically calculate the 
estimated occurrences, based on one of the following:     o One year of PM history     o Two years of PM history     o Inception-to-date PM history 

cFrequencyIndicatorFRINcharOPTINPUT

When used in conjunction with Schedule Date, this field indicates the frequency at which the system schedules maintenance. When 
maintenance is completed, the system automatically schedules the next maintenance according to the value that you enter in this field. Valid values 
are:    blank No frequency indicator    1       Same date each month    2       Last date each month    3       Same date each quarter    4       Same 
date each year    5       Same day each week    6       Semi-annually (same date at six month intervals)

szBusinessUnitMCUcharOPTINPUT

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.

mnParentNumberAAIDMATH_NUMERICOPTINPUT

A parent number groups related components together. You can associate each item of property and piece of equipment with a parent item. 
For example, you can associate a mobile telephone with a specific automobile (the parent), a printer with a computer (the parent), or a flat 
bed with a specific truck chassis (the parent). Note: If this is a data entry field, the default value is the asset number. For example, if the asset 
number is 123, the system assigns 123 as the default parent number.

mnCriticalityCRTLMATH_NUMERICOPTINPUT

A code that indicates the criticality of the piece of equipment or PM schedule. This code is used in calculating the criticality of the work 
order.

jdPlannedStartDatePNSTJDEDATEOPTINPUT

The date when the item or line of work is to start.

szPMCategoryCode1PMC1charOPTINPUT

A User Defined Code (system 13, code P1) used to classify PM schedules.

szPMCategoryCode2PMC2charOPTINPUT

A User Defined Code (system 13, code P2) used to classify PM schedules.

mnDowntimeRequiredDNHRMATH_NUMERICOPTINPUT

This is the estimated duration of downtime for the piece of equipment in order to do the maintenance.

cPredictiveFlagPDFLcharOPTINPUT

A code that indicates the functional status of a piece of equipment, as assessed by a condition-based maintenance system. For 
maintenance schedules that are condition-based, the preventive maintenance system uses this code to determine whether maintenance is due. Enter 
a valid value from UDC table 13/AL (Alert Level).

nIndexINT01integerOPTINPUT

Number of Days in Future to Query for Responses Due. 

nKeysINT02integerOPTINPUT

Number of Days in the Past to Query for Quote Requests Received. 

cSuppressErrorMessagesEV01charOPTINPUT

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.

mnOriginalHoursORGHMATH_NUMERICOPTINPUT

The balance for the statistical account which tracks the original hours meter reading.

jdLastCompletedDateLCPDJDEDATEOPTINPUT

Date of last maintenance.

mnServiceMilesSRVMMATH_NUMERICOPTINPUT

The number of miles to be expended before you schedule maintenance. To determine if maintenance is due, the Update PM Schedule 
Status program (R12807) uses this quantity and the threshold percent from the Maintenance Rules table (F1393). For example, it calculates the 
total miles as the service miles plus the miles operated as of the last date you performed maintenance. It then compares this amount to the 
actual miles from the AA ledger for the FMB automatic accounting instructions to determine if maintenance is due. Note: You can define other 
statistical units appropriate to your organization within the FMB automatic accounting instructions.

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.

mnUniqueKeyIDInternalUKIDMATH_NUMERICOPTINPUT

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

Related Functions

None

Related Tables

F1207 Maintenance Schedule File