F4801AddChangeRateEdits

F4801 Add, Change, Delete Rate

Minor Business Rule

Object Name: XT310911

Parent DLL: CMFGBASE

Location: Client/Server

Language: NER

Functional Description

Purpose

To perform all editing for row is exited and changed logic

- Retrieves P3109 Processing Options

- Validates the Start and Requested Date

- Sets Rate Type, Begin Status and UOM to Proc Option value if blank

- Calls X4801 to perform all header editing


Setup Notes and Prerequisites

Data Structure DescriptionI/ORequiredNotes

cProcessEditsIN'0' - No Edits 

'1' - Full Edits (Default) 

'2' - Partial Edits

cSuppressErrorMessagesIN1 - Error Messages Suppressed

cErrorCodeON'0' = No Errors 

'1`'= Warnings 

'2' = Error

szErrorMessageIDONDD ID number to error Code

szProgramIDINCalling Program Name 

szVersionINPO Version for the Program specified 

in szPIDForProcOptRetrieval 

mnDocumentNumberIYRequired Input if in Update Mode

szOrderTypeIN

mnShortItemNumberIYOutput only for Change Rate

mnRateQtyIY

szUnitOfMeasureINIf blank, item relationship UOM used on an add

szBranchPlantIYOutput only for Change Rate

szLineCellNumberIN

cShiftCodeIY

jdScheduledStartDateIN

cPeriodIN

jdRequestedDateIN

szRoutingTypeIN

szBOMTypeIN

cStatusCodeIN

cAttachPLRtgINNot Used in Edit Call

szItemNoUnknownFormatIYValidated in Add/Change/Edit

cCreateChangeF4801INNot Used in Edit Call

szCatCode1IN

szCatCode2IN

szCatCode3IN

mnX4801WFLineNumberIYUsed to edit the same order number multiple times

Will return the line number in the 1st call for each 

Order Number

cX4801RecordWrittenToCacheIYSame as mnX4801WLineNumber

mnX4801JobNumberIYSame as mnX4801WLineNumber

cActionCodeI'1' = Add Mode

'2' = Update Mode

szPIDForProcOptRetrievalINCurrently, only P3109 or EP3109 is valid value.

If this is left blank, no processing 

options are retrieved.


Special Logic

Used on Row is Exited and Changed


Technical Specification

PO = Processing Option

If input szPIDForProcOptRetrieval = P3109 or EP3109

Call B3101870 - Get P3109 Processing Options

End If

If input jdScheduleStartDate is NULL

Set jdScheduleStartDate = System Date

End If

If input jdRequestedDate is NULL

Set jdRequestedDate = jdScheduleStartDate + PO NumberOfDays

End If

If input szOrderType, szStatusCode or szUOM are blank

Set to related PO value

End If

Call X4101 - F4101 Get Item Master Row to validate the input szItemNoUnknownFormat

If successful

Call B4000920 - F4102 Get Item MFG Info to validate the Item Number in the Item/Branch table

End If

If successful

Call X4801 with Process Module = RMFG (Repetitive MFG) to validate the Item Number has a valid 

Item Relationship record

End If

Call B3101640 - Create Spread Dates in Cache to validate that a shop floor calendar exists




Data Structure

DX310911A - F4801 Add/Change Rate

Parameter NameData ItemData TypeReq/OptI/O/Both
cProcessEditsEV01charOPTNONE

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

cSuppressErrorMessagesEV02charOPTNONE

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

cErrorCodeERRCcharOPTNONE

This error code indicates if any errors occurred during the creation of the Trip Document Detail (F4914) records by the Delivery Document 
Set Server program (XT4914).

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.

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.

szVersionVERScharOPTNONE

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.

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

szOrderTypeDCTOcharOPTNONE

A user defined code (00/DT) that identifies the type of document. This code also indicates the origin of the transaction. J.D. Edwards has 
reserved document type codes for vouchers, invoices, receipts, and time sheets, which create automatic offset entries during the post 
program. (These entries are not self-balancing when you originally enter them.) The following document types are defined by J.D. Edwards and 
should not be changed: P Accounts Payable documents   R Accounts Receivable documents   T Payroll documents   I Inventory documents  
O Purchase Order Processing documents   J General Accounting/Joint Interest Billing documents   S Sales Order Processing documents

mnShortItemNumberITMMATH_NUMERICOPTNONE

An inventory item number. The system provides three separate item numbers plus an extensive cross-reference capability to other item 
numbers (see data item XRT) to accommodate substitute item numbers, replacements, bar codes, customer numbers, supplier numbers, and 
so forth. The item numbers are as follows:   o Item Number (short) - An eight-digit, computer-assigned item number     o 2nd Item Number - The 
25-digit, free-form, user defined alphanumeric item number     o 3rd Item Number - Another 25-digit, free-form, user defined alphanumeric item 
number

mnRateQtyUORGMATH_NUMERICOPTNONE

The quantity of units affected by this transaction.

szUnitOfMeasureUOMcharOPTNONE

A user defined code (00/UM) that indicates the quantity in which to express an inventory item, for example, CS (case) or BX (box).

szBranchPlantMMCUcharOPTNONE

A code that represents a high-level business unit. Use this code to refer to a branch or plant that might have departments or jobs, which 
represent lower-level business units, subordinate to it. For example:     o Branch/Plant (MMCU)     o Dept A (MCU)     o Dept B (MCU)     o Job 123 
(MCU) Business unit security is based on the higher-level business unit.

szLineCellNumberLINEcharOPTNONE

A number that defines a production line or cell. Detailed work center operations can be defined inside the line or cell.

cShiftCodeSHFTcharOPTNONE

A user defined code (00/SH) that identifies daily work shifts. In payroll systems, you can use a shift code to add a percentage or amount to 
the hourly rate on a timecard. For payroll and time entry: If an employee always works a shift for which a shift rate differential is applicable, 
enter that shift code on the employee's master record. When you enter the shift on the employee's master record, you do not need to enter the 
code on the timecard when you enter time. If an employee occasionally works a different shift, you enter the shift code on each applicable 
timecard to override the default value.

jdScheduledStartDateSESDJDEDATEOPTNONE

The calendar date that an operation or rate is scheduled to begin.

cPeriodMWDHcharOPTNONE

A code that determines the frequency of the schedule. Valid values are:    1   Monthly    2   Weekly    3   Daily    4   Per Shift (for future use)

jdRequestedDateDRQJJDEDATEOPTNONE

The date that an item is scheduled to arrive or that an action is scheduled for completion.

szTypeRoutingTRTcharOPTNONE

A user defined code (40/TR) that indicates the type of routing. You can define different types of routing instructions for different uses. For 
example:    M    Standard Manufacturing Routing    RWK  Rework Routing    RSH  Rush Routing You define the routing type on the work order 
header. The system then uses the specific type of routing that you define in the work order routing. Product Costing and Capacity Planning systems 
use only M type routings.

szTypeBillTBMcharOPTNONE

A user defined code (40/TB) that designates the type of bill of material. You can define different types of bills of material for different uses. 
For example:    M     Standard manufacturing bill    RWK   Rework bill    SPR   Spare parts bill  The system enters bill type M in the work order 
header when you create a work order, unless you specify another bill type. The system reads the bill type code on the work order header to 
know which bill of material to use to create the work order parts list. MRP uses the bill type code to identify the bill of material to use when it 
attaches MRP messages. Batch bills of material must be type M for shop floor management, product costing, and MRP processing.

szStatusCodeSRSTcharOPTNONE

A user defined code (00/SS) that describes the status of a work order, rate schedule, or engineering change order. Any status change from 
90 through 99  triggers the system to automatically update the completion date.

cAttachPLRtgEV01charOPTNONE

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

szItemNoUnknownFormatUITMcharOPTNONE

A number that the system assigns to an item. It can be in short, long, or third item number format.

cCreateChangeF4801EV03charOPTNONE

A radio button that specifies the level at which trace/track result is to be displayed.  Select the Detail to display all transactions except IB, IX, 
and IZ types.  Or, select Derivative Lots Only to display only those transactions that may have created new derivative lot. 

szCatCode1WR01charOPTNONE

A user defined code (00/W1) that indicates the current stage or phase of development for a work order. You can assign a work order to only 
one phase code at a time. Note: Certain forms contain a processing option that allows you to enter a default value for this field. If you enter a 
default value on a form for which you have set this processing option, the system displays the value in the appropriate fields on any work 
orders that you create. The system also displays the value on the Project Setup form. You can either accept or override the default value.

szCatCode2WR02charOPTNONE

A user defined code (00/W2) that indicates the type or category of a work order. Note: A processing option for some forms lets you enter a 
default value for this field. The system enters the default value automatically in the appropriate fields on any work orders that you create on 
those forms and on the Project Setup form. You can either accept or override the default value.

szCatCode3WR03charOPTNONE

A user defined code (00/W3) that indicates the type or category of the work order. Note: A processing option for some forms allows you to 
enter a default value for this field. The system enters the default value automatically in the appropriate fields on any work orders that you 
create on those forms and on the Project Setup form. You can either accept or override the default value.

mnX4801WFLineNumberLNIDMATH_NUMERICOPTNONE

A number that identifies multiple occurrences, such as line numbers on a purchase order or other document. Generally, the system assigns 
this number,but in some cases you can override it.

cX4801RecordWrittenToCacheEV04charOPTNONE

PeopleSoft event point processing flag 04.

mnX4801JobNumberJOBSMATH_NUMERICOPTNONE

The job number (work station ID) which executed the particular job.

cActionCodeACTNcharOPTNONE

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

szPIDForProcOptRetrievalPIDcharOPTNONE

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.

szStatusCommentWO_STCMSTCMcharOPTNONE

A brief description to explain the status of the work order.

cWoOrderFreezeCode_UNCDUNCDcharOPTNONE

A code that indicates if the line on the order is frozen. MPS/MRP does not suggest changes to frozen orders.  Valid values are: Y Yes, freeze 
the order. N No, do not freeze the order. This value is the default.

szCatCode004_WR04WR04charOPTNONE

A user defined code (00/W4) that indicates the type or category of the work order.

szCatCode005_WR05WR05charOPTNONE

A user defined code (00/W5) that indicates the type or category of the work order.

szCatCode006_WR06WR06charOPTNONE

A user defined code (00/W6) that indicates the status of the work order.

szCatCode007_WR07WR07charOPTNONE

A user defined code (00/W7) that indicates the service type for the work order.

szCatCode008_WR08WR08charOPTNONE

A user defined code (00/W8) that indicates the type or category of the work order.

szCatCode009_WR09WR09charOPTNONE

A user defined code (00/W9) that indicates the type or category of the work order.

szCatCode010_WR10WR10charOPTNONE

A user defined code (00/W0) that indicates the type or category of the work order.

mnCustomer_AN8AN8MATH_NUMERICOPTNONE

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

mnSupervisor_ANPAANPAMATH_NUMERICOPTNONE

The address book number of the supervisor.

mnManager_ANSAANSAMATH_NUMERICOPTNONE

The address book number of a manager or planner.   Note:  A processing option for some forms allows you to enter a default value for this 
field based on values for category codes 1 (Phase), 2, and 3.  You set up the default values on the Default Managers and Supervisors form.  
After you set up the default values and the processing option, the default information displays automatically on any work orders that you 
create if the category code criterion is met.  You can either accept or override the default value. 

szLot_LOTNLOTNcharOPTNONE

A number that identifies a lot or a serial number. A lot is a group of items with similar characteristics.

szParentWoNumber_PARSPARScharOPTNONE

A number that identifies the parent work order. You can use this number to do the following:     o Enter default values for new work orders, 
such as Type, Priority, Status, and Manager     o Group work orders for project setup and reporting  

cPriorityWO_PRTSPRTScharOPTNONE

A user defined code (00/PR) that indicates the relative priority of a work order or engineering change order in relation to other orders. A 
processing option for some forms lets you enter a default value for this field. The value then displays automatically in the appropriate fields on 
any work order you create on those forms and on the Project Setup form. You can either accept or override the default value.

szSubsidiary_SUBSUBcharOPTNONE

A subset of an object account. Subsidiary accounts include detailed records of the accounting activity for an object account.

szBillRevisionLevel_BREVBREVcharOPTNONE

A value that indicates the revision level of a bill of material. It is usually used in conjunction with an engineering change notice or 
engineering change order. The revision level of the bill of material should match the revision level of its associated routing, although the system does 
not check this. This value is defined and maintained by the user.

szBusinessUnit_MCUMCUcharOPTNONE

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.

szRelatedOrderNumber_RORNRORNcharOPTNONE

A number that identifies a secondary purchase order, sales order, or work order that is associated with the original order. This number is for 
informational purposes only.

szRelatedOrderType_RCTORCTOcharOPTNONE

A user defined code (system 00, type DT) that indicates the document type of the secondary or related order. For example, a purchase 
order might be document type OP and might have been created to fill a related work order with document type WO.

szCompanyKeyRelated_RKCORKCOcharOPTNONE

The key company that is associated with the document number of the related order.

cTypeWO_TYPSTYPScharOPTNONE

A user defined code (00/TY) that indicates the classification of a work order or engineering change order. You can use work order type as a 
selection criterion for work order approvals.

szReference1_VR01VR01charOPTNONE

An alphanumeric value used as a cross-reference or secondary reference number. Typically, this is the customer number, supplier 
number, or job number.

szMessageNo_SHNOSHNOcharOPTNONE

A generic rates and message code (48/SN) that is assigned to a standard note, message, or general narrative explanation. You can use 
this code to add instructional information to a work order. You set up codes for this field on the Generic Message/Rate Types table (F00191).

cWoFlashMessage_SPRTSPRTcharOPTNONE

A user defined code (00/WM) that indicates a change in the status of a work order. The system indicates a changed work order with an 
asterisk in the appropriate report or inquiry form field. The system highlights the flash message in the Description field of the work order.

mnSecondaryQtyOrderedSQORMATH_NUMERICOPTNONE

If the secondary unit of measure option in Inventory Constants is selected,this field will display on data entry screens.

szSecondaryUnitOfMeasureUOM2charOPTNONE

A user defined code (00/UM) that indicates an alternate unit of measure for the item.

Related Functions

None

Related Tables

None
F4801AddRate

F4801AddRate

F4801 Add, Change, Delete Rate

Minor Business Rule

Object Name: XT310911

Parent DLL: CMFGBASE

Location: Client/Server

Language: NER

Functional Description
Create a rate and its related records.


Purpose

• Validate Item Number
• Retrieve F3109 (Item Relationship) Record
• Perform Edits 
• Calculate Spread for F31091 records
• Create F4801 record
• Create record in F4801 tag file (will be eliminated in B8)
• Create Routing
• Create Parts List
• Create F31091 records

Setup Notes and Prerequisites

F4801 Add or Change Rate Edits should be called prior to this function for error handling


Data Structure DescriptionI/ORequiredNotes

cProcessEditsIN'0' - No Edits 

'1' - Full Edits (Default) 

'2' - Partial Edits

cSuppressErrorMessagesIN1 - Error Messages Suppressed

cErrorCodeON'0' = No Errors 

'1`'= Warnings 

'2' = Error

szErrorMessageIDONDD ID number to error Code

szProgramIDINCalling Program Name 

szVersionINPO Version for the Program specified 

in szPIDForProcOptRetrieval 

mnDocumentNumberIYF4801 Order Number

szOrderTypeIN

mnShortItemNumberIY

mnRateQtyIY

szUnitOfMeasureINIf blank, item relationship UOM used on an add

szBranchPlantIY

szLineCellNumberIN

cShiftCodeIY

jdScheduledStartDateIN

cPeriodIN

jdRequestedDateIN

szRoutingTypeIN

szBOMTypeIN

cStatusCodeIN

cAttachPLRtgINUsed to override P3109 PO for use in P48013

szItemNoUnknownFormatIYValidated in Add/Change/Edit

cCreateChangeF4801INUsed to override creation of Order Number in

P48013.  Set to 1 if creating a Rate and not a 

Work Order with a line specified.

szCatCode1IN

szCatCode2IN

szCatCode3IN

mnX4801WFLineNumberIYRequired if Add/Change Rate Edits was called

This value was returned in Add/Change Rate Edits

cX4801RecordWrittenToCacheIYSame as mnX4801WLineNumber

mnX4801JobNumberIYSame as mnX4801WLineNumber

cActionCodeI'1' = Add 

szPIDForProcOptRetrievalINCurrently, only P3109 or EP3109 is valid value.

If this is left blank, no processing 

options are retrieved.


Special Logic

Used in Add record to DB before


Technical Specification

If input Item Number is not blank

Validate Item Number

If successful

Retrieve Item Branch

End If

If Item Number is not valid in the F4101 and F4102

Return Error

Else

If input Line Number LINE or M/W/D Code MWDH or Shift SHFT is blank

Retrieve F3109 (Item Relationship) record by Item # and Branch/Plant

End If

If successful

/*************** Set Up *************************/

/* NEW Business Function - Write spread dates to Edit Date Cache */
Call Edit Dates Business Function


/* Call X4801to create work order */

Call X4801 Begin Doc
Call X4801 Edit Line

Input: Document Number, Document Type, Branch/Plant, WO Status, Order Date, 

           Start Date, Order Qty, UOM, Bill Type, Routing Type, Line Number, 

           M/W/D Code, Category Codes 1-3
Call X4801 End Doc to write record from cache to F4801

Call B3101XXX to create Tag File record

Input: Document Number, Line Number, M/W/D Code

If F4801 record was written successfully

/*************** Create F31091 records ****************/
/* Load User input to F31091 Data Structure */

Load the following fields from User Input.  
If the user input field is blank use the 

F3109 value: LINE, MWDH, SHFT

If input UOM is blank

Retrieve F3109 (Item Relationship) record by Item #, Branch/Plant, Line #
DS UOM = F3109 IPUOM

Else

DS UOM = input UOM
End If

If input Schedule Start Date is not blank

DS SESD = input Schedule Start Date
End If
If input Requested Date is not blank
DS DRQJ = input Requested Date

End If

/* Copy F4801 returned fields to the F31091 data structure */

Copy Document Number, Document Type, Branch/Plant, Item Number, 

2nd Item Number, 3rd Item Number, Category Codes 1-3

/* Set OPSQ to all 9s to indicate that record has not been sequenced */

DS OPSQ = 99999


/* Calculate Planned Qty for rates and Work Orders */

If the input M/W/D Code is not blank

/* Calculate the Planned Qty */
Work Qty Ordered  = input Qty Ordered / Number of Cache Records

Round (Work Qty Ordered)

DS PLQT = Work Qty Ordered


/* Calculate the Last Records Qty. 

     This record adjusts the qty because of rounding */
Work Number = Number of Cache Records - 1
Work Qty = Work Qty Ordered * Work Number

Work Last Qty Ordered = Input Qty Ordered - Work Qty

Else

/* This is a Work Order with Line specified 

      Create F31091 records but only the last record contains

     the Order Qty.  All other dates have blank Quantities */
DS PLQT = 0

Work Last Qty Ordered = Input Qty Ordered

End If


/*** Loop through all dates and create F31091 records ***/
Counter =1

Fetch 1st record from the Date Cache (See Edit Date Business Function specs)

While Fetch from Edit Date Cache is successful

If Counter = Number of Cache Records (Last Record)

DS PLQT = Work Last Qty Ordered

End If

DS SESD = Cache Date

Call X31091 to add record
++ Counter

Fetch Next Cache Record

End If


/* Create Routing */

Call B3101250 Begin Doc

Call B3101250 Edit Doc in Copy by Item mode

Call B3101250 End Doc


/* Create Parts List */

Call B3101260 Begin Doc

Call B3101260 Edit Doc in Copy BOM mode

Call B3101260 End Doc


End if F4801 record was created

End if Item/Line Relationship record was retrieved

End if Item Number was valid




Data Structure

DX310911A - F4801 Add/Change Rate

Parameter NameData ItemData TypeReq/OptI/O/Both
cProcessEditsEV01charOPTNONE

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

cSuppressErrorMessagesEV02charOPTNONE

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

cErrorCodeERRCcharOPTNONE

This error code indicates if any errors occurred during the creation of the Trip Document Detail (F4914) records by the Delivery Document 
Set Server program (XT4914).

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.

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.

szVersionVERScharOPTNONE

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.

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

szOrderTypeDCTOcharOPTNONE

A user defined code (00/DT) that identifies the type of document. This code also indicates the origin of the transaction. J.D. Edwards has 
reserved document type codes for vouchers, invoices, receipts, and time sheets, which create automatic offset entries during the post 
program. (These entries are not self-balancing when you originally enter them.) The following document types are defined by J.D. Edwards and 
should not be changed: P Accounts Payable documents   R Accounts Receivable documents   T Payroll documents   I Inventory documents  
O Purchase Order Processing documents   J General Accounting/Joint Interest Billing documents   S Sales Order Processing documents

mnShortItemNumberITMMATH_NUMERICOPTNONE

An inventory item number. The system provides three separate item numbers plus an extensive cross-reference capability to other item 
numbers (see data item XRT) to accommodate substitute item numbers, replacements, bar codes, customer numbers, supplier numbers, and 
so forth. The item numbers are as follows:   o Item Number (short) - An eight-digit, computer-assigned item number     o 2nd Item Number - The 
25-digit, free-form, user defined alphanumeric item number     o 3rd Item Number - Another 25-digit, free-form, user defined alphanumeric item 
number

mnRateQtyUORGMATH_NUMERICOPTNONE

The quantity of units affected by this transaction.

szUnitOfMeasureUOMcharOPTNONE

A user defined code (00/UM) that indicates the quantity in which to express an inventory item, for example, CS (case) or BX (box).

szBranchPlantMMCUcharOPTNONE

A code that represents a high-level business unit. Use this code to refer to a branch or plant that might have departments or jobs, which 
represent lower-level business units, subordinate to it. For example:     o Branch/Plant (MMCU)     o Dept A (MCU)     o Dept B (MCU)     o Job 123 
(MCU) Business unit security is based on the higher-level business unit.

szLineCellNumberLINEcharOPTNONE

A number that defines a production line or cell. Detailed work center operations can be defined inside the line or cell.

cShiftCodeSHFTcharOPTNONE

A user defined code (00/SH) that identifies daily work shifts. In payroll systems, you can use a shift code to add a percentage or amount to 
the hourly rate on a timecard. For payroll and time entry: If an employee always works a shift for which a shift rate differential is applicable, 
enter that shift code on the employee's master record. When you enter the shift on the employee's master record, you do not need to enter the 
code on the timecard when you enter time. If an employee occasionally works a different shift, you enter the shift code on each applicable 
timecard to override the default value.

jdScheduledStartDateSESDJDEDATEOPTNONE

The calendar date that an operation or rate is scheduled to begin.

cPeriodMWDHcharOPTNONE

A code that determines the frequency of the schedule. Valid values are:    1   Monthly    2   Weekly    3   Daily    4   Per Shift (for future use)

jdRequestedDateDRQJJDEDATEOPTNONE

The date that an item is scheduled to arrive or that an action is scheduled for completion.

szTypeRoutingTRTcharOPTNONE

A user defined code (40/TR) that indicates the type of routing. You can define different types of routing instructions for different uses. For 
example:    M    Standard Manufacturing Routing    RWK  Rework Routing    RSH  Rush Routing You define the routing type on the work order 
header. The system then uses the specific type of routing that you define in the work order routing. Product Costing and Capacity Planning systems 
use only M type routings.

szTypeBillTBMcharOPTNONE

A user defined code (40/TB) that designates the type of bill of material. You can define different types of bills of material for different uses. 
For example:    M     Standard manufacturing bill    RWK   Rework bill    SPR   Spare parts bill  The system enters bill type M in the work order 
header when you create a work order, unless you specify another bill type. The system reads the bill type code on the work order header to 
know which bill of material to use to create the work order parts list. MRP uses the bill type code to identify the bill of material to use when it 
attaches MRP messages. Batch bills of material must be type M for shop floor management, product costing, and MRP processing.

szStatusCodeSRSTcharOPTNONE

A user defined code (00/SS) that describes the status of a work order, rate schedule, or engineering change order. Any status change from 
90 through 99  triggers the system to automatically update the completion date.

cAttachPLRtgEV01charOPTNONE

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

szItemNoUnknownFormatUITMcharOPTNONE

A number that the system assigns to an item. It can be in short, long, or third item number format.

cCreateChangeF4801EV03charOPTNONE

A radio button that specifies the level at which trace/track result is to be displayed.  Select the Detail to display all transactions except IB, IX, 
and IZ types.  Or, select Derivative Lots Only to display only those transactions that may have created new derivative lot. 

szCatCode1WR01charOPTNONE

A user defined code (00/W1) that indicates the current stage or phase of development for a work order. You can assign a work order to only 
one phase code at a time. Note: Certain forms contain a processing option that allows you to enter a default value for this field. If you enter a 
default value on a form for which you have set this processing option, the system displays the value in the appropriate fields on any work 
orders that you create. The system also displays the value on the Project Setup form. You can either accept or override the default value.

szCatCode2WR02charOPTNONE

A user defined code (00/W2) that indicates the type or category of a work order. Note: A processing option for some forms lets you enter a 
default value for this field. The system enters the default value automatically in the appropriate fields on any work orders that you create on 
those forms and on the Project Setup form. You can either accept or override the default value.

szCatCode3WR03charOPTNONE

A user defined code (00/W3) that indicates the type or category of the work order. Note: A processing option for some forms allows you to 
enter a default value for this field. The system enters the default value automatically in the appropriate fields on any work orders that you 
create on those forms and on the Project Setup form. You can either accept or override the default value.

mnX4801WFLineNumberLNIDMATH_NUMERICOPTNONE

A number that identifies multiple occurrences, such as line numbers on a purchase order or other document. Generally, the system assigns 
this number,but in some cases you can override it.

cX4801RecordWrittenToCacheEV04charOPTNONE

PeopleSoft event point processing flag 04.

mnX4801JobNumberJOBSMATH_NUMERICOPTNONE

The job number (work station ID) which executed the particular job.

cActionCodeACTNcharOPTNONE

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

szPIDForProcOptRetrievalPIDcharOPTNONE

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.

szStatusCommentWO_STCMSTCMcharOPTNONE

A brief description to explain the status of the work order.

cWoOrderFreezeCode_UNCDUNCDcharOPTNONE

A code that indicates if the line on the order is frozen. MPS/MRP does not suggest changes to frozen orders.  Valid values are: Y Yes, freeze 
the order. N No, do not freeze the order. This value is the default.

szCatCode004_WR04WR04charOPTNONE

A user defined code (00/W4) that indicates the type or category of the work order.

szCatCode005_WR05WR05charOPTNONE

A user defined code (00/W5) that indicates the type or category of the work order.

szCatCode006_WR06WR06charOPTNONE

A user defined code (00/W6) that indicates the status of the work order.

szCatCode007_WR07WR07charOPTNONE

A user defined code (00/W7) that indicates the service type for the work order.

szCatCode008_WR08WR08charOPTNONE

A user defined code (00/W8) that indicates the type or category of the work order.

szCatCode009_WR09WR09charOPTNONE

A user defined code (00/W9) that indicates the type or category of the work order.

szCatCode010_WR10WR10charOPTNONE

A user defined code (00/W0) that indicates the type or category of the work order.

mnCustomer_AN8AN8MATH_NUMERICOPTNONE

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

mnSupervisor_ANPAANPAMATH_NUMERICOPTNONE

The address book number of the supervisor.

mnManager_ANSAANSAMATH_NUMERICOPTNONE

The address book number of a manager or planner.   Note:  A processing option for some forms allows you to enter a default value for this 
field based on values for category codes 1 (Phase), 2, and 3.  You set up the default values on the Default Managers and Supervisors form.  
After you set up the default values and the processing option, the default information displays automatically on any work orders that you 
create if the category code criterion is met.  You can either accept or override the default value. 

szLot_LOTNLOTNcharOPTNONE

A number that identifies a lot or a serial number. A lot is a group of items with similar characteristics.

szParentWoNumber_PARSPARScharOPTNONE

A number that identifies the parent work order. You can use this number to do the following:     o Enter default values for new work orders, 
such as Type, Priority, Status, and Manager     o Group work orders for project setup and reporting  

cPriorityWO_PRTSPRTScharOPTNONE

A user defined code (00/PR) that indicates the relative priority of a work order or engineering change order in relation to other orders. A 
processing option for some forms lets you enter a default value for this field. The value then displays automatically in the appropriate fields on 
any work order you create on those forms and on the Project Setup form. You can either accept or override the default value.

szSubsidiary_SUBSUBcharOPTNONE

A subset of an object account. Subsidiary accounts include detailed records of the accounting activity for an object account.

szBillRevisionLevel_BREVBREVcharOPTNONE

A value that indicates the revision level of a bill of material. It is usually used in conjunction with an engineering change notice or 
engineering change order. The revision level of the bill of material should match the revision level of its associated routing, although the system does 
not check this. This value is defined and maintained by the user.

szBusinessUnit_MCUMCUcharOPTNONE

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.

szRelatedOrderNumber_RORNRORNcharOPTNONE

A number that identifies a secondary purchase order, sales order, or work order that is associated with the original order. This number is for 
informational purposes only.

szRelatedOrderType_RCTORCTOcharOPTNONE

A user defined code (system 00, type DT) that indicates the document type of the secondary or related order. For example, a purchase 
order might be document type OP and might have been created to fill a related work order with document type WO.

szCompanyKeyRelated_RKCORKCOcharOPTNONE

The key company that is associated with the document number of the related order.

cTypeWO_TYPSTYPScharOPTNONE

A user defined code (00/TY) that indicates the classification of a work order or engineering change order. You can use work order type as a 
selection criterion for work order approvals.

szReference1_VR01VR01charOPTNONE

An alphanumeric value used as a cross-reference or secondary reference number. Typically, this is the customer number, supplier 
number, or job number.

szMessageNo_SHNOSHNOcharOPTNONE

A generic rates and message code (48/SN) that is assigned to a standard note, message, or general narrative explanation. You can use 
this code to add instructional information to a work order. You set up codes for this field on the Generic Message/Rate Types table (F00191).

cWoFlashMessage_SPRTSPRTcharOPTNONE

A user defined code (00/WM) that indicates a change in the status of a work order. The system indicates a changed work order with an 
asterisk in the appropriate report or inquiry form field. The system highlights the flash message in the Description field of the work order.

mnSecondaryQtyOrderedSQORMATH_NUMERICOPTNONE

If the secondary unit of measure option in Inventory Constants is selected,this field will display on data entry screens.

szSecondaryUnitOfMeasureUOM2charOPTNONE

A user defined code (00/UM) that indicates an alternate unit of measure for the item.

Related Functions

None

Related Tables

None
F4801ChangeRate

F4801ChangeRate

F4801 Add, Change, Delete Rate

Minor Business Rule

Object Name: XT310911

Parent DLL: CMFGBASE

Location: Client/Server

Language: NER

Functional Description
To change a rate and its related records


Purpose

• Retrieve F4801 record
• Perform Data Editing
• Calculate Spread for F31091 records
• Delete current F31091 records
• Update F4801 Rate record
• Re-attach Parts List and Routing
• Create F31091 records
'b7'b7'b7

Setup Notes and Prerequisites

F4801 Add or Change Rate Edits should be called prior to this function for error handling


Data Structure DescriptionI/ORequiredNotes

cProcessEditsIN'0' - No Edits 

'1' - Full Edits (Default) 

'2' - Partial Edits

cSuppressErrorMessagesIN1 - Error Messages Suppressed

cErrorCodeON'0' = No Errors 

'1`'= Warnings 

'2' = Error

szErrorMessageIDONDD ID number to error Code

szProgramIDINCalling Program Name 

szVersionINPO Version for the Program specified 

in szPIDForProcOptRetrieval 

mnDocumentNumberIYRequired Input if in Update Mode

szOrderTypeIN

mnShortItemNumberIYOutput only for Change Rate

mnRateQtyIY

szUnitOfMeasureINIf blank, item relationship UOM used on an add

szBranchPlantIYOutput only for Change Rate

szLineCellNumberIN

cShiftCodeIY

jdScheduledStartDateIN

cPeriodIN

jdRequestedDateIN

szRoutingTypeIN

szBOMTypeIN

cStatusCodeIN

cAttachPLRtgINUsed to override P3109 PO for use in P48013

szItemNoUnknownFormatIYValidated in Add/Change/Edit

cCreateChangeF4801INUsed to override creation of Order Number in

P48013.  Set to 1 if creating a Rate and not a 

Work Order with a line specified.

szCatCode1IN

szCatCode2IN

szCatCode3IN

mnX4801WFLineNumberIYRequired if Add/Change Rate Edits was called

This value was returned in Add/Change Rate Edits

cX4801RecordWrittenToCacheIYSame as mnX4801WLineNumber

mnX4801JobNumberIYSame as mnX4801WLineNumber

cActionCodeI'2' = Update

szPIDForProcOptRetrievalINCurrently, only P3109 or EP3109 is valid value.

If this is left blank, no processing 

options are retrieved.


Special Logic

Called from Update record to DB - before


Technical Specification

If input Document Number is not blank

Call X4801 Begin Doc to initialize

Call X4801 Edit Line to fetch F4801 record

Else

Set error and exit

End if


If Document Number is valid

Get MFG Constants 

/* Check if status is valid to change */

If F4801 SRST < F3009 Status

/*************** Set Up *************************/
/* See what has changed */
If input Scheduled Start is not blank

DS SESD = Input Scheduled Start 

Work Re-Calculate P/L Rtg Flag = 1
Work Re-Spread Flag = 1

End If 

If input Requested Date is not blank

DS DRQJ = Input Requested Date

Work Re-Calculate P/L Rtg Flag = 1

Work Re-Spread Flag = 1

End If

If input Month/Week/Day/Shift Code is not blank

DS MWDH = Input Month/Week/Day/Shift Code

Work Re-Spread Flag = 1

End If

If input Rate Qty is not 0

DS PLQT = Input Rate Qty

Work Re-Calculate P/L Rtg Flag = 1

Work Re-Spread Flag = 1

End If

If input Line Number is not blank

DS LINE = input Line Number

Work Re-Spread Flag = 1

Work Re-Calculate P/L Rtg Flag = 1

End If

If input UOM is not blank

DS UOM = Input UOM

Work Re-Calculate P/L Rtg Flag = 1

End If

If input Document Type in not blank

DS DCTO = Input Document Type

Work Re-Spread Flag = 1

End If

If input Category Code 1 is not blank

DS WR01 = Input Category Code 1

Work Category Code Change Flag =1

End If

If input Category Code 2 is not blank

DS WR01 = Input Category Code 2

Work Category Code Change Flag =1
End If

If input Category Code 3 is not blank

DS WR01 = Input Category Code 3

Work Category Code Change Flag =1

End If

If input Shift SHFT is blank
Retrieve F3109 (Item Relationship) record by F4801 Item # and Branch/Plant

End If


/*************** Re-Spread *************************/

If Work Re-Spread Flag = 1
/* NEW Business Function - Write spread dates to Edit Date Cache */
Call B3101640 Create Spread Dates Business Function


/* Delete all existing F31091 records related to the input Document Number */

Call X31091 in delete mode


/* Calculate Planned Qty for rates and Work Orders */

If the DS MWDH is not blank

/* Calculate the Planned Qty */
Work Qty Ordered  = input Qty Ordered / Number of Cache Records

Round (Work Qty Ordered)

DS PLQT = Work Qty Ordered


/* Calculate the Last Records Qty. 

     This record adjusts the qty because of rounding */
Work Number = Number of Cache Records - 1
Work Qty = Work Qty Ordered * Work Number

Work Last Qty Ordered = Input Qty Ordered - Work Qty

Else

/* This is a Work Order with Line specified 

    Create F31091 records but only the last record contains

   the Order Qty.  All other dates have blank Quantities */
DS PLQT = 0

Work Last Qty Ordered = Input Qty Ordered

End If

/*** Loop through all dates and create new F31091 records ***/

Counter =1
Fetch 1st record from the Date Cache 

(See Edit Date Business Function specs)

While Fetch from Spread Date Cache is successful (Call B3101640)

If Counter = Number of Cache Records (Last Record)

DS PLQT = Work Last Qty Ordered

End If

DS SESD = Cache Date

Call X31091 to add record
++ Counter

Fetch Next Cache Record

End While
/** Re-Spread not necessary - just update the F31091 records *******/

Else 

If the Work Re-Calculate PRtg Flag = 1 or 

  Work Category Code Change Flag = 1

Open F31091 Table

Select Records based on Document Number

While F31091 Fetch is successful

If the fetched UOM does not equal the DS UOM

Call UOM Conversion - B4000520

If the Returned Conversion Factor does not = 1 or 0

DS PLQT = DS PLQT * Conversion Factor

End If

End If

Call X31091 in Update Mode to update the F31091

End While

Close F31091 Table

End If

End If


/****** Update the F4801record  ****************/

If Work Re-Calculate PRtg Flag = 1 or Work Re-Spread Flag = 1 or

    Work Category Code Change Flag =1

Call X4801 Edit Line

WASTRT = DS SESD

WADCTO = DS DCTO

WADRQJ = DS DRQJ

WAUORG = DS PLQT

WAUOM = DS UOM

WAWR01 = DS WR01

WAWR02 = DS WR02

WAWR03 = DS WR03

Call B3101XXX to create Tag File record

MWDH = DS MWDH

LINE = DS LINE


/****** Reattach WO Header, P/L and Routing ****************/
If Work Re-Calculate PRtg Flag = 1

Call B3101250 Routing Begin Doc
Call B3101250 Routing Edit Doc in Copy by Item Mode

Call B3101250 Routing End Doc


Call B3101260 Parts List Begin Doc

Call B3101260 Parts List Edit Line in Copy BOM Mode

Call B3101260 Parts List End Doc

End If

End if Status is valid for change

End if Document Number is valid 



Data Structure

DX310911A - F4801 Add/Change Rate

Parameter NameData ItemData TypeReq/OptI/O/Both
cProcessEditsEV01charOPTNONE

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

cSuppressErrorMessagesEV02charOPTNONE

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

cErrorCodeERRCcharOPTNONE

This error code indicates if any errors occurred during the creation of the Trip Document Detail (F4914) records by the Delivery Document 
Set Server program (XT4914).

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.

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.

szVersionVERScharOPTNONE

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.

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

szOrderTypeDCTOcharOPTNONE

A user defined code (00/DT) that identifies the type of document. This code also indicates the origin of the transaction. J.D. Edwards has 
reserved document type codes for vouchers, invoices, receipts, and time sheets, which create automatic offset entries during the post 
program. (These entries are not self-balancing when you originally enter them.) The following document types are defined by J.D. Edwards and 
should not be changed: P Accounts Payable documents   R Accounts Receivable documents   T Payroll documents   I Inventory documents  
O Purchase Order Processing documents   J General Accounting/Joint Interest Billing documents   S Sales Order Processing documents

mnShortItemNumberITMMATH_NUMERICOPTNONE

An inventory item number. The system provides three separate item numbers plus an extensive cross-reference capability to other item 
numbers (see data item XRT) to accommodate substitute item numbers, replacements, bar codes, customer numbers, supplier numbers, and 
so forth. The item numbers are as follows:   o Item Number (short) - An eight-digit, computer-assigned item number     o 2nd Item Number - The 
25-digit, free-form, user defined alphanumeric item number     o 3rd Item Number - Another 25-digit, free-form, user defined alphanumeric item 
number

mnRateQtyUORGMATH_NUMERICOPTNONE

The quantity of units affected by this transaction.

szUnitOfMeasureUOMcharOPTNONE

A user defined code (00/UM) that indicates the quantity in which to express an inventory item, for example, CS (case) or BX (box).

szBranchPlantMMCUcharOPTNONE

A code that represents a high-level business unit. Use this code to refer to a branch or plant that might have departments or jobs, which 
represent lower-level business units, subordinate to it. For example:     o Branch/Plant (MMCU)     o Dept A (MCU)     o Dept B (MCU)     o Job 123 
(MCU) Business unit security is based on the higher-level business unit.

szLineCellNumberLINEcharOPTNONE

A number that defines a production line or cell. Detailed work center operations can be defined inside the line or cell.

cShiftCodeSHFTcharOPTNONE

A user defined code (00/SH) that identifies daily work shifts. In payroll systems, you can use a shift code to add a percentage or amount to 
the hourly rate on a timecard. For payroll and time entry: If an employee always works a shift for which a shift rate differential is applicable, 
enter that shift code on the employee's master record. When you enter the shift on the employee's master record, you do not need to enter the 
code on the timecard when you enter time. If an employee occasionally works a different shift, you enter the shift code on each applicable 
timecard to override the default value.

jdScheduledStartDateSESDJDEDATEOPTNONE

The calendar date that an operation or rate is scheduled to begin.

cPeriodMWDHcharOPTNONE

A code that determines the frequency of the schedule. Valid values are:    1   Monthly    2   Weekly    3   Daily    4   Per Shift (for future use)

jdRequestedDateDRQJJDEDATEOPTNONE

The date that an item is scheduled to arrive or that an action is scheduled for completion.

szTypeRoutingTRTcharOPTNONE

A user defined code (40/TR) that indicates the type of routing. You can define different types of routing instructions for different uses. For 
example:    M    Standard Manufacturing Routing    RWK  Rework Routing    RSH  Rush Routing You define the routing type on the work order 
header. The system then uses the specific type of routing that you define in the work order routing. Product Costing and Capacity Planning systems 
use only M type routings.

szTypeBillTBMcharOPTNONE

A user defined code (40/TB) that designates the type of bill of material. You can define different types of bills of material for different uses. 
For example:    M     Standard manufacturing bill    RWK   Rework bill    SPR   Spare parts bill  The system enters bill type M in the work order 
header when you create a work order, unless you specify another bill type. The system reads the bill type code on the work order header to 
know which bill of material to use to create the work order parts list. MRP uses the bill type code to identify the bill of material to use when it 
attaches MRP messages. Batch bills of material must be type M for shop floor management, product costing, and MRP processing.

szStatusCodeSRSTcharOPTNONE

A user defined code (00/SS) that describes the status of a work order, rate schedule, or engineering change order. Any status change from 
90 through 99  triggers the system to automatically update the completion date.

cAttachPLRtgEV01charOPTNONE

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

szItemNoUnknownFormatUITMcharOPTNONE

A number that the system assigns to an item. It can be in short, long, or third item number format.

cCreateChangeF4801EV03charOPTNONE

A radio button that specifies the level at which trace/track result is to be displayed.  Select the Detail to display all transactions except IB, IX, 
and IZ types.  Or, select Derivative Lots Only to display only those transactions that may have created new derivative lot. 

szCatCode1WR01charOPTNONE

A user defined code (00/W1) that indicates the current stage or phase of development for a work order. You can assign a work order to only 
one phase code at a time. Note: Certain forms contain a processing option that allows you to enter a default value for this field. If you enter a 
default value on a form for which you have set this processing option, the system displays the value in the appropriate fields on any work 
orders that you create. The system also displays the value on the Project Setup form. You can either accept or override the default value.

szCatCode2WR02charOPTNONE

A user defined code (00/W2) that indicates the type or category of a work order. Note: A processing option for some forms lets you enter a 
default value for this field. The system enters the default value automatically in the appropriate fields on any work orders that you create on 
those forms and on the Project Setup form. You can either accept or override the default value.

szCatCode3WR03charOPTNONE

A user defined code (00/W3) that indicates the type or category of the work order. Note: A processing option for some forms allows you to 
enter a default value for this field. The system enters the default value automatically in the appropriate fields on any work orders that you 
create on those forms and on the Project Setup form. You can either accept or override the default value.

mnX4801WFLineNumberLNIDMATH_NUMERICOPTNONE

A number that identifies multiple occurrences, such as line numbers on a purchase order or other document. Generally, the system assigns 
this number,but in some cases you can override it.

cX4801RecordWrittenToCacheEV04charOPTNONE

PeopleSoft event point processing flag 04.

mnX4801JobNumberJOBSMATH_NUMERICOPTNONE

The job number (work station ID) which executed the particular job.

cActionCodeACTNcharOPTNONE

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

szPIDForProcOptRetrievalPIDcharOPTNONE

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.

szStatusCommentWO_STCMSTCMcharOPTNONE

A brief description to explain the status of the work order.

cWoOrderFreezeCode_UNCDUNCDcharOPTNONE

A code that indicates if the line on the order is frozen. MPS/MRP does not suggest changes to frozen orders.  Valid values are: Y Yes, freeze 
the order. N No, do not freeze the order. This value is the default.

szCatCode004_WR04WR04charOPTNONE

A user defined code (00/W4) that indicates the type or category of the work order.

szCatCode005_WR05WR05charOPTNONE

A user defined code (00/W5) that indicates the type or category of the work order.

szCatCode006_WR06WR06charOPTNONE

A user defined code (00/W6) that indicates the status of the work order.

szCatCode007_WR07WR07charOPTNONE

A user defined code (00/W7) that indicates the service type for the work order.

szCatCode008_WR08WR08charOPTNONE

A user defined code (00/W8) that indicates the type or category of the work order.

szCatCode009_WR09WR09charOPTNONE

A user defined code (00/W9) that indicates the type or category of the work order.

szCatCode010_WR10WR10charOPTNONE

A user defined code (00/W0) that indicates the type or category of the work order.

mnCustomer_AN8AN8MATH_NUMERICOPTNONE

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

mnSupervisor_ANPAANPAMATH_NUMERICOPTNONE

The address book number of the supervisor.

mnManager_ANSAANSAMATH_NUMERICOPTNONE

The address book number of a manager or planner.   Note:  A processing option for some forms allows you to enter a default value for this 
field based on values for category codes 1 (Phase), 2, and 3.  You set up the default values on the Default Managers and Supervisors form.  
After you set up the default values and the processing option, the default information displays automatically on any work orders that you 
create if the category code criterion is met.  You can either accept or override the default value. 

szLot_LOTNLOTNcharOPTNONE

A number that identifies a lot or a serial number. A lot is a group of items with similar characteristics.

szParentWoNumber_PARSPARScharOPTNONE

A number that identifies the parent work order. You can use this number to do the following:     o Enter default values for new work orders, 
such as Type, Priority, Status, and Manager     o Group work orders for project setup and reporting  

cPriorityWO_PRTSPRTScharOPTNONE

A user defined code (00/PR) that indicates the relative priority of a work order or engineering change order in relation to other orders. A 
processing option for some forms lets you enter a default value for this field. The value then displays automatically in the appropriate fields on 
any work order you create on those forms and on the Project Setup form. You can either accept or override the default value.

szSubsidiary_SUBSUBcharOPTNONE

A subset of an object account. Subsidiary accounts include detailed records of the accounting activity for an object account.

szBillRevisionLevel_BREVBREVcharOPTNONE

A value that indicates the revision level of a bill of material. It is usually used in conjunction with an engineering change notice or 
engineering change order. The revision level of the bill of material should match the revision level of its associated routing, although the system does 
not check this. This value is defined and maintained by the user.

szBusinessUnit_MCUMCUcharOPTNONE

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.

szRelatedOrderNumber_RORNRORNcharOPTNONE

A number that identifies a secondary purchase order, sales order, or work order that is associated with the original order. This number is for 
informational purposes only.

szRelatedOrderType_RCTORCTOcharOPTNONE

A user defined code (system 00, type DT) that indicates the document type of the secondary or related order. For example, a purchase 
order might be document type OP and might have been created to fill a related work order with document type WO.

szCompanyKeyRelated_RKCORKCOcharOPTNONE

The key company that is associated with the document number of the related order.

cTypeWO_TYPSTYPScharOPTNONE

A user defined code (00/TY) that indicates the classification of a work order or engineering change order. You can use work order type as a 
selection criterion for work order approvals.

szReference1_VR01VR01charOPTNONE

An alphanumeric value used as a cross-reference or secondary reference number. Typically, this is the customer number, supplier 
number, or job number.

szMessageNo_SHNOSHNOcharOPTNONE

A generic rates and message code (48/SN) that is assigned to a standard note, message, or general narrative explanation. You can use 
this code to add instructional information to a work order. You set up codes for this field on the Generic Message/Rate Types table (F00191).

cWoFlashMessage_SPRTSPRTcharOPTNONE

A user defined code (00/WM) that indicates a change in the status of a work order. The system indicates a changed work order with an 
asterisk in the appropriate report or inquiry form field. The system highlights the flash message in the Description field of the work order.

mnSecondaryQtyOrderedSQORMATH_NUMERICOPTNONE

If the secondary unit of measure option in Inventory Constants is selected,this field will display on data entry screens.

szSecondaryUnitOfMeasureUOM2charOPTNONE

A user defined code (00/UM) that indicates an alternate unit of measure for the item.

Related Functions

None

Related Tables

None
F4801DeleteRate

F4801DeleteRate

F4801 Add, Change, Delete Rate

Minor Business Rule

Object Name: XT310911

Parent DLL: CMFGBASE

Location: Client/Server

Language: NER

Functional Description

Purpose

• Delete the F3112 Routing records
• Delete the F3111 Parts List records
• Delete the F3105 Serial Number records
• Delete all the F31091 records related to F4801 Rate Number
• If all deletes are successful, delete F4801 Rate record

Setup Notes and Prerequisites

Data Structure DescriptionI/ORequiredNotes

cProcessEditsIN1  All Edits (Default) 

2  Partial Edits (Not Used)

cSuppressErrorMessagesIN1  Error Messages Suppressed

szErrorMessageIDON

mnDocument NumberIY

szBranchPlantIY

cErrorCodeON'0' = No Errors 

'1`'= Warnings 

'2' = Error

mnX4801WFLineNumberIYRequired if Add/Change Rate Edits was called

This value was returned in Add/Change Rate Edits

cX4801RecordWrittenToCacheIYSame as mnX4801WLineNumber

mnX4801JobNumberIYSame as mnX4801WLineNumber



Special Logic

Call X4801 with Process Module = RMFG, because the Routing and Parts List will still

exist.  Only after all business functions have returned a success, will any records be

deleted.



Technical Specification

If input Document Number is not blank
Call X4801 Begin Doc to initialize

Call X4801 Edit Line to fetch F4801 record

Else

Set error and exit

End if


If Document Number is valid

Get MFG Constants 

/* Check if status is valid to change */

If F4801 SRST < F3009 Status

/* Delete the Parts List */

Call B3101260 Begin Doc

Call B3101260 Edit Doc in Delete Parts List Mode

If successful in deleting the Parts List

/* Delete the Routing */

Call B3101250 Begin Doc

Call B3101250 Edit Doc in Delete Routing Mode


If successful in deleting the Routing 

/* Delete the F4801 record */

Call X4801 Begin Doc

Call X4801 Edit Line in Delete Mode


If successful in deleting the F4801 record

/* Delete all F31091 records related to Document Number */

Call X31091 in Delete Mode


End If

End If 

End If

If all deletes are successful

/* Call MBF's End Doc to delete the records from the table */

Call B3101260 End Doc (also deletes cost F3102 records)

Call B3101250 End Doc

Call X4801 End Doc (Need to modify to include F3105 serial # deletes)

Call B31011XXX to delete tag file records

End If

End if status is valid

End if Document Number is valid



^

Data Structure

DX310911B - F4801 Delete Rate

Parameter NameData ItemData TypeReq/OptI/O/Both
cProcessEditsEV01charOPTNONE

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

cSuppressErrorMessagesSUPPScharOPTNONE

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.

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.

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

szBranchPlantMMCUcharOPTNONE

A code that represents a high-level business unit. Use this code to refer to a branch or plant that might have departments or jobs, which 
represent lower-level business units, subordinate to it. For example:     o Branch/Plant (MMCU)     o Dept A (MCU)     o Dept B (MCU)     o Job 123 
(MCU) Business unit security is based on the higher-level business unit.

cErrorCodeERRCcharOPTNONE

This error code indicates if any errors occurred during the creation of the Trip Document Detail (F4914) records by the Delivery Document 
Set Server program (XT4914).

mnX4801WFLineNumberLNIDMATH_NUMERICOPTNONE

A number that identifies multiple occurrences, such as line numbers on a purchase order or other document. Generally, the system assigns 
this number,but in some cases you can override it.

cX4801RecordWrittenToCacheEV01charOPTNONE

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

mnJobNumberJOBSMATH_NUMERICOPTNONE

The job number (work station ID) which executed the particular job.

Related Functions

None

Related Tables

None
BR>

/* Calculate the Last Records Qty. 

     This record adjusts the qty because of rounding */
Work Number = Number of Cache Records - 1
Work Qty = Work Qty Ordered * Work Number

Work Last Qty Ordered = Input Qty Ordered - Work Qty

Else

/* This is a Work Order with Line specified 

    Create F31091 records but only the last record contains

   the Order Qty.  All other dates have blank Quantities */
DS PLQT = 0

Work Last Qty Ordered = Input Qty Ordered

End If

/*** Loop through all dates and create new F31091 records ***/

Counter =1
Fetch 1st record from the Date Cache 

(See Edit Date Business Function specs)

While Fetch from Spread Date Cache is successful (Call B3101640)