GetItmLocByCommitment

Get Itm Loc By Commitment

Major Business Rule

Object Name: B4000780

Parent DLL: CDIST

Location: Client/Server

Language: C

This function uses the Commitment Method (CMGL) passed in to retrieve records from the Item Location 
Table (F41021).  You can call this function in Initialization, Read and Close modes.  The 

Initialization mode will initialize the hRequest to the F41021 table, the fetch and return the first record from 

the table.  In Read mode, the next F41021 record will be fetched and returned.  Finally, in Close mode, 

no fetching will be performed but the hRequest and the F41021 pointer will be freed.  This function 

will optionally calculate and return the total quantity available for the item location retrieved

Data Structure

D4000780 - GetItmLocByCommitment

Parameter NameData ItemData TypeReq/OptI/O/Both
mnItemNumberITMMATH_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

szBranchMCUcharNONENONE

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.

cProcessModeEV01charNONENONE

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

cCommitmentMethodCMGLcharNONENONE

A code that indicates the method that the system uses to commit lot items from inventory. Valid codes are:    1   The normal commitment 
method for inventory. The system commits inventory from the primary location and then from secondary locations.        The system commits 
inventory from the locations with the most inventory before committing inventory from locations with the least. The system commits backorders to 
the primary location.    2   The inventory commitment method by lot number. The system commits inventory by lot number, starting with the 
lowest lot number and committing orders to available lots.    3   The inventory commitment method by lot expiration date. The system commits 
inventory from the locations with the earliest expiration date first. The system considers only locations with expiration dates greater than or equal 
to the sales order or parts list requested date.

cLotProcessingSRCEcharNONENONE

A code that indicates whether lot or serial number is assigned. Lot and serial number processes use the Lot Master table (F4108). Valid 
codes are:    0   Lot assignment is optional. You can manually assign numbers. Quantity can be greater than one. (Default)    1   Lot assignment is 
required. The system assigns numbers using the system date in YYMMDD format. Quantity can be greater than one.    2   Lot assignment is 
required. The system assigns numbers in ascending order using Next Numbers. Quantity can be greater than one.    3   Lot assignment is 
required. You must manually assign numbers. Quantity can be greater than one.    4   Serial number assignment is optional except during shipment 
confirmation. Quantity must not exceed one.    5   Serial number assignment is required. The system assigns numbers using the system date 
in YYMMDD format. Quantity must not exceed one.    6   Serial number assignment is required. The system assigns numbers in ascending 
order using Next Numbers. Quantity must not exceed one.    7   Serial number assignment is required. You must manually assign numbers. 
Quantity must not exceed one.

jdAsOfDateDATE01JDEDATENONENONE

Event point for JDE Date.

cCrossBranchBoundariesFLD1charNONENONE

An option that determines how the system commits inventory to a work order, and specifies the inventory location to which commitments are 
made. Valid values are: 1 Primary Location 2 Split-Cross Branch Boundaries 3 Split-Don't Cross Branch Boundaries Note: The system 
activates this field only when you create hard commitments. The three available options are as follows:   o  Primary Location. Make commitments to 
the primary location in the branch/plant where the work order originates.   o  Split-Cross Branch Boundaries. Split the parts list and 
commitments to fill any component shortages. The system can cross branch boundaries to fill requirements. In this case, the system uses the next 
alphabetical branch/plant listed in the table that occurs after the branch/plant on the work order header. For example, for the branch/plants CAL, 
CHI, CLE, and HOU: If the system starts committing inventory at branch/plant CHI, it accesses CLE as the next branch/plant. If inventory is low in 
all locations, the system makes the remaining commitments to the primary location of the branch/plant on the work order header.   o  
Split-Don't Cross Branch Boundaries. This option is similar to Split-Cross Branch Boundaries, but the system cannot cross branch boundaries. Note: 
When you set the Commitment Method field in the Item Branch/Plant table to 2 or 3 (lot number or expiration date control), you must use the 
Split-Don't Cross Branch Boundaries option.

idF41021hRequestGENLNGIDNONENONE

General purpose ID variable.

idF41021RecordPtrGENLNGIDNONENONE

General purpose ID variable.

idF4108hRequestGENLNGIDNONENONE

General purpose ID variable.

cReturnAvailableQtyEV02charNONENONE

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

szUnitOfMeasureUOMcharNONENONE

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

mnQuantityavailabilityQAVALMATH_NUMERICNONENONE

A number that indicates the quantity that is available. For example, the available quantity might consist of the on-hand quantity minus 
commitments, reservations, and backorders.  Availability is user defined. You can set up availability in the Branch/Plant Constants program (P41001).  

cSuppressErrorMessageEV03charNONENONE

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. 

szErrorMessageDTAIcharNONENONE

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.

cErrorCodeERRCcharNONENONE

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

mnQuantitySoftCommittedPCOMMATH_NUMERICNONENONE

The number of units soft committed to sales orders or work orders in the primary units of measure.

cSelectIfHCOMLTPQOHEV04charNONENONE

PeopleSoft event point processing flag 04.

cLotMasterValidateEV05charNONENONE

A flag that indicates whether automatic spell check is turned on.

mnQuantityOnHandPQOHMATH_NUMERICNONENONE

The number of units that are physically in stock. The system displays the quantity on-hand in the primary unit of measure.

mnDaysPastExpirationEXDPMATH_NUMERICOPTNONE

The number of days allowed before expiration for an item where it still can be used or sold to a specific customer.  When negative, this 
number indicates the number of days after expiration for an item where it still can be used or sold to a specific customer. For example, if the 
expiration date for item 1001 is 06/01/98:     o A value of 15 in Days Before Expiration means that this specific customer only accepts this item up to 
05/15/98.     o A value of -15 in Days Before Expiration means that this specific customer accepts this item up to 06/15/98.

szFromGradeFRGDcharOPTNONE

A user defined code (40/LG) that indicates the minimum grade that is acceptable for an item. The system displays a warning message if 
you try to purchase or issue items with grades that do not meet the minimum grade acceptable. The system does not allow you to sell items 
with grades that do not meet the minimum acceptable level.

szThruGradeTHGDcharOPTNONE

A user defined code (40/LG) that indicates the maximum grade that is acceptable for an item. The system displays a warning message if 
you try to purchase or issue items with grades that exceed the maximum grade acceptable. The system does not allow you to sell items with 
grades that exceed the maximum grade acceptable.

mnFromPotencyFRMPMATH_NUMERICOPTNONE

A number that indicates the minimum potency or percentage of active ingredients acceptable for an item. The system displays a warning 
message if you try to purchase or issue items that do not meet the minimum acceptable potency. The system does not allow you to sell items 
that do not meet the minimum acceptable potency.

mnThruPotencyTHRPMATH_NUMERICOPTNONE

A number that indicates the maximum potency or percentage of active ingredients that is acceptable for an item. The system displays a 
warning message if you try to purchase or issue items that have a potency that exceeds the maximum potency acceptable. The system does 
not allow you to sell items that have a potency that exceeds the maximum potency acceptable.

szItemMasterSecondaryUOMUOM2charOPTNONE

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

szInputSecondaryUOMUOM2charOPTNONE

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

cDualPickingProcessOptionDPPOcharOPTNONE

An option that determines for a dual unit of measure item whether the system uses the primary or secondary unit of measure for the following 
processes:   o Picking   o Sales order availability checking   o Committing inventory for sales   o Splitting purchase order lines  To use the 
primary unit of measure, do not choose this option. To use the secondary unit of measure, choose this option.

cCommitmentDateMethodCMDMcharOPTNONE

A user defined code (H40/CD) that specifies which date the system uses to commit inventory when an item is committed by date. The 
default value is 01 (lot expiration date). The date fields are stored in the Lot Master table (F4108).

cCallingApplicationEV01charOPTNONE

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

jdWorkOrderStartDateDATE01JDEDATEOPTNONE

Event point for JDE Date.

jdWorkOrderRequestDateDATE01JDEDATEOPTNONE

Event point for JDE Date.

cModeEV01charOPTNONE

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

szLocationLOCNcharOPTNONE

The storage location from which goods will be moved.

szTransUnitOfMeasureUOMcharOPTNONE

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

szLotGroupLOTGRPcharOPTNONE

Lot Group is the name of a user defined list of allowed non-blank lot status codes.  Entry of a Lot Group name in the Processing Option will 
allow this Application to process lots whose lot status code is defined within the specified Lot Group Name.  

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

cLPNMasterSwitchLPNMcharOPTNONE

A code that indicates whether  you want the system to use License Plate Numbers or not. Valid Codes are  0 No, do not use the License 
Plate Process  1 Yes, use the License Plate Process

Related Functions

B4000520 Get Item UoM Conversion Factor
B4101220 Calculate Availability

Related Tables

F41021 Item Location File
F4108 Lot Master