F30008BeginDoc

F30008 Work Ctr Rates Master Bsfn

Master Business Function

Object Name: N3001900

Parent DLL: CMFGBASE

Location: Client/Server

Language: NER

1.Functional Description
1.1Purpose
This function will:

• Assign a job number (JOBS) to be used to identify the cache.
• Edit the Action Code.

1.2Setup Notes and Prerequisites

• This function must be called before calling F30008 Edit Line.

• The calling program/application must define work fields to hold all the output parameters of this 
function.  Some of which will be passed to subsequent edit object modules (i.e., Edit Line, End Doc).


1.3Special Logic

• This function uses cache, or a memory array, to store work center revisions information until F30008 
End Doc is called.  This function will determine the Job Number (JOBS) which is used to name the 

cache.  No updating of cache is done in this function.

• Parameter fields are denoted by -parm, and cache (work file) fields by -cache.  Variables that are 
defined and used only within this program are denoted by (WF).


2.Technical Specifications

2.4Processing

1.Assign Job Number:
a.If the Job Number-parm (JOBS) is zero, retrieve a new job number:
X0010 - Get Next Number (X0010):
System Code<="30"
Next Num. Index<='1'

Next Number =>JobNumber-parm

b.Return the retrieved Job Number to calling application. 

2.Edit the action code:
a.Convert ActionCode-parm of 'A' to '1';  'C' to '2'; 'D' to '3'.
b.Validate that the ActionCode-parm is either '1', '2' or '3'.  

c.Return error "0001"  to calling program if ActionCode-parm is invalid.




^

Data Structure

D3001900A - F30008 Begin Doc

Parameter NameData ItemData TypeReq/OptI/O/Both
mnJobnumberJOBSMATH_NUMERICNONENONE

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

cActionCodeACTNcharNONENONE

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

cSuppressErrorMsgsEV01charNONENONE

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

cErrorConditionsERRCcharNONENONE

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

szErrorMessageIDDTAIcharNONENONE

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.

Related Functions

None

Related Tables

None
F30008ClearCache

F30008ClearCache

F30008 Work Ctr Rates Master Bsfn

Master Business Function

Object Name: N3001900

Parent DLL: CMFGBASE

Location: Client/Server

Language: NER

1.Functional Description
1.1Purpose
This function will clear the cache (memory array) used by F30008 Edit Line and F30008 End Doc 
functions.


1.2Setup Notes and Prerequisites

• Call this function only if F30008 Edit Line or F30008 End Doc have been called.
Special Logic

• This function must be called once for each set of revision transactions, i.e. once for each F30008 
Begin Doc function call.

• Parameter fields are denoted by -parm, and cache (work file) fields by -cache.  Variables that are 
defined and used only within this program are denoted by (WF).


2.Technical Specifications
2.4Processing
1.Terminate Work Center cache:
Cache, Process Work Center Rates (B3001870):
Job Number<=JobNumber-parm
Process Mode<='8'

Cache Code Error=>CacheCodeError (WF)

Suppress Error Msgs<='1'

Error Message ID=>ErrorMessageID (WF)


^

Data Structure

D3001900D - F30008 Clear Cache

Parameter NameData ItemData TypeReq/OptI/O/Both
mnJobnumberJOBSMATH_NUMERICNONENONE

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

Related Functions

None

Related Tables

None
F30008EditLine

F30008EditLine

F30008 Work Ctr Rates Master Bsfn

Master Business Function

Object Name: N3001900

Parent DLL: CMFGBASE

Location: Client/Server

Language: NER

1.Functional Description
1.1Purpose
This function will:

• Perform field level edits on input parameters (when full or partial edits requested).
• Perform standard data dictionary and UDC edits (if full edits requested) on input parameters.
• Write/update cache with input parameter values if no errors.

1.2Setup Notes and Prerequisites
• F30008 Begin Doc must be called before calling this function.  Begin Doc will determine job number 
to uniquely identify the cache used in Edit Doc and End Doc processing.

• This function must be called before calling F30008 End Doc.
• The calling program/application must define work fields to hold all the output parameters of this 
function.  Some of which will be passed to subsequent edit object modules (i.e., End Doc).


1.3Special Logic
• This function uses cache, or a memory array, to store work center rates information until F30008 End 
Doc is called.  The F30008 table is only updated during End Doc processing.  The cache will not be 

written if errors occur in the Edit Doc function; End Doc should not be called if any errors are 

encountered during edit processing. The cache is cleared only by calling the F30008 Clear Cache function.

• The Edit Doc and End Doc functions may be called multiple times for a set of table update 
transactions;  the Begin Doc and Clear Cache functions must be called only once for each set of transactions.

• When multiple transactions are processed for the same F30008 record, the most recent transaction 
will overlay any previously submitted transactions.

• Parameter fields are denoted by -parm, and cache (work file) fields by -cache.  Variables that are 
defined and used only within this program are denoted by (WF).


2.Technical Specifications

2.4Processing
Main Processing:
1.Initialize the following fields:
a.If Process Edits-parm is blank, assign a default value of '2' (i.e. Full edits).

2.Validate the action code and validate the requested action against F30006.  A record should not 
already exist if an "add" is being performed; an update or delete must have an existing record on 

F30006.


3.Validate that F30006 key fields are not blank.


4.Perform the following edit processing based on the ActionCode-parm (see 8. Below).

5.After edit processing, if no errors are found and UpdateOrAddToCache-parm value is '1',  add or 

update a cache element with the Action Code (adds, updates, and deletions to F30008 will be 

performed by End Doc):

Cache, Process Work Center Rates (B3001870):
Job Number<=JobNumber-parm
Work Center<=WorkCenter-parm

All F30008 values<=(All F30008 input parms)

Number of Keys<='2'

Process Mode<='7'

Cache Code Error=>CacheCodeError (WF)

Suppress Error Msgs<='1'

Error Message ID=>ErrorMessageID (WF)

Branch<=Branch-parm


6.Set the ErrorConditions-parm based on errors encountered:
a.If hard errors occur, set the error code to '1'.  
b.If warning errors occur, assign an error code of '2'.

c.If no errors occur, assign an error code of '0'.


7.If Process Edits not = zero, perform any general edits (i.e. edits not performed by the runtime 
engine).

a.Validate the WorkCenter-parm value against the Work Center Master table (F30006); set 
error "4507" if the WorkCenter-parm is not a valid business unit:

F30006 Get WC Master Row (B3000030):
Business Unit<=WorkCenter-parm
Return Pointer>='0'

Call Type<='1'

Suppress Error Msgs<='1'

Error Message ID=>ErrorMessageID (WF)

Branch<=Branch-parm


Add/Update Edits:
8.If Process Edits = '2' (full edits), perform standards "tool" editing (DD and UDC edits):
a.Validate the Branch-parm value against the Business Unit Master table (F0006); set error 
"3091" if the Branch-parm is not a valid business unit:

F0006 Check Business Unit Existence (B5100003):
Business Unit<=Branch-parm
Found Flag=>Valid Business Unit (WF)


b.Validate the WorkCenter-parm value against the Business Unit Master table (F0006); set 
error "3091" if the WorkCenter-parm is not a valid business unit:

F0006 Check Business Unit Existence (B5100003):
Business Unit<=WorkCenter-parm
Found Flag=>Valid Business Unit (WF)


c.On all input parameters which are F30008 table fields, perform standard data dictionary 
edits, including UDC edits,  and return any default values.  If the function does not return 

successful, set error "0025" .

Data Dictionary Validation (BDDVAL):
Data Item<=Data item alias, e.g. "STLF"
Everest Type<=1 if character; 9 if numeric,

 2 if string;  11 if date

Character or Numeric<=input parameter, e.g. 

   Direct Labor Frozen-parm

Delete Edits:
None.

Data Structure

D3001900B - F30008 Edit Line

Parameter NameData ItemData TypeReq/OptI/O/Both
mnJobnumberJOBSMATH_NUMERICNONENONE

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

cActionCodeACTNcharNONENONE

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

cUpdateorWriteCacheEV01charNONENONE

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

cProcessEditsEV01charNONENONE

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

cSuppressErrorMsgsEV01charNONENONE

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

szWorkCenterMCUcharNONENONE

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.

szCostMethodLEDGcharNONENONE

A user defined code (40/CM) that specifies the basis for calculating item costs. Cost methods 01 through 19 are reserved for J.D. Edwards 
use.

mnDirectLaborFrozSTLFMATH_NUMERICNONENONE

This rate, in cost per hour, is the rate used to calculate the standard labor cost as of the last simulation and update.

mnDirectLaborSimXSDLMATH_NUMERICNONENONE

A rate, in cost per person per hour, that the system uses with the Run Labor hours of the associated routing to calculate the standard run 
labor cost.

mnSetupLaborFrozSTFFMATH_NUMERICNONENONE

This rate, in cost per hour, is the rate used to calculate the standard setup labor cost as of the last simulation and update.

mnSetupLaborSimXSSLMATH_NUMERICNONENONE

A rate that the system uses with the Setup Labor Hours of the associated routing to calculate the standard setup labor cost.

mnIndirectLaborFrozSIDLMATH_NUMERICNONENONE

This rate, in cost per hour, is the rate used to calculate the standard indirect labor cost as of the last simulation and update.

mnIndirectLaborSimXSILMATH_NUMERICNONENONE

This rate, in cost per hour, is used with the indirect labor hours field of the associated routing to calculate the standard indirect labor cost.

mnLaborVarOHFrozSTRFMATH_NUMERICNONENONE

This rate, in cost per hour or percent of labor, is the rate used to calculate the standard variable labor overhead cost as of the last 
simulation and update.

mnLaborVarOHSimXSVOMATH_NUMERICNONENONE

A rate or percent, as determined on Manufacturing Constants, used to calculate the standard variable labor overhead cost. If this field is a 
rate, it is the cost per hour. If this field is a percent, it is the percent of direct labor. Enter percents as whole numbers. For example, enter five 
percent as 5.00.

mnLaborFixedOHFrozSTRZMATH_NUMERICNONENONE

This rate, in cost per hour or percent of labor, is the rate used to calculate the standard fixed labor overhead cost as of the last simulation 
and update.

mnLaborFixedOHSimXSFOMATH_NUMERICNONENONE

A rate or percent, as determined on Manufacturing Constants, used to calculate the standard fixed labor overhead cost. If this field is a rate, 
it is the cost per hour. If this field is a percent, it is the percent of direct labor. Enter percents as whole numbers. For example, enter five 
percent as 5.00.

mnMachineRunFrozMSFRMATH_NUMERICNONENONE

This rate, in cost per hour, is the rate used to calculate the standard machine cost as of the last simulation and update.

mnMachineRunSimXSMRMATH_NUMERICNONENONE

A rate that the system uses with the Run Machine hours of the associated routing to calculate the standard machine labor cost.

mnMachineVarOHFrozMSTFMATH_NUMERICNONENONE

This rate, in cost per hour, is the rate used to calculate the standard machine cost as of the last simulation and update.

mnMachineVarOHSimXSMVMATH_NUMERICNONENONE

A rate or percent, as determined on Manufacturing Constants, used to calculate the future standard machine overhead cost. If this field is a 
rate, it is the cost per hour. If this field is a percent, it is the percent of machine run. Enter percents as whole numbers. For example, enter five 
percent as 5.00.

mnMachineFixedOHFrozMSSFMATH_NUMERICNONENONE

This rate, in cost per hour or percent of labor, is the rate used to calculate the standard fixed machine overhead cost as of the last 
simulation and update.

mnMachineFixedOHSimXSMFMATH_NUMERICNONENONE

A rate or percent, as determined on Manufacturing Constants, used to calculate the standard fixed machine overhead cost. If this field is a 
rate, it is the cost per hour. If this field is a percent, it is the percent of machine run. Enter percents as whole numbers. For example, enter five 
percent as 5.00.

mnProductionHoursSTAFMATH_NUMERICNONENONE

Future use. The average of the standard time (hours) worked per period at a work center.

szProgramIdPIDcharNONENONE

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.

cErrorConditionsERRCcharNONENONE

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

szErrorMessageIDDTAIcharNONENONE

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.

szBranchMMCUcharOPTNONE

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.

Related Functions

None

Related Tables

None
F30008EndDoc

F30008EndDoc

F30008 Work Ctr Rates Master Bsfn

Master Business Function

Object Name: N3001900

Parent DLL: CMFGBASE

Location: Client/Server

Language: NER

1.Functional Description
1.1Purpose
This function will:

• Perform the appropriate action (Add, Update, or Delete) to the Work Center Rates table (F30008) 
using values stored in cache.


1.2Setup Notes and Prerequisites
• F30008 Begin Doc and F30008 Edit Doc must be called before calling this function.
• End Doc should not be called if any errors are encountered during edit processing or if the Work 
Center Rates (F30008) should not be updated (i.e. only editing should be performed by F30008 Edit Line).

• If the Work Center and Cost Method value is passed in as an input parameter, only the cache element 
with a matching work center and Cost Method will be updated on F30008;  if the work center and Cost 

Method parameter are left blank, all work center rate revisions stored in cache will be processed (i.e. 

the appropriate action Add, Change, Delete will be processed against F30008 for each cache element).  

If only the Cost Method is left blank, all cache elements matching the Work Center value will be 

processed.  The Work Center must be passed to the function, however, if the Cost Method is passed in as 

input.

• This function does not clear or terminate the cache (memory array).  The F30008 Clear Work File 
function must be called to clear the cache after the calling application/program has completed all 

processing against the cache.  

Special Logic

• This function updates the Work Center Rates table using values retrieved from cache, or a memory 
array.  The cache was updated with these values in the F30008 Edit Line function. 

• Parameter fields are denoted by -parm, and cache (work file) fields by -cache.  Variables that are 
defined and used only within this program are denoted by (WF).


2.Technical Specifications
2.4Processing
1.Retrieve audit information for Add or Update actions:
Get Audit Information (B9800100):
User Name=>UserName (WF)
Date=>Date (WF)

Time=>Time (WF)

Workstation=>Workstation (WF)



2.Retrieve the Work Center values from cache for the work center specified, or retrieve the 
"next" cache element if no work center has been specified:

Cache, Process Work Center Rates (B3001870):
Job Number<=JobNumber-parm
Work Center<=WorkCenter-WK (from previous read)

Cost Method<=Cost Method-WK (from previous read)

All F30008 values=>(All F30008 values)

Number of Keys<='2' if Work Center-parm and 

Cost Method-parm are entered
<='1' if Cost Method-parm is not 
entered 

<='0' if Work Center-parm and 

Cost Method-parm are not entered
Process Mode<='1'
Cache Code Error=>CacheCodeError (WF)

Suppress Error Msgs<='1'

Error Message ID=>ErrorMessageID (WF)

Branch<=Branch-WK (from previous read)


3.If the cache read was successful, process the action against the Work Center Rates table 
(F30008):

a.If Action Code is "1",  add a new Work Center Rates record (F30008) using values 
retrieved from cache and the audit information:


b.If Action Code is "2",  update the Work Center Rates record (F30008) with cache values 

and audit information:


c.If Action Code is "3",  delete the Work Center Rates record (F30008):

4.If the update processing was not successful, set error "0002".

5.If the update processing was successful, delete the cache element previously processed:

Cache, Process Work Center Rates (B3001870):
Job Number<=JobNumber-parm
Work Center<=WorkCenter-WK (from previous read)

Cost Method<=Cost Method-WK (from previous read)

All F30008 values=>(All F30008 values)

Number of Keys<='2'

Process Mode<='1'

Cache Code Error=>CacheCodeError (WF)

Suppress Error Msgs<='1'

Error Message ID=>ErrorMessageID (WF)

Branch<=Branch_WK (from previous read)


6.If the work center or cost method input parameters were not specified (i.e. partial key 

processing),  repeat steps 2 - 5 until the end of the selected cache elements is encountered:


7.Set the ErrorConditions-parm based on errors encountered:

a.If hard errors occur, set the error code to '1'.  
b.If warning errors occur, assign an error code of '2'.

c.If no errors occur, assign an error code of '0'.


Data Structure

D3001900C - F30008 End Doc

Parameter NameData ItemData TypeReq/OptI/O/Both
mnJobnumberJOBSMATH_NUMERICNONENONE

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

szWorkCenterMCUcharNONENONE

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.

szCostMethodLEDGcharNONENONE

A user defined code (40/CM) that specifies the basis for calculating item costs. Cost methods 01 through 19 are reserved for J.D. Edwards 
use.

cSuppressErrorMsgsEV01charNONENONE

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

cErrorConditionsERRCcharNONENONE

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

szErrorMessageIDDTAIcharNONENONE

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.

szBranchMMCUcharOPTNONE

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.

Related Functions

None

Related Tables

None
 Doc must be called before calling this function.  Begin Doc will determine job number 

to uniquely identify the cache used in Edit Doc and End Doc processing.

• This function must be called before calling F30008 End Doc.
• The calling program/application must define work fields to hold all the output parameters of this 
function.  Some of which will be passed to subsequent edit object modules (i.e., End Doc).


1.3Special Logic
• This function uses cache, or a memory array, to store work center rates information until F30008 End 
Doc is called.  The F30008 table is only updated during End Doc processing.  The cache will not be 

written if errors occur in the Edit Doc function; End Doc should not be called if any errors are 

encountered during edit processing. The cache is cleared only by calling the F30008 Clear Cache function.

• The Edit Doc and End Doc functions may be called multiple times for a set of table update 
transactions;  the Begin Doc and Clear Cache functions must be called only once for each set of transactions.

• When multiple transactions are processed for the same F30008 record, the most recent transaction 
will overlay any previously submitted transactions.

• Parameter fields are denoted by -parm, and cache (work file) fields by -cache.  Variables that are 
defined and used only within this program are denoted by (WF).


2.Technical Specifications

2.4Processing
Main Processing:
1.Initialize the following fields:
a.If Process Edits-parm is blank, assign a default value of '2' (i.e. Full edits).

2.Validate the action code and validate the requested action against F30006.  A record should not 
already exist if an "add" is being performed; an update or delete must have an existing record on 

F30006.


3.Validate that F30006 key fields are not blank.


4.Perform the following edit processing based on the ActionCode-parm (see 8. Below).

5.After edit processing, if no errors are found and UpdateOrAddToCache-parm value is '1',  add or 

update a cache element with the Action Code (adds, updates, and deletions to F30008 will be 

performed by End Doc):

Cache, Process Work Center Rates (B3001870):
Job Number<=JobNumber-parm
Work Center<=WorkCenter-parm

All F30008 values<=(All F30008 input parms)

Number of Keys