GetItemLocationDetail

Get Item Location Detail

Minor Business Rule

Object Name: B4100280

Parent DLL: COPBASE

Location: Client/Server

Language: C

Functional Description
Purpose

To retrieve data from the Item Location File (F41021) using the Pointer to the F41021 Record.


Setup Notes and Prerequisites

None


Special Logic

None


Technical Specification

Edits:

1.0.  If DS F41021 Pointer is not equal to NULL, return requested information from F41021.

Retrievals:

1)Item Location (F41021)
Primary Location - PBIN(out)

Lot Number- LOTN(out)

Business Unit- MCU(out)

Item Number- ITM(out)

Lot Status Code- LOTS(out)

Location- LOCN(out)

Qty On Hand- PQOH(out)

Qty on Purchase Order- PREQ(out)

Qty On Backorder- PBCK(out)

Qty Soft Committed- PCOM(out)

Qty Hard Committed- HCOM(out)

Qty On Future Commit- FCOM(out)

Qty WO Hard Commit- QOWO(out)

Units - In Transit- QTTR(out)

Units - In Inspection- QTIN(out)

Units - In Operation 1- QTO1(out)

Units - In Operation 2- QTO2(out)

Qty 1 - Other- OT1P(out)

Qty 2 - Other- OT2P(out)

Qty - Other Purchasing 1- OT1A(out)

Category - G/L- GLPT(out)

LastReceiptDate- LRCJ(out)



Returns:

1.) If the pointer to the F41021 record is not sent, return error '0002' (Record Invalid).
2.) If the Item Location Record is found, return the information from the record.


Data Structure

D4100280 - Get Item Location Detail

Parameters:
Data Item Data Structure DescriptionI/ORequired

GENLNGidF41021PointerI

EV01SuppressErrorMessagesI

PBINPrimaryLocationO

LOTNLotNumberO

MCUBusinessUnitO

ITMItemNumberShortO

DTAIErrorMessageIdO

LOTSLotStatusCodeO

LOCNLocationO

PQOHQtyOnHandO

PREQQtyOnPurchaseOrderO

PBCKQtyOnBackOrderO

PCOMQuantitySoftCommittedO

HCOMQtyHardCommittedO

FCOMQtyOnFutureCommitO

QOWOQuantityWOHardCommitO

QTTRUnitsInTransitO

QTINUnitsInInspectionO

QT01UnitsInOperation1O

QT02UnitsInOperation2O

OT1PQty1OtherO

OT2PQty2OtherO

OT1AQtyOtherPurchasing1O

GLPTGlCategoryO

FUN1WorkOrderSoftCommitO

QWBOQuantityOnReceiptO

LRCJLastReceiptDateO


^

Parameter NameData ItemData TypeReq/OptI/O/Both
idF41021PointerGENLNGIDNONENONE

General purpose ID variable.

cSuppressErrorMessagesEV01charNONENONE

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

cPrimaryLocationPBINcharNONENONE

A code that indicates whether this is the primary or secondary location for this item within this stocking location. Valid values are:    P Primary 
storage location    S Secondary storage location  Note:  You can only have one storage area marked as primary within each branch or 
warehouse. In some cases, the system uses the primary storage area as the default.

szLotNumberLOTNcharNONENONE

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

szBusinessUnitMCUcharNONENONE

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.

mnItemNumberShortITMMATH_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

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.

cLotStatusCodeLOTScharNONENONE

A user defined code (41/L) that indicates the status of the lot. If you leave this field blank, it indicates that the lot is approved. All other codes 
indicate that the lot is on hold. You can assign a different status code to each location in which a lot resides on Item/Location Information or 
Location Lot Status Change.

szLocationLOCNcharNONENONE

The storage location from which goods will be moved.

mnQtyOnHandPQOHMATH_NUMERICNONENONE

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

mnQtyOnPurchaseOrderPREQMATH_NUMERICNONENONE

The number of units specified on the purchase order in primary units of measure.

mnQtyOnBackOrderPBCKMATH_NUMERICNONENONE

The number of units backordered in primary units of measure.

mnQuantitySoftCommittedPCOMMATH_NUMERICNONENONE

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

mnQtyHardCommittedHCOMMATH_NUMERICNONENONE

The number of units committed to a specific location and lot.

mnQtyOnFutureCommitFCOMMATH_NUMERICNONENONE

The quantity on sales order whose requested shipment date is beyond the standard commitment period that has been specified in the 
Inventory Constants for that branch.  As an example, if you normally ship most orders within 90  days, then an order for an item with a requested 
ship date a year from now would have its quantity reflected in this field.

mnQuantityWOHardCommitQOWOMATH_NUMERICNONENONE

The number of units hard committed to work orders in the primary unit of measure.

mnUnitsInTransitQTTRMATH_NUMERICNONENONE

The quantity currently in transit from the supplier.

mnUnitsInInspectionQTINMATH_NUMERICNONENONE

The quantity currently being inspected.  This quantity has been received, but is not considered on hand.

mnUnitsInOperation1QT01MATH_NUMERICNONENONE

Quantity field in the Batch Receiver Destination Quantity table (F4012Z) that is used to process multiple ship to locations. This function is 
only valid for EDI transactions.

mnUnitsInOperation2QT02MATH_NUMERICNONENONE

Quantity field in the Batch Receiver File - Destination Quantity (F4012Z) that is used to process multiple ship to locations.  This is only a 
function valid for EDI transactions.

mnQty1OtherOT1PMATH_NUMERICNONENONE

The first of two quantities that can be specified as additional offsets (subtractions from on-hand) in the determination of quantities available 
for sale.  (Primary unit of measure)

mnQty2OtherOT2PMATH_NUMERICNONENONE

The second of two quantities that can be specified as additional offsets (subtractions from on-hand) in the determination of quantities 
available for sale.  (Primary unit of measure)

mnQtyOtherPurchasing1OT1AMATH_NUMERICNONENONE

The quantity that appears on documents such as bid requests, which are not formal commitments to buy on the part of your organization.

szGlCategoryGLPTcharNONENONE

A user defined code (41/9) that identifies the G/L offset that system uses when it searches for the account to which it posts the transaction. If 
you do not want to specify a class code, you can enter **** (four asterisks) in this field. You can use automatic accounting instructions (AAIs) to 
predefine classes of automatic offset accounts for the Inventory Management, Procurement, and Sales Order Management systems. You 
might assign G/L class codes as follows:    IN20   Direct Ship Orders    IN60   Transfer Orders    IN80   Stock Sales  The system can generate 
accounting entries based upon a single transaction. For example, a single sale of a stock item can trigger the generation of accounting entries 
similar to the following:         Sales-Stock (Debit) xxxxx.xx     A/R Stock Sales (Credit) xxxxx.xx     Posting Category: IN80             Stock Inventory 
(Debit) xxxxx.xx     Stock COGS (Credit) xxxxx.xx The system uses the class code and the document type to find the AAI.

mnWorkOrderSoftCommitFUN1MATH_NUMERICNONENONE

The number of units soft committed to Work Orders in the primary unit of measure.

mnQuantityOnReceiptQWBOMATH_NUMERICNONENONE

The number of units on work orders in primary units of measure.

jdLastReceiptDateLRCJJDEDATENONENONE

The date that the last shipment of the item was received.

mnQuantityOnLoanToManfacturingQONLMATH_NUMERICOPTNONE

mnQuantityInboundWarehouseQTRIMATH_NUMERICOPTNONE

A quantity in the primary unit of measure that you expect to add to the location detail after you confirm a putaway or replenishment 
suggestion.

mnQuantityOutboundWarehouseQTROMATH_NUMERICOPTNONE

A quantity in the primary unit of measure that you expect to remove from the location after you confirm a picking or replenishment 
suggestion.

mnFutureUseQuantityQTY1MATH_NUMERICOPTNONE

 Quantity for future use in the Item Location file (F4102).

mnFutureUseQuantity2QTY2MATH_NUMERICOPTNONE

 Quantity for future use in the Item Location file (F4102).

mnProjectHardCommittedPJCMMATH_NUMERICOPTNONE

The number of units committed to a specified location and lot for a project.

mnSecondaryQtyHardCommittedHCMSMATH_NUMERICOPTNONE

The number of units (expressed in the secondary unit of measure) that are hard-committed to a specific location and lot.

mnSecondaryProjectHardCommitPJDMMATH_NUMERICOPTNONE

The number of units committed to a specified location and lot for a project.

mnSecondaryQtySoftCommittedSCMSMATH_NUMERICOPTNONE

The number of units (expressed in the secondary unit of measure) that are soft-committed to sales orders or work orders.

mnSecondaryQtyInboundSIBWMATH_NUMERICOPTNONE

A quantity in the secondary unit of measure that you expect to add to the location detail after you confirm a putaway or replenishment 
suggestion.

mnSecondaryQtyOutboundSOBWMATH_NUMERICOPTNONE

The quantity (expressed in the secondary unit of measure) that you expect to remove from the location after you confirm a picking 
suggestion or replenishment suggestion.

mnSecondaryQtyOnHandSQOHMATH_NUMERICOPTNONE

The number of units on hand in secondary units of measure.

mnSecondaryQtyOnWOReceiptSQWOMATH_NUMERICOPTNONE

The number of units, expressed in the secondary unit of measure, that are specified on the work order.

mnSecondaryQtyOnPOSREQMATH_NUMERICOPTNONE

The number of units, expressed in the secondary unit of measure, that are specified on the purchase order.

mnSecondaryQtyWOHardCommittedSWHCMATH_NUMERICOPTNONE

The number of units, expressed in the secondary unit of measure, that are hard-committed to work orders.

mnSecondaryQtyWOSoftCommittedSWSCMATH_NUMERICOPTNONE

The number of units, expressed in the secondary unit of measure, that are soft-committed to work orders.

Related Functions

None

Related Tables

F41021 Item Location File