FreePointerToItemMaster

Validate and Retrieve Item Master

Minor Business Rule

Object Name: X4101

Parent DLL: COPBASE

Location: Client/Server

Language: C

Data Structure

DX4101F - Free Pointer to F4101 Item Master

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
idF4101PointerGenericLong	GENLNG	ID	OPT	NONE
General purpose ID variable.
cErrorFlag	ERR	char	OPT	NONE
The Data Field Error Code field is simply a generic data field to pass an error condition flag. This field is one of the fields that make up the external parameter data structure of the Data Dictionary Server.

Related Functions

B4000150 Get Branch Constants

Related Tables

F41001 Inventory Constants
F4101 Item Master

GetItemMasterBy2ndItem

Validate and Retrieve Item Master

Major Business Rule

Object Name: X4101

Parent DLL: COPBASE

Location: Client/Server

Language: C

Tupelo Wilco Son Volt
Functional Description

Purpose
The purpose of this function is to retrieve the Item Master Record using the second item number
(LITM).

Setup Notes and Prerequisites
This function returns a pointer to the Item Master Record that is stored in memory. The application
needs to define a pointer data item (e.g. GENLNG) to store this pointer.
The pointer MUST be freed using the function "Free Pointer to Data Structure" to avoid memory leaks.

Technical Specification
• Fetch row from Item Master using the Second Item Number as the key.
• If the fetch fails then sets error code 0267.
• Error codes are only set using jdeSetGBRError if the SuppressErrorMessages is not equal to '1'.
• Returns the pointer to the item master data structure if the record is found, otherwise returns the
first error message set on in the function.
'b7'b7'b7

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
sz2ndItemNumber	LITM	char	NONE	NONE
A number that identifies the item. The system provides three separate item numbers plus an extensive cross-reference capability to alternative item numbers. The three types of item numbers are: Item Number (short) An 8-digit, computer-assigned item number. 2nd Item Number A 25-digit, user defined, alphanumeric item number. 3rd Item Number Another 25-digit, user defined, alphanumeric item number. In addition to these three basic item numbers, the system provides an extensive cross-reference search capability. You can define numerous cross-references to alternative part numbers. For example, you can define substitute item numbers, replacements, bar codes, customer numbers, or supplier numbers.
idF4101LongRowPtr	GENLNG	ID	NONE	NONE
General purpose ID variable.
cErrorCode	ERRC	char	NONE	NONE
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).
cReturnPtr	EV01	char	NONE	NONE
An option that specifies the type of processing for an event.
cSuppressErrorMsg	EV02	char	NONE	NONE
An option that specifies the type of processing for an event.
szErrorMsgID	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.
szDescription1	DSC1	char	NONE	NONE
Brief information about an item; a remark or an explanation.
szDescription2	DSC2	char	NONE	NONE
A second, 30-character description, remark, or explanation.
mnShortItemNumber	ITM	MATH_NUMERIC	NONE	NONE
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
sz3rdItemNumber	AITM	char	NONE	NONE
The system provides three separate item numbers plus an extensive cross-reference capability to alternate item numbers. These item numbers are as follows: 1. Item Number (short) - An 8-digit, computer-assigned 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. In addition to these three basic item numbers, an extensive cross-reference search capability has been provided (see XRT). Numerous cross references to alternate part numbers can be user defined, such as substitute item numbers, replacements, bar codes, customer numbers, or supplier numbers.
szItemFlashMessage	IFLA	char	NONE	NONE
User defined code system 40, type FL, which is used to flash a warning message about a particular item.
szAlternateDesc1	DSC1	char	NONE	NONE
Brief information about an item; a remark or an explanation.
szAlternateDesc2	DSC2	char	NONE	NONE
A second, 30-character description, remark, or explanation.
szLngPref	LNGP	char	NONE	NONE
A user defined code (01/LP) that specifies the language to use on forms and printed reports. Before you specify a language, a code for that language must exist at either the system level or in your user preferences.
cLngPrefType	EV01	char	NONE	NONE
An option that specifies the type of processing for an event.
szStandardUOMConversion	TFLA	char	NONE	NONE
Allows you to bypass the item-specific unit of measure and use the standard unit of measure. Valid values are: blank Use the item-specific unit of measure 1 Bypass the item-specific unit of measure and use the standard unit of measure
szTemplate	TMPL	char	OPT	NONE
A template name that you can use when entering items on Item Master Revisions (P4101). This name is case sensitive. If you use any capital letters in the template name when you add it, you must enter those letters in capitals whenever you search for or attach the template to Item Master Revisions.
szSegment1	SEG1	char	OPT	NONE
The first section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment2	SEG2	char	OPT	NONE
The second section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment3	SEG3	char	OPT	NONE
The third section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment4	SEG4	char	OPT	NONE
The fourth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment5	SEG5	char	OPT	NONE
The fifth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment6	SEG6	char	OPT	NONE
The sixth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment7	SEG7	char	OPT	NONE
The seventh section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment8	SEG8	char	OPT	NONE
The eighth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment9	SEG9	char	OPT	NONE
The ninth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment10	SEG0	char	OPT	NONE
The tenth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
cMatrixControlled	MIC	char	OPT	NONE
A user defined code (41/MA) that specifies the relationship between a matrix item and its parent. This code also determines whether the system displays the item in matrix detail information.

Data Structure

DX4101C - Get Item Master By 2nd Item

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

sz2ndItemNumber LITM char NONE NONE

A number that identifies the item. The system provides three separate item numbers plus an extensive cross-reference capability to
alternative item numbers. The three types of item numbers are: Item Number (short) An 8-digit, computer-assigned item number. 2nd Item Number A
25-digit, user defined, alphanumeric item number. 3rd Item Number Another 25-digit, user defined, alphanumeric item number. In addition to
these three basic item numbers, the system provides an extensive cross-reference search capability. You can define numerous
cross-references to alternative part numbers. For example, you can define substitute item numbers, replacements, bar codes, customer numbers, or
supplier numbers.

idF4101LongRowPtr GENLNG ID NONE NONE

General purpose ID variable.

cErrorCode ERRC char NONE NONE

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

cReturnPtr EV01 char NONE NONE

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

cSuppressErrorMsg EV02 char NONE NONE

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

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

szDescription1 DSC1 char NONE NONE

Brief information about an item; a remark or an explanation.

szDescription2 DSC2 char NONE NONE

A second, 30-character description, remark, or explanation.

mnShortItemNumber ITM MATH_NUMERIC NONE NONE

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

sz3rdItemNumber AITM char NONE NONE

The system provides three separate item numbers plus an extensive cross-reference capability to alternate item numbers. These item
numbers are as follows: 1.  Item Number (short) - An 8-digit, computer-assigned 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. In addition to
these three basic item numbers, an extensive cross-reference search capability has been provided (see XRT). Numerous cross references to
alternate part numbers can be user defined, such as substitute item numbers, replacements, bar codes, customer numbers, or supplier
numbers.

szItemFlashMessage IFLA char NONE NONE

User defined code system 40, type FL, which is used to flash a warning message about a particular item.

szAlternateDesc1 DSC1 char NONE NONE

Brief information about an item; a remark or an explanation.

szAlternateDesc2 DSC2 char NONE NONE

A second, 30-character description, remark, or explanation.

szLngPref LNGP char NONE NONE

A user defined code (01/LP) that specifies the language to use on forms and printed reports. Before you specify a language, a code for that
language must exist at either the system level or in your user preferences.

cLngPrefType EV01 char NONE NONE

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

szStandardUOMConversion TFLA char NONE NONE

Allows you to bypass the item-specific unit of measure and use the standard unit of measure. Valid values are:    blank Use the item-specific
unit of measure    1       Bypass the item-specific unit of measure and use the standard unit of measure

szTemplate TMPL char OPT NONE

A template name that you can use when entering items on Item Master Revisions (P4101). This name is case sensitive. If you use any
capital letters in the template name when you add it, you must enter those letters in capitals whenever you search for or attach the template to Item
Master Revisions.

szSegment1 SEG1 char OPT NONE

The first section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment2 SEG2 char OPT NONE

The second section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not
exceed 25 characters.

szSegment3 SEG3 char OPT NONE

The third section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment4 SEG4 char OPT NONE

The fourth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment5 SEG5 char OPT NONE

The fifth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment6 SEG6 char OPT NONE

The sixth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment7 SEG7 char OPT NONE

The seventh section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not
exceed 25 characters.

szSegment8 SEG8 char OPT NONE

The eighth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not
exceed 25 characters.

szSegment9 SEG9 char OPT NONE

The ninth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment10 SEG0 char OPT NONE

The tenth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

cMatrixControlled MIC char OPT NONE

A user defined code (41/MA) that specifies the relationship between a matrix item and its parent. This code also determines whether the
system displays the item in matrix detail information.

Related Functions

B4000150 Get Branch Constants

Related Tables

F41001 Inventory Constants

F4101 Item Master

GetItemMasterBy3rdItem
GetItemMasterBy3rdItem

Validate and Retrieve Item Master

Major Business Rule

Object Name: X4101

Parent DLL: COPBASE

Location: Client/Server

Language: C

Functional Description

Purpose
The purpose of this function is to retrieve the Item Master Record using the third item number
(AITM).

Setup Notes and Prerequisites
This function returns a pointer to the Item Master Record that is stored in memory.  The application
needs to define a pointer data item (e.g. GENLNG) to store this pointer.
The pointer MUST be freed using the function "Free Pointer to Data Structure" to avoid memory leaks.

Technical Specification
• Fetch row from Item Master using the Third Item Number as the key.
• If the fetch fails then sets error code 0267.
• Error codes are only set using jdeSetGBRError if the SuppressErrorMessages is not equal to '1'.
• Returns the pointer to the item master data structure if the record is found, otherwise returns the
first error message set on in the function.

Data Structure

DX4101D - Get Item Master By 3rd Item

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

sz3rdItemNumber AITM char NONE NONE

The system provides three separate item numbers plus an extensive cross-reference capability to alternate item numbers. These item
numbers are as follows: 1.  Item Number (short) - An 8-digit, computer-assigned 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. In addition to
these three basic item numbers, an extensive cross-reference search capability has been provided (see XRT). Numerous cross references to
alternate part numbers can be user defined, such as substitute item numbers, replacements, bar codes, customer numbers, or supplier
numbers.

idF4101LongRowPtr GENLNG ID NONE NONE

General purpose ID variable.

cErrorCode ERRC char NONE NONE

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

cReturnPtr EV01 char NONE NONE

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

cSuppressErrorMsg EV02 char NONE NONE

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

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

szDescription1 DSC1 char NONE NONE

Brief information about an item; a remark or an explanation.

szDescription2 DSC2 char NONE NONE

A second, 30-character description, remark, or explanation.

sz2ndItemNumber LITM char NONE NONE

A number that identifies the item. The system provides three separate item numbers plus an extensive cross-reference capability to
alternative item numbers. The three types of item numbers are: Item Number (short) An 8-digit, computer-assigned item number. 2nd Item Number A
25-digit, user defined, alphanumeric item number. 3rd Item Number Another 25-digit, user defined, alphanumeric item number. In addition to
these three basic item numbers, the system provides an extensive cross-reference search capability. You can define numerous
cross-references to alternative part numbers. For example, you can define substitute item numbers, replacements, bar codes, customer numbers, or
supplier numbers.

szItemFlashMessage IFLA char NONE NONE

User defined code system 40, type FL, which is used to flash a warning message about a particular item.

szAlternateDesc1 DSC1 char NONE NONE

Brief information about an item; a remark or an explanation.

szAlternateDesc2 DSC2 char NONE NONE

A second, 30-character description, remark, or explanation.

szLngPref LNGP char NONE NONE

A user defined code (01/LP) that specifies the language to use on forms and printed reports. Before you specify a language, a code for that
language must exist at either the system level or in your user preferences.

cLngPrefType EV01 char NONE NONE

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

mnShortItemNumber ITM MATH_NUMERIC NONE NONE

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

szStandardUOMConversion TFLA char NONE NONE

Allows you to bypass the item-specific unit of measure and use the standard unit of measure. Valid values are:    blank Use the item-specific
unit of measure    1       Bypass the item-specific unit of measure and use the standard unit of measure

szTemplate TMPL char OPT NONE

A template name that you can use when entering items on Item Master Revisions (P4101). This name is case sensitive. If you use any
capital letters in the template name when you add it, you must enter those letters in capitals whenever you search for or attach the template to Item
Master Revisions.

szSegment1 SEG1 char OPT NONE

The first section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment2 SEG2 char OPT NONE

The second section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not
exceed 25 characters.

szSegment3 SEG3 char OPT NONE

The third section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment4 SEG4 char OPT NONE

The fourth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment5 SEG5 char OPT NONE

The fifth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment6 SEG6 char OPT NONE

The sixth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment7 SEG7 char OPT NONE

The seventh section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not
exceed 25 characters.

szSegment8 SEG8 char OPT NONE

The eighth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not
exceed 25 characters.

szSegment9 SEG9 char OPT NONE

The ninth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment10 SEG0 char OPT NONE

The tenth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

cMatrixControlled MIC char OPT NONE

A user defined code (41/MA) that specifies the relationship between a matrix item and its parent. This code also determines whether the
system displays the item in matrix detail information.

Related Functions

B4000150 Get Branch Constants

Related Tables

F41001 Inventory Constants

F4101 Item Master

GetItemMasterByShortItem
GetItemMasterByShortItem

Validate and Retrieve Item Master

Major Business Rule

Object Name: X4101

Parent DLL: COPBASE

Location: Client/Server

Language: C

Functional Description

Purpose
The purpose of this function is to retrieve the Item Master Record using the short item number (ITM).

Setup Notes and Prerequisites
This function returns a pointer to the Item Master Record that is stored in memory.  The application
needs to define a pointer data item (e.g. GENLNG) to store this pointer.
The pointer MUST be freed using the function "Free Pointer to Data Structure" to avoid memory leaks.

Technical Specification

• Fetch row from Item Master using the Short Item Number as the key.
• If the fetch fails then sets error code 0267.
• Error codes are only set using jdeSetGBRError if the SuppressErrorMessages is not equal to '1'.
• Returns the pointer to the item master data structure if the record is found, otherwise returns the
first error message encountered.
'b7'b7'b7

Data Structure

DX4101B - Get Item Master By Short Item

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

mnShortItemNumber ITM MATH_NUMERIC NONE NONE

^

idF4101LongRowPtr GENLNG ID NONE NONE

General purpose ID variable.

cErrorCode ERRC char NONE NONE

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

cReturnPtr EV01 char NONE NONE

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

cSuppressErrorMsg EV02 char NONE NONE

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

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

szDescription1 DSC1 char NONE NONE

Brief information about an item; a remark or an explanation.

szDescription2 DSC2 char NONE NONE

A second, 30-character description, remark, or explanation.

sz2ndItemNumber LITM char NONE NONE

A number that identifies the item. The system provides three separate item numbers plus an extensive cross-reference capability to
alternative item numbers. The three types of item numbers are: Item Number (short) An 8-digit, computer-assigned item number. 2nd Item Number A
25-digit, user defined, alphanumeric item number. 3rd Item Number Another 25-digit, user defined, alphanumeric item number. In addition to
these three basic item numbers, the system provides an extensive cross-reference search capability. You can define numerous
cross-references to alternative part numbers. For example, you can define substitute item numbers, replacements, bar codes, customer numbers, or
supplier numbers.

sz3rdItemNumber AITM char NONE NONE

The system provides three separate item numbers plus an extensive cross-reference capability to alternate item numbers. These item
numbers are as follows: 1.  Item Number (short) - An 8-digit, computer-assigned 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. In addition to
these three basic item numbers, an extensive cross-reference search capability has been provided (see XRT). Numerous cross references to
alternate part numbers can be user defined, such as substitute item numbers, replacements, bar codes, customer numbers, or supplier
numbers.

szItemFlashMessage IFLA char NONE NONE

User defined code system 40, type FL, which is used to flash a warning message about a particular item.

szAlternateDesc1 DSC1 char NONE NONE

Brief information about an item; a remark or an explanation.

szAlternateDesc2 DSC2 char NONE NONE

A second, 30-character description, remark, or explanation.

szLngPref LNGP char NONE NONE

A user defined code (01/LP) that specifies the language to use on forms and printed reports. Before you specify a language, a code for that
language must exist at either the system level or in your user preferences.

cLngPrefType EV01 char NONE NONE

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

szStandardUOMConversion TFLA char NONE NONE

Allows you to bypass the item-specific unit of measure and use the standard unit of measure. Valid values are:    blank Use the item-specific
unit of measure    1       Bypass the item-specific unit of measure and use the standard unit of measure

szTemplate TMPL char OPT NONE

A template name that you can use when entering items on Item Master Revisions (P4101). This name is case sensitive. If you use any
capital letters in the template name when you add it, you must enter those letters in capitals whenever you search for or attach the template to Item
Master Revisions.

szSegment1 SEG1 char OPT NONE

The first section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment2 SEG2 char OPT NONE

The second section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not
exceed 25 characters.

szSegment3 SEG3 char OPT NONE

The third section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment4 SEG4 char OPT NONE

The fourth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment5 SEG5 char OPT NONE

The fifth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment6 SEG6 char OPT NONE

The sixth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment7 SEG7 char OPT NONE

The seventh section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not
exceed 25 characters.

szSegment8 SEG8 char OPT NONE

The eighth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not
exceed 25 characters.

szSegment9 SEG9 char OPT NONE

The ninth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment10 SEG0 char OPT NONE

The tenth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

cMatrixControlled MIC char OPT NONE

A user defined code (41/MA) that specifies the relationship between a matrix item and its parent. This code also determines whether the
system displays the item in matrix detail information.

Related Functions

B4000150 Get Branch Constants

Related Tables

F41001 Inventory Constants

F4101 Item Master

GetItemMasterUsingItemRevLevel
GetItemMasterUsingItemRevLevel

Validate and Retrieve Item Master

Major Business Rule

Object Name: X4101

Parent DLL: COPBASE

Location: Client/Server

Language: C

Data Structure

DX4101G - Get Item Master Using Item Revision Level

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

szItemNoUnknownFormat UITM char REQ INPUT

A number that the system assigns to an item. It can be in short, long, or third item number format.

szBranchPlant MCU char REQ INPUT

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.

mnAddressNumber AN8 MATH_NUMERIC OPT INPUT

A number that identifies an entry in the Address Book system, such as employee, applicant, participant, customer, supplier, tenant, or
location.

mnIdentifierShortItem ITM MATH_NUMERIC OPT OUTPUT

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

szItemRevLevel CIRV char OPT INPUT

A reference number used to identify the revision level of the customer's item.   In item cross-reference, translating a customer or supplier
external item number to the internal short item number, the customer's number only is not always sufficient. In some instances, the customer part
number must be used in conjunction with the item revision level. This combination will allow the system to uniquely identify the customer's
item.

szCrossRefTypeOverride XRT char OPT INPUT

A user defined code (41/DT) that identifies the type of cross-reference set up for this customer. Examples of cross-reference types include:
o Substitutes     o Replacements     o Bar codes     o Customer item numbers     o Supplier item numbers

cCrossRefMode MODE char OPT INPUT

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

jdDateExpiredJulian1 EXDJ JDEDATE REQ INPUT

The date on which a transaction, text message, agreement, obligation, or preference has expired or been completed.

cSuppressErrorMessage SUPPS char OPT INPUT

A flag indicating whether or not runtime error messaging will occur when an error message is issued from a business function.        0 = allow
runtime error message handling.        1 = suppress runtime error message handling.

szDescription1 DSC1 char OPT OUTPUT

Brief information about an item; a remark or an explanation.

szDescription2 DSC2 char OPT OUTPUT

A second, 30-character description, remark, or explanation.

idF4101Pointer GENLNG ID OPT BOTH

General purpose ID variable.

cSymbolIdentifier SYMID char OPT OUTPUT

szIdentifier2ndItem LITM char OPT OUTPUT

A number that identifies the item. The system provides three separate item numbers plus an extensive cross-reference capability to
alternative item numbers. The three types of item numbers are: Item Number (short) An 8-digit, computer-assigned item number. 2nd Item Number A
25-digit, user defined, alphanumeric item number. 3rd Item Number Another 25-digit, user defined, alphanumeric item number. In addition to
these three basic item numbers, the system provides an extensive cross-reference search capability. You can define numerous
cross-references to alternative part numbers. For example, you can define substitute item numbers, replacements, bar codes, customer numbers, or
supplier numbers.

szIdentifier3rdItem AITM char OPT OUTPUT

The system provides three separate item numbers plus an extensive cross-reference capability to alternate item numbers. These item
numbers are as follows: 1.  Item Number (short) - An 8-digit, computer-assigned 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. In addition to
these three basic item numbers, an extensive cross-reference search capability has been provided (see XRT). Numerous cross references to
alternate part numbers can be user defined, such as substitute item numbers, replacements, bar codes, customer numbers, or supplier
numbers.

cErrorCode ERRC char OPT OUTPUT

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

szLanguagePreference LNGP char OPT INPUT

A user defined code (01/LP) that specifies the language to use on forms and printed reports. Before you specify a language, a code for that
language must exist at either the system level or in your user preferences.

szSystemCode SY char OPT INPUT

A user defined code (98/SY) that identifies a system. Valid values include: 01 Address Book 03B Accounts Receivable 04 Accounts
Payable 09 General Accounting 11 Multicurrency

szItemFlashMessage IFLA char OPT OUTPUT

User defined code system 40, type FL, which is used to flash a warning message about a particular item.

szBaseLongDescription1 DSC1 char OPT OUTPUT

Brief information about an item; a remark or an explanation.

szBaseLongDescription2 DSC2 char OPT OUTPUT

A second, 30-character description, remark, or explanation.

szStdUOMConversion TFLA char OPT OUTPUT

Allows you to bypass the item-specific unit of measure and use the standard unit of measure. Valid values are:    blank Use the item-specific
unit of measure    1       Bypass the item-specific unit of measure and use the standard unit of measure

szTemplate TMPL char OPT OUTPUT

A template name that you can use when entering items on Item Master Revisions (P4101). This name is case sensitive. If you use any
capital letters in the template name when you add it, you must enter those letters in capitals whenever you search for or attach the template to Item
Master Revisions.

szSegment1 SEG1 char OPT OUTPUT

The first section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment2 SEG2 char OPT OUTPUT

The second section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not
exceed 25 characters.

szSegment3 SEG3 char OPT OUTPUT

The third section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment4 SEG4 char OPT OUTPUT

The fourth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment5 SEG5 char OPT OUTPUT

The fifth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment6 SEG6 char OPT OUTPUT

The sixth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment7 SEG7 char OPT OUTPUT

The seventh section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not
exceed 25 characters.

szSegment8 SEG8 char OPT OUTPUT

The eighth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not
exceed 25 characters.

szSegment9 SEG9 char OPT OUTPUT

The ninth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment10 SEG0 char OPT OUTPUT

The tenth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

cMatrixControlled MIC char OPT OUTPUT

A user defined code (41/MA) that specifies the relationship between a matrix item and its parent. This code also determines whether the
system displays the item in matrix detail information.

cReturnPtr REQPTRBK char OPT INPUT

An option that indicates whether the system retrieves all fields or only certain fields from a table. If you do not choose this option, the system
retrieves only certain fields.

cCallType CALLTYP char OPT INPUT

A code that indicates whether the system uses the customer cross-reference type or the supplier cross-reference type. Valid values
are: 1 Customer cross-reference type 2 Supplier cross-reference type

cLangPrefTyp LNGPRFTYP char OPT INPUT

A code that specifies whether the system uses the User Language preference or a Language Preference override to retrieve the alternate
description from the Item Master - Alternative Description table (F4101D). Valid values are: Blank The system uses the User Language
preference. 1 The system uses the Language Preference override.

szErrorMsgID DTAI char OPT OUTPUT

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.

idF41001Ptr GENLNG ID OPT BOTH

General purpose ID variable.

cRevisionLevelFlag REVLVLFLG char OPT INPUT

An option that determines whether the system uses the customer item revision level to retrieve records from the Item Cross Reference File
table (F4104). If you do not choose this option, the system does not use the customer item revision level.

Related Functions

B4000150 Get Branch Constants

Related Tables

F41001 Inventory Constants

F4101 Item Master

ReturnPrimaryItemNumber
ReturnPrimaryItemNumber

Validate and Retrieve Item Master

Major Business Rule

Object Name: X4101

Parent DLL: COPBASE

Location: Client/Server

Language: C

Data Structure

DX4101E - Return Primary Item Number

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

mnShortItemNumber ITM MATH_NUMERIC NONE NONE

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

sz2ndItemNumber LITM char NONE NONE

A number that identifies the item. The system provides three separate item numbers plus an extensive cross-reference capability to
alternative item numbers. The three types of item numbers are: Item Number (short) An 8-digit, computer-assigned item number. 2nd Item Number A
25-digit, user defined, alphanumeric item number. 3rd Item Number Another 25-digit, user defined, alphanumeric item number. In addition to
these three basic item numbers, the system provides an extensive cross-reference search capability. You can define numerous
cross-references to alternative part numbers. For example, you can define substitute item numbers, replacements, bar codes, customer numbers, or
supplier numbers.

sz3rdItemNumber AITM char NONE NONE

The system provides three separate item numbers plus an extensive cross-reference capability to alternate item numbers. These item
numbers are as follows: 1.  Item Number (short) - An 8-digit, computer-assigned 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. In addition to
these three basic item numbers, an extensive cross-reference search capability has been provided (see XRT). Numerous cross references to
alternate part numbers can be user defined, such as substitute item numbers, replacements, bar codes, customer numbers, or supplier
numbers.

cSymbolShortItem SYM1 char NONE NONE

A symbol that identifies the 8-character short item number when you do not want to use it as the primary number. A blank in this field
indicates that you want to use this item number as the primary number. That is, you use it most often to enter or review information. If this is not the
primary number, you must enter a special symbol to identify it. Use a symbol that is not significant for any other purposes of entry such as /, *, or &.
Do not use a period or a comma as a symbol. When you enter this item number on any other form, you must include this symbol as the first
character. NOTE: Only one of the fields for item number symbols (SYM1, SYM2, SYM3, or SYM6) can be blank to identify it as the primary
number. All others must include a unique symbol.

cSymbol2ndItem SYM2 char NONE NONE

A symbol that identifies the 25-character second item number when you do not want to use it as the primary number. A blank in this field
indicates that you want to use this item number as the primary number. That is, you use it most often to enter or review information. If this is not the
primary number, you must enter a special symbol to identify it. Use a symbol that is not significant for any other purposes of entry such as /, *,
or &. Do not use a period or a comma as a symbol. When you enter this item number on any other form, you must include this symbol as the
first character. NOTE: Only one of the fields for item number symbols (SYM1, SYM2, SYM3, or SYM6) can be blank to identify it as the primary
number. All others must include a unique symbol.

cSymbol3rdItem SYM3 char NONE NONE

A symbol that identifies the 25-character third item number when you do not want to use it as the primary number. A blank in this field
indicates that you want to use this item number as the primary number. That is, you use it most often to enter or review information. If this is not the
primary number, you must enter a special symbol to identify it. Use a symbol that is not significant for any other purposes of entry such as /, *, or &.
Do not use a period or a comma as a symbol. When you enter this item number on any other form, you must include this symbol as the first
character. Note: Only one of the fields for item number symbols (SYM1, SYM2, SYM3, or SYM6) can be blank to identify it as the primary
number. All others must include a unique symbol.

szBranchPlant MCU char NONE NONE

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.

szPrimaryItemNumber UITM char NONE NONE

A number that the system assigns to an item. It can be in short, long, or third item number format.

cSymbolidentifier SYMID char NONE NONE

cErrorCode ERRC char NONE NONE

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

cSuppressErrorMsg EV01 char NONE NONE

Significant Data Values
Blank/0 - The function will set on any errors found and add them to the error list.
1       - The function will NOT set on any errors found.  All error messages are suppressed.  The
first error message-id that is found will be returned in the ErrorMessageID parameter.

^

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

idPtrToF41001Record GENLNG ID NONE NONE

Special Input Expected
OPTIONAL PARAMETER.
If available in the application, the pointer to the Branch/Constants data structure may be used.  The
function will reference memory instead of performing a fetch to the Branch/Constants to retrieve the
item symbol identifiers.
^

szTemplate TMPL char OPT NONE

A template name that you can use when entering items on Item Master Revisions (P4101). This name is case sensitive. If you use any
capital letters in the template name when you add it, you must enter those letters in capitals whenever you search for or attach the template to Item
Master Revisions.

szSegment1 SEG1 char OPT NONE

The first section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment2 SEG2 char OPT NONE

The second section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not
exceed 25 characters.

szSegment3 SEG3 char OPT NONE

The third section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment4 SEG4 char OPT NONE

The fourth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment5 SEG5 char OPT NONE

The fifth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment6 SEG6 char OPT NONE

The sixth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment7 SEG7 char OPT NONE

The seventh section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not
exceed 25 characters.

szSegment8 SEG8 char OPT NONE

The eighth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not
exceed 25 characters.

szSegment9 SEG9 char OPT NONE

The ninth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment10 SEG0 char OPT NONE

The tenth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

cMatrixControlled MIC char OPT NONE

A user defined code (41/MA) that specifies the relationship between a matrix item and its parent. This code also determines whether the
system displays the item in matrix detail information.

cSymToIdentSegItem SYM6 char OPT NONE

cSegmentSeparator SEPS char OPT NONE

Related Functions

B4000150 Get Branch Constants

Related Tables

F41001 Inventory Constants

F4101 Item Master

VerifyAndGetItemMaster
VerifyAndGetItemMaster

Validate and Retrieve Item Master

Major Business Rule

Object Name: X4101

Parent DLL: COPBASE

Location: Client/Server

Language: C

Functional Description

Purpose
The purpose of this function is to verify that an item master record exists using either the
Unknown(primary), Second, Third or Short Item Number formats.

Setup Notes and Prerequisites
The item number used to retrieve the Item Master record must be passed into the function through the
'Primary Item Number' parameter (Unknown, Second, Third or Short).  Use the symbol identifier
parameter to specify which item number is being passed into the function.

If using the short item number(numeric) as input in the Primary Item Number parameter this will need
to be converted to a string.  Use the function "ConvertShortItemToLongItem".

The function will return the Primary Item Number value, overwriting anything that was sent in for
that parameter.

This function will optionally return a pointer to a memory location holding an image of the Item
Master record.  If a pointer return is requested, then this must be followed by a memory clear using the
function "Free Pointer to Data Structure", otherwise a memory leak will result.

Special Logic
If a branch/plant record has previously been fetched and a pointer saved for the branch record, then
this can optionally be used as input to this function.  This will save on additional database fetches
to the Branch/Plant Constants file.  The branch constants record is used to determine the symbol
identifier being used.

The item description is returned in the language of the user or in the language preference specified
if entered.

Technical Specification

• This function retrieves the symbols that identify the three item numbers from the Branch/Plant
Constants Data Structure.  If the Pointer to the F41001 Data Structure is NULL, then use the business
function GetBranchConstants to retrieve the pointer  (F41001) and use them to validate the item number
passed (UITM).
'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7
'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7
• Retrieving the primary item number :

'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7
'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7
'b7a) Cross Reference: First see if the first character matches the symbol identifer for the
Supplier/Customer, if that identifier and address number passed in are not blank.
If not blank then:
If the call type is a 1
and the customer x-ref type (XRT) from the constants is not blank
move the customer x-ref type to the x-ref type for the F4104
end
If the call type is a 2
and the supplier x-ref type (XRT2) from the constants is not blank
move the customer x-ref type to the x-ref type for the F4104
end

Then Fetch to the X-Ref file (F4104) and retrieve the short item number that
corresponds to the item master
key = item number (without the symbol charater on the front of it)
x-ref type

Compare the dates on the record found to the date passed in to get only the
non expired cross reference item
if date passed in is greater than equal to the efective date (EFTJ)of the record
if date passed in is less than equal to the expiration date (EXDJ)of the record
or the expiration date (EXDJ) on the record is zero
move short item number from the record to PrimaryItemNumber
parameter passed in and a 1 to #AM

b) If the first character in the item number string matches the symbol for the short item
number (SYM1) and the symbol is not blank, then validate the item number as a short item number.

c) If the first character in the item number string matches the symbol for the 2nd item number
(SYM2) and the symbol is not blank , then validate the item number as a 2nd item number.

d) If the first character in the item number string matches the symbol for the 3rd item number
(SYM3) and the symbol is not blank, then validate the item number as a 3rd item number.

e) If the first character of the item number string doesn't match any one of the three symbols,
use the SymbolIdentifier (SID) passed to determine what the item number is.  If the
SybmolIdentifier passed  is also blank, treat the item number as a primary item number.

• Retrieve Item Information.

'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7
'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7
'b7a) If editing as a short item number and the first character matches the symbol of the
short item, strip off the first character in the string.  Then call function
GetItemMasterByShortItem to retrieve the item information.
b) If editing as a 2nd item number and the first character matches the symbol of the 2nd item,
strip off the first character in the string.  Then call function GetItemMasterBy2ndItem to
retrieve the item information.
c) If editing as a 3rd item number and the first character matches the symbol of the 3rd item,
strip off the first character in the string.  Then call function GetItemMasterBy3rdItem to
retrieve the item information.
d) Language Preference: When you return from GetItemMasterByShortItem, GetItemMasterby2ndItem
or GetItemMasterBy3rdItem move the two descriptions sent back into Description One and
Description Two and move IMDSC1 and IMDSC2 from the F4101 record into BaseDescriptionOne and
BaseDescriptionTwo.

• Determine Primary Item Number.

'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7
'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7
'b7Call ReturnPrimaryItemNumber to determine the primary item number by checking the
constants symbol that contains a blank value.  Load the primary item number returned to the UITM field
and the Symbol Identifier to SYMID.

• Error Handling.

'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7
'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7'b7
'b7Any error messages (other than 4363 and 3143) setting in the business function is
conditioned by the SuppressErrorMessages flag.  If this flag is set to '1' then the error messages are
not issued.  Any message ID's set or suppressed are moved into the DTAI MessageID parameter of
the data structure.

Data Structure

DX4101A - Verify And Get Item Master

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

szPrimaryItemNumber UITM char NONE NONE

^

szBranchPlant MCU char NONE NONE

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.

szDescription DSC1 char NONE NONE

Brief information about an item; a remark or an explanation.

szDescription2 DSC2 char NONE NONE

A second, 30-character description, remark, or explanation.

cSymbolidentifier SYMID char NONE NONE

idF4101LongRowPtr GENLNG ID NONE NONE

General purpose ID variable.

mnShortItemNumber ITM MATH_NUMERIC NONE NONE

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

cErrorcode ERRC char NONE NONE

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

szLanguagepreference LNGP char NONE NONE

A user defined code (01/LP) that specifies the language to use on forms and printed reports. Before you specify a language, a code for that
language must exist at either the system level or in your user preferences.

mnAddressnumber AN8 MATH_NUMERIC NONE NONE

A number that identifies an entry in the Address Book system, such as employee, applicant, participant, customer, supplier, tenant, or
location.

szSystemcode SY char NONE NONE

A user defined code (98/SY) that identifies a system. Valid values include: 01 Address Book 03B Accounts Receivable 04 Accounts
Payable 09 General Accounting 11 Multicurrency

szLongItemNumber LITM char NONE NONE

A number that identifies the item. The system provides three separate item numbers plus an extensive cross-reference capability to
alternative item numbers. The three types of item numbers are: Item Number (short) An 8-digit, computer-assigned item number. 2nd Item Number A
25-digit, user defined, alphanumeric item number. 3rd Item Number Another 25-digit, user defined, alphanumeric item number. In addition to
these three basic item numbers, the system provides an extensive cross-reference search capability. You can define numerous
cross-references to alternative part numbers. For example, you can define substitute item numbers, replacements, bar codes, customer numbers, or
supplier numbers.

szThirdItemNumber AITM char NONE NONE

The system provides three separate item numbers plus an extensive cross-reference capability to alternate item numbers. These item
numbers are as follows: 1.  Item Number (short) - An 8-digit, computer-assigned 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. In addition to
these three basic item numbers, an extensive cross-reference search capability has been provided (see XRT). Numerous cross references to
alternate part numbers can be user defined, such as substitute item numbers, replacements, bar codes, customer numbers, or supplier
numbers.

szItemFlashMsg IFLA char NONE NONE

User defined code system 40, type FL, which is used to flash a warning message about a particular item.

cReturnPtr EV01 char NONE NONE

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

cSuppressErrorMsg EV02 char NONE NONE

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

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

cCallType EV01 char NONE NONE

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

idPtrToF41001Record GENLNG ID NONE NONE

General purpose ID variable.

szBaseLngDesc1 DSC1 char NONE NONE

Brief information about an item; a remark or an explanation.

szBaseLngDesc2 DSC2 char NONE NONE

A second, 30-character description, remark, or explanation.

cCrossRefMode MODE char NONE NONE

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

cLngPrefType EV01 char NONE NONE

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

jdExpirationDate EXDJ JDEDATE NONE NONE

The date on which a transaction, text message, agreement, obligation, or preference has expired or been completed.

szStandardUOMConversion TFLA char NONE NONE

Allows you to bypass the item-specific unit of measure and use the standard unit of measure. Valid values are:    blank Use the item-specific
unit of measure    1       Bypass the item-specific unit of measure and use the standard unit of measure

szTemplate TMPL char OPT NONE

A template name that you can use when entering items on Item Master Revisions (P4101). This name is case sensitive. If you use any
capital letters in the template name when you add it, you must enter those letters in capitals whenever you search for or attach the template to Item
Master Revisions.

szSegment1 SEG1 char OPT NONE

The first section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment2 SEG2 char OPT NONE

The second section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not
exceed 25 characters.

szSegment3 SEG3 char OPT NONE

The third section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment4 SEG4 char OPT NONE

The fourth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment5 SEG5 char OPT NONE

The fifth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment6 SEG6 char OPT NONE

The sixth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment7 SEG7 char OPT NONE

The seventh section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not
exceed 25 characters.

szSegment8 SEG8 char OPT NONE

The eighth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not
exceed 25 characters.

szSegment9 SEG9 char OPT NONE

The ninth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

szSegment10 SEG0 char OPT NONE

The tenth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed
25 characters.

cMatrixControlled MIC char OPT NONE

A user defined code (41/MA) that specifies the relationship between a matrix item and its parent. This code also determines whether the
system displays the item in matrix detail information.

Related Functions

B4000150 Get Branch Constants

Related Tables

F41001 Inventory Constants

F4101 Item Master

TD>OPTOUTPUT
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
szItemRevLevelCIRVcharOPTINPUT
A reference number used to identify the revision level of the customer's item.   In item cross-reference, translating a customer or supplier
external item number to the internal short item number, the customer's number only is not always sufficient. In some instances, the customer part
number must be used in conjunction with the item revision level. This combination will allow the system to uniquely identify the customer's
item.
szCrossRefTypeOverrideXRTcharOPTINPUT
A user defined code (41/DT) that identifies the type of cross-reference set up for this customer. Examples of cross-reference types include:
o Substitutes     o Replacements     o Bar codes     o Customer item numbers     o Supplier item numbers
cCrossRefModeMODEcharOPTINPUT
The processing mode used in Purchase Order Consolidator to signify when specific orders are being processed.
jdDateExpiredJulian1EXDJJDEDATEREQINPUT
The date on which a transaction, text message, agreement, obligation, or preference has expired or been completed.
cSuppressErrorMessageSUPPScharOPTINPUT
A flag indicating whether or not runtime error messaging will occur when an error message is issued from a business function.        0 = allow
runtime error message handling.        1 = suppress runtime error message handling.
szDescription1DSC1charOPTOUTPUT
Brief information about an item; a remark or an explanation.
szDescription2DSC2charOPTOUTPUT
A second, 30-character description, remark, or explanation.
idF4101PointerGENLNGIDOPTBOTH
General purpose ID variable.
cSymbolIdentifierSYMIDcharOPTOUTPUT
szIdentifier2ndItemLITMcharOPTOUTPUT
A number that identifies the item. The system provides three separate item numbers plus an extensive cross-reference capability to
alternative item numbers. The three types of item numbers are: Item Number (short) An 8-digit, computer-assigned item number. 2nd Item Number A
25-digit, user defined, alphanumeric item number. 3rd Item Number Another 25-digit, user defined, alphanumeric item number. In addition to
these three basic item numbers, the system provides an extensive cross-reference search capability. You can define numerous
cross-references to alternative part numbers. For example, you can define substitute item numbers, replacements, bar codes, customer numbers, or
supplier numbers.
szIdentifier3rdItemAITMcharOPTOUTPUT
The system provides three separate item numbers plus an extensive cross-reference capability to alternate item numbers. These item
numbers are as follows: 1.  Item Number (short) - An 8-digit, computer-assigned 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. In addition to
these three basic item numbers, an extensive cross-reference search capability has been provided (see XRT). Numerous cross references to
alternate part numbers can be user defined, such as substitute item numbers, replacements, bar codes, customer numbers, or su

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
szItemNoUnknownFormat	UITM	char	REQ	INPUT
A number that the system assigns to an item. It can be in short, long, or third item number format.
szBranchPlant	MCU	char	REQ	INPUT
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.
mnAddressNumber	AN8	MATH_NUMERIC	OPT	INPUT
A number that identifies an entry in the Address Book system, such as employee, applicant, participant, customer, supplier, tenant, or location.
mnIdentifierShortItem	ITM	MATH_NUMERIC	OPT	OUTPUT
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
szItemRevLevel	CIRV	char	OPT	INPUT
A reference number used to identify the revision level of the customer's item. In item cross-reference, translating a customer or supplier external item number to the internal short item number, the customer's number only is not always sufficient. In some instances, the customer part number must be used in conjunction with the item revision level. This combination will allow the system to uniquely identify the customer's item.
szCrossRefTypeOverride	XRT	char	OPT	INPUT
A user defined code (41/DT) that identifies the type of cross-reference set up for this customer. Examples of cross-reference types include: o Substitutes o Replacements o Bar codes o Customer item numbers o Supplier item numbers
cCrossRefMode	MODE	char	OPT	INPUT
The processing mode used in Purchase Order Consolidator to signify when specific orders are being processed.
jdDateExpiredJulian1	EXDJ	JDEDATE	REQ	INPUT
The date on which a transaction, text message, agreement, obligation, or preference has expired or been completed.
cSuppressErrorMessage	SUPPS	char	OPT	INPUT
A flag indicating whether or not runtime error messaging will occur when an error message is issued from a business function. 0 = allow runtime error message handling. 1 = suppress runtime error message handling.
szDescription1	DSC1	char	OPT	OUTPUT
Brief information about an item; a remark or an explanation.
szDescription2	DSC2	char	OPT	OUTPUT
A second, 30-character description, remark, or explanation.
idF4101Pointer	GENLNG	ID	OPT	BOTH
General purpose ID variable.
cSymbolIdentifier	SYMID	char	OPT	OUTPUT

szIdentifier2ndItem	LITM	char	OPT	OUTPUT
A number that identifies the item. The system provides three separate item numbers plus an extensive cross-reference capability to alternative item numbers. The three types of item numbers are: Item Number (short) An 8-digit, computer-assigned item number. 2nd Item Number A 25-digit, user defined, alphanumeric item number. 3rd Item Number Another 25-digit, user defined, alphanumeric item number. In addition to these three basic item numbers, the system provides an extensive cross-reference search capability. You can define numerous cross-references to alternative part numbers. For example, you can define substitute item numbers, replacements, bar codes, customer numbers, or supplier numbers.
szIdentifier3rdItem	AITM	char	OPT	OUTPUT
The system provides three separate item numbers plus an extensive cross-reference capability to alternate item numbers. These item numbers are as follows: 1. Item Number (short) - An 8-digit, computer-assigned 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. In addition to these three basic item numbers, an extensive cross-reference search capability has been provided (see XRT). Numerous cross references to alternate part numbers can be user defined, such as substitute item numbers, replacements, bar codes, customer numbers, or supplier numbers.
cErrorCode	ERRC	char	OPT	OUTPUT
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).
szLanguagePreference	LNGP	char	OPT	INPUT
A user defined code (01/LP) that specifies the language to use on forms and printed reports. Before you specify a language, a code for that language must exist at either the system level or in your user preferences.
szSystemCode	SY	char	OPT	INPUT
A user defined code (98/SY) that identifies a system. Valid values include: 01 Address Book 03B Accounts Receivable 04 Accounts Payable 09 General Accounting 11 Multicurrency
szItemFlashMessage	IFLA	char	OPT	OUTPUT
User defined code system 40, type FL, which is used to flash a warning message about a particular item.
szBaseLongDescription1	DSC1	char	OPT	OUTPUT
Brief information about an item; a remark or an explanation.
szBaseLongDescription2	DSC2	char	OPT	OUTPUT
A second, 30-character description, remark, or explanation.
szStdUOMConversion	TFLA	char	OPT	OUTPUT
Allows you to bypass the item-specific unit of measure and use the standard unit of measure. Valid values are: blank Use the item-specific unit of measure 1 Bypass the item-specific unit of measure and use the standard unit of measure
szTemplate	TMPL	char	OPT	OUTPUT
A template name that you can use when entering items on Item Master Revisions (P4101). This name is case sensitive. If you use any capital letters in the template name when you add it, you must enter those letters in capitals whenever you search for or attach the template to Item Master Revisions.
szSegment1	SEG1	char	OPT	OUTPUT
The first section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment2	SEG2	char	OPT	OUTPUT
The second section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment3	SEG3	char	OPT	OUTPUT
The third section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment4	SEG4	char	OPT	OUTPUT
The fourth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment5	SEG5	char	OPT	OUTPUT
The fifth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment6	SEG6	char	OPT	OUTPUT
The sixth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment7	SEG7	char	OPT	OUTPUT
The seventh section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment8	SEG8	char	OPT	OUTPUT
The eighth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment9	SEG9	char	OPT	OUTPUT
The ninth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment10	SEG0	char	OPT	OUTPUT
The tenth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
cMatrixControlled	MIC	char	OPT	OUTPUT
A user defined code (41/MA) that specifies the relationship between a matrix item and its parent. This code also determines whether the system displays the item in matrix detail information.
cReturnPtr	REQPTRBK	char	OPT	INPUT
An option that indicates whether the system retrieves all fields or only certain fields from a table. If you do not choose this option, the system retrieves only certain fields.
cCallType	CALLTYP	char	OPT	INPUT
A code that indicates whether the system uses the customer cross-reference type or the supplier cross-reference type. Valid values are: 1 Customer cross-reference type 2 Supplier cross-reference type
cLangPrefTyp	LNGPRFTYP	char	OPT	INPUT
A code that specifies whether the system uses the User Language preference or a Language Preference override to retrieve the alternate description from the Item Master - Alternative Description table (F4101D). Valid values are: Blank The system uses the User Language preference. 1 The system uses the Language Preference override.
szErrorMsgID	DTAI	char	OPT	OUTPUT
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.
idF41001Ptr	GENLNG	ID	OPT	BOTH
General purpose ID variable.
cRevisionLevelFlag	REVLVLFLG	char	OPT	INPUT
An option that determines whether the system uses the customer item revision level to retrieve records from the Item Cross Reference File table (F4104). If you do not choose this option, the system does not use the customer item revision level.

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
szPrimaryItemNumber	UITM	char	NONE	NONE
^
szBranchPlant	MCU	char	NONE	NONE
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.
szDescription	DSC1	char	NONE	NONE
Brief information about an item; a remark or an explanation.
szDescription2	DSC2	char	NONE	NONE
A second, 30-character description, remark, or explanation.
cSymbolidentifier	SYMID	char	NONE	NONE

idF4101LongRowPtr	GENLNG	ID	NONE	NONE
General purpose ID variable.
mnShortItemNumber	ITM	MATH_NUMERIC	NONE	NONE
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
cErrorcode	ERRC	char	NONE	NONE
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).
szLanguagepreference	LNGP	char	NONE	NONE
A user defined code (01/LP) that specifies the language to use on forms and printed reports. Before you specify a language, a code for that language must exist at either the system level or in your user preferences.
mnAddressnumber	AN8	MATH_NUMERIC	NONE	NONE
A number that identifies an entry in the Address Book system, such as employee, applicant, participant, customer, supplier, tenant, or location.
szSystemcode	SY	char	NONE	NONE
A user defined code (98/SY) that identifies a system. Valid values include: 01 Address Book 03B Accounts Receivable 04 Accounts Payable 09 General Accounting 11 Multicurrency
szLongItemNumber	LITM	char	NONE	NONE
A number that identifies the item. The system provides three separate item numbers plus an extensive cross-reference capability to alternative item numbers. The three types of item numbers are: Item Number (short) An 8-digit, computer-assigned item number. 2nd Item Number A 25-digit, user defined, alphanumeric item number. 3rd Item Number Another 25-digit, user defined, alphanumeric item number. In addition to these three basic item numbers, the system provides an extensive cross-reference search capability. You can define numerous cross-references to alternative part numbers. For example, you can define substitute item numbers, replacements, bar codes, customer numbers, or supplier numbers.
szThirdItemNumber	AITM	char	NONE	NONE
The system provides three separate item numbers plus an extensive cross-reference capability to alternate item numbers. These item numbers are as follows: 1. Item Number (short) - An 8-digit, computer-assigned 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. In addition to these three basic item numbers, an extensive cross-reference search capability has been provided (see XRT). Numerous cross references to alternate part numbers can be user defined, such as substitute item numbers, replacements, bar codes, customer numbers, or supplier numbers.
szItemFlashMsg	IFLA	char	NONE	NONE
User defined code system 40, type FL, which is used to flash a warning message about a particular item.
cReturnPtr	EV01	char	NONE	NONE
An option that specifies the type of processing for an event.
cSuppressErrorMsg	EV02	char	NONE	NONE
An option that specifies the type of processing for an event.
szErrorMsgID	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.
cCallType	EV01	char	NONE	NONE
An option that specifies the type of processing for an event.
idPtrToF41001Record	GENLNG	ID	NONE	NONE
General purpose ID variable.
szBaseLngDesc1	DSC1	char	NONE	NONE
Brief information about an item; a remark or an explanation.
szBaseLngDesc2	DSC2	char	NONE	NONE
A second, 30-character description, remark, or explanation.
cCrossRefMode	MODE	char	NONE	NONE
The processing mode used in Purchase Order Consolidator to signify when specific orders are being processed.
cLngPrefType	EV01	char	NONE	NONE
An option that specifies the type of processing for an event.
jdExpirationDate	EXDJ	JDEDATE	NONE	NONE
The date on which a transaction, text message, agreement, obligation, or preference has expired or been completed.
szStandardUOMConversion	TFLA	char	NONE	NONE
Allows you to bypass the item-specific unit of measure and use the standard unit of measure. Valid values are: blank Use the item-specific unit of measure 1 Bypass the item-specific unit of measure and use the standard unit of measure
szTemplate	TMPL	char	OPT	NONE
A template name that you can use when entering items on Item Master Revisions (P4101). This name is case sensitive. If you use any capital letters in the template name when you add it, you must enter those letters in capitals whenever you search for or attach the template to Item Master Revisions.
szSegment1	SEG1	char	OPT	NONE
The first section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment2	SEG2	char	OPT	NONE
The second section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment3	SEG3	char	OPT	NONE
The third section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment4	SEG4	char	OPT	NONE
The fourth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment5	SEG5	char	OPT	NONE
The fifth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment6	SEG6	char	OPT	NONE
The sixth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment7	SEG7	char	OPT	NONE
The seventh section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment8	SEG8	char	OPT	NONE
The eighth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment9	SEG9	char	OPT	NONE
The ninth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
szSegment10	SEG0	char	OPT	NONE
The tenth section of a segmented item. You can assign up to 10 segments to an item as long as the sum of the segments does not exceed 25 characters.
cMatrixControlled	MIC	char	OPT	NONE
A user defined code (41/MA) that specifies the relationship between a matrix item and its parent. This code also determines whether the system displays the item in matrix detail information.