GetComponentLocators

Get Component Locators

Major Business Rule

Object Name: B3000870

Parent DLL: CMFGBASE

Location: Client/Server

Language: C

1.Functional Description

1.1Purpose

This function will retrieve the Component Locators from F3015 for a Branch, Parent Item, Component 

Item, and Component Line Number for a F3002 (Bill of Materials File) record.  The Effective From and 

Effective Thru dates for the Component Locator records (F3015) may also be specified as input parameters. 

 An input parameter determines how many locators are loaded into the data structure; a maximum of 10 

locators and their unique key ids can be retrieved in one call to this function.  A flag will be sent 

back from the function to indicate that no more records exist.


1.2Setup Notes and Prerequisites

No special setup.


1.3Special Logic

There is no special logic within this function.


2.Technical Specifications


2.4Processing 

A.  Retrieve F3015 (Component Locator) record for the MMCU, KIT, ITM, CPNT, EFFF (if passed as 

input), and EFFT (if passed as input).  


B.   Assign i=1.


C.  Do for i=1 to the value in Locators Per Row (e.g. 10) or until no records are found.


1.  If a record is found assign CQBLOC the ith BLOC parameter in the data

structure; assign the CQUKID to the ith UKID in the data structure

2.  If a record is not found, do not assign anything to MoreRecords flag in 

data structure.


D.  If i=value of Locators Per Row (e.g. 10):


1.  Attempt to fetch the next F3015 record.  If a record exists, assign a '1' to 

MoreRecords flag.


^

Data Structure

D3000870 - Get Component Locators

Parameter NameData ItemData TypeReq/OptI/O/Both
szBranchMMCUcharNONENONE

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.

mnParentItemNumberKITMATH_NUMERICNONENONE

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.

mnComponentItemITMMATH_NUMERICNONENONE

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

szLocator_1BLOCcharNONENONE

This field identifies the specific location of a component in the assembly of an item, for example, the location of a part on a circuit board.

szLocator_2BLOCcharNONENONE

This field identifies the specific location of a component in the assembly of an item, for example, the location of a part on a circuit board.

szLocator_3BLOCcharNONENONE

This field identifies the specific location of a component in the assembly of an item, for example, the location of a part on a circuit board.

szLocator_4BLOCcharNONENONE

This field identifies the specific location of a component in the assembly of an item, for example, the location of a part on a circuit board.

szLocator_5BLOCcharNONENONE

This field identifies the specific location of a component in the assembly of an item, for example, the location of a part on a circuit board.

szLocator_6BLOCcharNONENONE

This field identifies the specific location of a component in the assembly of an item, for example, the location of a part on a circuit board.

szLocator_7BLOCcharNONENONE

This field identifies the specific location of a component in the assembly of an item, for example, the location of a part on a circuit board.

szLocator_8BLOCcharNONENONE

This field identifies the specific location of a component in the assembly of an item, for example, the location of a part on a circuit board.

szLocator_9BLOCcharNONENONE

This field identifies the specific location of a component in the assembly of an item, for example, the location of a part on a circuit board.

szLocator_10BLOCcharNONENONE

This field identifies the specific location of a component in the assembly of an item, for example, the location of a part on a circuit board.

cMoreRecordsEV01charNONENONE

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

cSuppressErrorMessageEV01charNONENONE

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

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.

mnLastKeyMATH01MATH_NUMERICNONENONE

- - - Good Performance Low Value. 

mnLocatorsPerRowMATH01MATH_NUMERICNONENONE

- - - Good Performance Low Value. 

jdEffectiveFromDateEFFFJDEDATENONENONE

A date that indicates one of the following:     o When a component part goes into effect on a bill of material     o When a routing step goes into 
effect as a sequence on the routing for an item     o When a rate schedule is in effect The default is the current system date. You can enter 
future effective dates so that the system plans for upcoming changes. Items that are no longer effective in the future can still be recorded and 
recognized in Product Costing, Shop Floor Management, and Capacity Requirements Planning. The Material Requirements Planning system 
determines valid components by effectivity dates, not by the bill of material revision level. Some forms display data based on the effectivity 
dates you enter.

jdEffectiveThruDateEFFTJDEDATENONENONE

A date that indicates one of the following:     o When a component part is no longer in effect on a bill of material     o When a routing step is no 
longer in effect as a sequence on the routing for an item     o When a rate schedule is no longer active The default is December 31 of the 
default year defined in the Data Dictionary for Century Change Year. You can enter future effective dates so that the system plans for upcoming 
changes. Items that are no longer effective in the future can still be recorded and recognized in Product Costing, Shop Floor Management, 
and Capacity Requirements Planning. The Material Requirements Planning system determines valid components by effectivity dates, not by 
the bill of material revision level. Some forms display data based on the effectivity dates you enter.

mnUniqueKeyID_1UKIDMATH_NUMERICNONENONE

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

mnUniqueKeyID_2UKIDMATH_NUMERICNONENONE

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

mnUniqueKeyID_3UKIDMATH_NUMERICNONENONE

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

mnUniqueKeyID_4UKIDMATH_NUMERICNONENONE

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

mnUniqueKeyID_5UKIDMATH_NUMERICNONENONE

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

mnUniqueKeyID_6UKIDMATH_NUMERICNONENONE

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

mnUniqueKeyID_7UKIDMATH_NUMERICNONENONE

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

mnUniqueKeyID_8UKIDMATH_NUMERICNONENONE

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

mnUniqueKeyID_9UKIDMATH_NUMERICNONENONE

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

mnUniqueKeyID_10UKIDMATH_NUMERICNONENONE

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

idhRequestGENLNGIDNONENONE

General purpose ID variable.

mnComponentLineNumberCPNBMATH_NUMERICOPTNONE

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

None

Related Tables

F3015 Component Locator File