GetItemLedgerInfo

Verify and Get Item Ledger

Major Business Rule

Object Name: XF4111

Parent DLL: COPBASE

Location: Client/Server

Language: C

Data Structure

DXF4111C - Get Item Ledger Info

Parameter NameData ItemData TypeReq/OptI/O/Both
idItemLedgerPointerGENLNGIDNONENONE

General purpose ID variable.

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.

mnShortItemNumberITMMATH_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

Related Functions

B9800100 Get Audit Information

Related Tables

F4111 Item Ledger File
UpdateItemLedger

UpdateItemLedger

Verify and Get Item Ledger

Major Business Rule

Object Name: XF4111

Parent DLL: COPBASE

Location: Client/Server

Language: C

Functional Description

Purpose

This function updates teh Item Ledger table (F4111) for the specified key.

Setup Notes and Prerequisites

The pointer to the Item Ledger record (GENLNG) is a required input parameter.


Technical Specification


This function uses the pointer passed in to retrieve the record.  The Program Id (PID), Parent Lot 

(PLOT), Kit Short Item Number (KIT), and Branch/Plant (MMCU) are updated to the database for this 

record. 



Data Structure

DXF4111B - Update Item Ledger

Parameter NameData ItemData TypeReq/OptI/O/Both
idItemLedgerPointerGENLNGIDNONENONE

General purpose ID variable.

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.

szParentLotPLOTcharNONENONE

An inventory separation device that allows tracking of the inventory by date received or similar convention to control lots or layers.

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

szBranchPlantMMCUcharNONENONE

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

B9800100 Get Audit Information

Related Tables

F4111 Item Ledger File
VerifyandGetItemLedger

VerifyandGetItemLedger

Verify and Get Item Ledger

Major Business Rule

Object Name: XF4111

Parent DLL: COPBASE

Location: Client/Server

Language: C

Functional Description

Purpose

This function verifies if an Item Ledger record (F4111) exists.

Setup Notes and Prerequisites

The Call Type (EV01), Index (CDL) and Keys (CDL) are required input parameters.


Index and Keys are used as follows:


IndexKeys


1UKID
2DOC, DCT, KCO, DGL, JELN

3DOC, DCT, KCO, LNID, DGL

4DOCO, DCTO, KCOO, LNID, DGL

5ITM, MCU, TRDJ


Technical Specification


This function verifies if an Item Ledger (F4111) record exists based on the index and keys, and 

returns a pointer to the Item Ledger Record if the Return Pointer Flag = '1'.  If Call Type = '1', and the 

record was not found, an error is issued.  If Call Type = '2', and a record was found, an error is 

issued.

Data Structure

DXF4111A - Verify and Get Item Ledger

Parameter NameData ItemData TypeReq/OptI/O/Both
mnUniqueKeyIDUKIDMATH_NUMERICNONENONE

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

mnDocumentNumberDOCMATH_NUMERICNONENONE

A number that identifies the original document, such as a voucher, invoice, or journal entry. On entry forms, you can assign the document 
number or let the system assign it using the Next Numbers program (P0002). Matching document numbers (DOCM) identify related documents 
in the Accounts Receivable and Accounts Payable systems. Examples of original and matching documents are: Accounts Payable     o 
Original document - voucher     o Matching document - payment  Accounts Receivable     o Original document - invoice     o Matching document - 
receipt  Note: In the Accounts Receivable system, the following transactions simultaneously generate original and matching documents: 
deductions, unapplied receipts, chargebacks, and drafts.

szDocumentTypeDCTcharNONENONE

A user defined code (00/DT) that identifies the origin and purpose of the transaction.  PeopleSoft reserves several prefixes for document 
types, such as, vouchers, invoices, receipts, and timesheets. The reserved document type prefixes for codes are: P Accounts payable 
documents R Accounts receivable documents  T Time and Pay documents I Inventory documents  O Purchase order documents  S Sales order 
documents 

szDocumentCompanyKCOcharNONENONE

A number that, with the document number, document type and G/L date, uniquely identifies an original document, such as invoice, voucher, 
or journal entry. If you use the Next Numbers by Company/Fiscal Year feature, the Automatic Next Numbers program (X0010) uses the 
document company to retrieve the correct next number for that company. If two or more original documents have the same document number and 
document type, you can use the document company to locate the desired document.

jdDateGLDGLJDEDATENONENONE

A date that identifies the financial period to which the transaction is to be posted.  The company constants specify the date range for each 
financial period. You can have as many as 14 periods. Generally, period 14 is used for audit adjustments. The system validates this field for 
PBCO (posted before cutoff), PYEB (prior year ending balance), PACO (post after cutoff), and WACO (post way after cutoff) messages.

mnJournalEntryLineNumberJELNMATH_NUMERICNONENONE

A number that designates a line within a journal entry. The system uses this field to sequence the journal entry lines for inquiry purposes.

mnLineNumberLNIDMATH_NUMERICNONENONE

A number that identifies multiple occurrences, such as line numbers on a purchase order or other document. Generally, the system assigns 
this number,but in some cases you can override it.

mnOrderNumberDOCOMATH_NUMERICNONENONE

A number that identifies an original document. This document can be a voucher, a sales order, an invoice, unapplied cash, a journal entry, 
and so on.

szOrderTypeDCTOcharNONENONE

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

szOrderCompanyKCOOcharNONENONE

A number that, along with order number and order type, uniquely identifies an order document (such as a purchase order, a contract, a 
sales order, and so on). If you use the Next Numbers by Company/Fiscal Year facility, the Automatic Next Numbers program (X0010) uses the 
order company to retrieve the correct next number for that company. If two or more order documents have the same order number and order 
type, the order company lets you locate the desired document. If you use the regular Next Numbers facility, the order company is not used to 
assign a next number. In this case, you probably would not use the order company to locate the document.

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

szBranchPlantMMCUcharNONENONE

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.

jdOrderDateTRDJJDEDATENONENONE

The date that an order was entered into the system. This date determines which effective level the system uses for inventory pricing.

cCallTypeEV01charNONENONE

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

cSuppressErrorMessagesFlagEV01charNONENONE

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

mnIndexCDLMATH_NUMERICNONENONE

The length of the user defined code. It cannot be greater than 10 characters.

mnKeysCDLMATH_NUMERICNONENONE

The length of the user defined code. It cannot be greater than 10 characters.

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.

idFilePointerGENLNGIDNONENONE

General purpose ID variable.

cReturnPointerFlagEV01charNONENONE

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

Related Functions

B9800100 Get Audit Information

Related Tables

F4111 Item Ledger File