UpdateBOMAuditLog

Update BOM Audit Log

Master Business Function

Object Name: B3000420

Parent DLL: CMFGBASE

Location: Client/Server

Language: C

1.Functional Description

1.1Purpose
Record updates and deletions made to the Bill of Material.  If mode is equal to '2', record Bill of
Material
Change.  If Mode is equal to '3', record Bill of Material Deletion.

If the Bill of Material record is being deleted, the record is fetched from within this business
function prior to being deleted from the F3002 table.  The deletion is recorded in the F3011 just before
the record is deleted.

If the Bill of Material record is being changed, the modified record is recorded in the Bill of
Material Audit Log (F3011) prior to the record being changed.

1.2Setup Notes and Prerequisites
The setup notes and prerequisites contains information that needs to be provided to the application
developer to successfully use attach the business function.  Important prerequisite Business Functions
that need to be run and any additional relevant information (what event points, limitations, data
structure peculiarities) should be detailed.
• Use bullet points
'b7
1.3Special Logic
This section should be used when additional logic is used in the Business Function for application
specific functionality or exceptional situations.

2.Technical Specifications
2.4Processing
Edits:
1.0.  Clear the Bill of Material Audit Log Record (F3011).

2.0.  If Mode is not equal to '2' or  Mode is not equal to '3', return error 'Invalid Parameter'.

2.1.  Assign DS Error Message ID = '4375'.
2.2.  If DS SuppressErrorMessages is equal to '1', SetGBRError = '4375'.
2.3.  Return

3.0.  Get the pointer to the F3002 record using business function VerifyAndGetBillofMaterial
(3000510).  Pass the following parameters:
Parent Branch= DS ParentBranch
Parent Item= DS ParentItem(short)
Type of Bill= DS Type of Bill
Batch Quantity= DS Batch Quantity
LineNo= DS Line No
SubstituteItemSequence= DS SubstituteItemSequence
Call Type= '1'
Return Pointer = '1'
Suppress Error Messages = '1'
CoBy Product= DS CoByProduct

Return the following information:

F3002Pointer= B30000510 F3002Pointer
ErrorMessageID  = B30000510 ErrorMessageID

4.0.  If the B30000510 ErrorMessageID is not equal to blanks, return error.

4.1.  Assign DS ErrorMessageID = B30000510 ErrorMessageID.
4.2.  If DS SuppressErrorMessages is not equal to '1', SetGBRError = B30000510 ErrorMessageID and
highligh DS Line No.

4.3.  Return

5.0.   If Mode is equal to '2', assign F3011 ACTN = 'C'.  If Mode is equal to '3', assign F3011 ACTN
= 'D'.

6.0.  Copy the F3002 fields from the data structure to the corresponding F3011 fields.

7.0.  Retrieve System Date , Time and Workstation ID and User ID using call to B9800100
GetAuditInformation.  Assign the current system time and date to the time and date fields in F3011.

8.0.  Write the Bill of Material Audit Log Record.

9.0.  Free the pointer to the F3002 record retrieved in step 3.0 using BF FreePTRtoDataStructure.

Data Structure

D3000420 - Update BOM Audit Log

Parameter Name Data Item Data Type Req/Opt I/O/Both

cMode MODE char NONE NONE

The processing mode used in Purchase Order Consolidator to signify when specific orders are being processed.

szParentBranch MMCU char NONE NONE

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.

mnParentItemShort KIT MATH_NUMERIC NONE NONE

The system provides for three separate item numbers.    1.   Item Number (short) - An eight-digit, computer assigned, completely
non-significant item number.    2.   2nd Item Number - The 25-digit, free form, user defined alphanumeric item number.    3.   3rd Item Number - Another
25-digit, free form, user defined alphanumeric item number.

szTypeOfBill TBM char NONE NONE

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.

mnBatchQuantityFile BQTY MATH_NUMERIC NONE NONE

The quantity of finished units that you expect this bill of material or routing to produce. You can specify varying quantities of components
based on the amount of finished goods produced. For example, 1 ounce of solvent is required per unit up to 100 units of finished product.
However, if 200 units of finished product is produced, 2 ounces of solvent are required per finished unit. In this example, you would set up batch
quantities for 100 and 200 units of finished product, specifying the proper amount of solvent per unit.

mnSubstituteItemSequence SBNT MATH_NUMERIC NONE NONE

A number that indicates the sequence for the substitute items for a component. The system looks for substitute items by this sequence
number.

cSuppressErrorMessages EV01 char NONE NONE

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

szErrorMessageID DTAI char NONE NONE

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.

cCoByProduct COBY char NONE NONE

A code that distinguishes standard components or ingredients from co-products,by-products, and intermediates. Co-products are
(concurrent) end items as the result of a process. By-products are items that can be produced at any step of a process, but were not planned.
Intermediate products are items defined as a result of a step but are automatically consumed in the following step. Generally, intermediates are
nonstock items and are only defined steps with a pay-point for reporting purposes. Standard components (Discrete Manufacturing) or ingredients
(Process Manufacturing) are consumed during the production process. Valid values are:    C Co-products    B By-products    I Intermediate
products    Blank Standard components or ingredients

szProgramId PID char NONE NONE

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.

mnLineNo CPNB MATH_NUMERIC OPT NONE

A number that specifies how the system displays the sequence of components on a single-level bill of material. This number initially
indicates the sequence in which a component was added to the bill of material. You can modify this number to change the sequence in which the
components appear.

Related Functions

B3000510 Verify And Get Bill Of Material

B4000460 Free Ptr To Data Structure

B9800100 Get Audit Information

Related Tables

F3011 Bill of Materials Change File

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
cMode	MODE	char	NONE	NONE
The processing mode used in Purchase Order Consolidator to signify when specific orders are being processed.
szParentBranch	MMCU	char	NONE	NONE
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.
mnParentItemShort	KIT	MATH_NUMERIC	NONE	NONE
The system provides for three separate item numbers. 1. Item Number (short) - An eight-digit, computer assigned, completely non-significant item number. 2. 2nd Item Number - The 25-digit, free form, user defined alphanumeric item number. 3. 3rd Item Number - Another 25-digit, free form, user defined alphanumeric item number.
szTypeOfBill	TBM	char	NONE	NONE
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.
mnBatchQuantityFile	BQTY	MATH_NUMERIC	NONE	NONE
The quantity of finished units that you expect this bill of material or routing to produce. You can specify varying quantities of components based on the amount of finished goods produced. For example, 1 ounce of solvent is required per unit up to 100 units of finished product. However, if 200 units of finished product is produced, 2 ounces of solvent are required per finished unit. In this example, you would set up batch quantities for 100 and 200 units of finished product, specifying the proper amount of solvent per unit.
mnSubstituteItemSequence	SBNT	MATH_NUMERIC	NONE	NONE
A number that indicates the sequence for the substitute items for a component. The system looks for substitute items by this sequence number.
cSuppressErrorMessages	EV01	char	NONE	NONE
An option that specifies the type of processing for an event.
szErrorMessageID	DTAI	char	NONE	NONE
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.
cCoByProduct	COBY	char	NONE	NONE
A code that distinguishes standard components or ingredients from co-products,by-products, and intermediates. Co-products are (concurrent) end items as the result of a process. By-products are items that can be produced at any step of a process, but were not planned. Intermediate products are items defined as a result of a step but are automatically consumed in the following step. Generally, intermediates are nonstock items and are only defined steps with a pay-point for reporting purposes. Standard components (Discrete Manufacturing) or ingredients (Process Manufacturing) are consumed during the production process. Valid values are: C Co-products B By-products I Intermediate products Blank Standard components or ingredients
szProgramId	PID	char	NONE	NONE
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.
mnLineNo	CPNB	MATH_NUMERIC	OPT	NONE
A number that specifies how the system displays the sequence of components on a single-level bill of material. This number initially indicates the sequence in which a component was added to the bill of material. You can modify this number to change the sequence in which the components appear.

B3000510 Verify And Get Bill Of Material
B4000460 Free Ptr To Data Structure
B9800100 Get Audit Information