F4101GetOutsideOperationsItem

F4101 Get Outside Operations Item Number

Minor Business Rule

Object Name: B3101240

Parent DLL: CMFGBASE

Location: Client/Server

Language: C

1.Functional Description

1.1Purpose
This function will retrieve the item master record for the Outside Operation item number and return 
the Item Number's First, Second and Third item number. It will also verify that an item branch record 

exists for the Outside Operation item number. Lastly it will verify that the primary item location 

record exists. If the Item Master record does not exist, it will create the Item Master record, Item 

Branch and Item Location record along with Cardex information about the new item master record. If the Item 

Branch record does not exist, it will create it along with the primary Item Location record.




1.2Setup Notes and Prerequisites


1.3Special Logic


2.Technical Specifications

2.4Processing 


/********** Setup Processing *********/

1.Output Error Code = '0'
2.Output Error Message =  " "

3.Wk LITM = " "

4.Call X4101 with Input Original Item Number to Retrieve Item Master Record and save the record in 

OriginalItemMaster

5.If Found

6. Call B4001050 to get Branch constants.

7. If CISYM1 = ' '

8. Wk LITM = First 19 Characters OriginalItemMaster.IMITM + "*OP" + Input Operation Seq.

9. Else If CISYM2 = ' '

10. Wk LITM = First 19 Characters OriginalItemMaster.IMLITM + "*OP" + Input Operation Seq.

11. Else If CISYM3 = ' '

12. Wk LITM = First 19 Characters OriginalItemMaster.IMAITM + "*OP" + Input Operation Seq.

13. End If

14. Call X4101 to retrieve Item Master Record with Wk LITM and save the record in NewItemMaster.

15. If Not Found then

16. Call B4100290 to Insert a New Item Master Record to F4101 and get the new Short Item 

Number.

17. Copy OriginalItemMaster to NewItemMaster and override fields: IMITM=New Short Item 

Number, IMLITM = Wk LITM, IMAITM = IMLITM, IMDSC2 = Input Desc., IMSTKT = 'X',  IMLNTY = 

Input Line Type, IMLLX = 0.

18. Update F4101 with NewItemMaster.

19. End If

20. Output Outside Op Item Number = NewItemMaster.IMITM

21. Output Outside Op 2nd Item Number = NewItemMaster.IMLITM

22. Output Outside Op 2nd Item Number = NewItemMaster.IMAITM

23. Call B4100210 with Output Outside Op Item Number and Input Original Branch.

24. If Not Found

25. Call B4100210 with Input Original Item Number and Input Original Branch and save record 

in  OriginalItemBranch

26. If Found

27. Call XF41021 with Input Original Item Number and Input Original Branch and PBIN ='P' 

and  save the record in OriginalItemLocation

28. If Found

29. Call B4100840 to Insert a New Item Branch record.

30. Copy OriginalItemBranch to New Item Branch and override the following fields: IBITM 

= NewItemMaster.IMITM, IBLITM = NewItemMaster.IMLITM, IBAITM = 

NewItemMaster.IMAITM, IBVEND= Input Vendor, IBPRP4 = ' ', IBSTKT = 'X', 

IBLNTY= Input Line Type.

31.

32. Write a new record to Item Location with OriginalItemLocation record and override 

the  following: LIITM= NewItemMaster.IMITM, LIPQOH=0, LIPCOM=0, LIFUN1=0, 

LIQTRI=0, LIQTRO=0, LIPBCK=0, LIPREQ=0, LIOY1P=0, LIOT2P=0, LIHCOM=0,  LIFCOM=0, 

LIQOWO=0, LIQTTR=0, LIQTIN=0, LIQT01=0, LIQT02=0, LIQONL=0

33.

34. Call B4100050 to write Cardex record

35. DGL = Input TransactionDate, ITM=LIITM, ILMCU=LIMCU, ILLOTN=LILOTN, 

ILOCN=LILOCN, ILLITM= NewItemMaster.IMLITM, ILTRDJ=Today'sDate, 

ILTREX="Item Add", ILDOC="31410", ILPID, ILTERM, ILDRDH.

36. Else

37. Set Error Code = '1'

38. End If

39. Else

40. Set Error Code = '1'

41. End If

42. End If

43.Else

44. Set Error Code = '1'

45.End If


Data Structure

D3101240 - F4101 Get Outside Operations Item Number

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

szOriginalBranchMMCUcharNONENONE

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.

mnOperationSequenceNumberOPSQMATH_NUMERICNONENONE

A number used to indicate an order of succession. In routing instructions, a number that sequences the fabrication or assembly steps in the 
manufacture of an item. You can track costs and charge time by operation. In bills of material, a number that designates the routing step in the 
fabrication or assembly process that requires a specified component part. You define the operation sequence after you create the routing 
instructions for the item. The Shop Floor Management system uses this number in the backflush/preflush by operation process. In engineering 
change orders, a number that sequences the assembly steps for the engineering change. For repetitive manufacturing, a number that 
identifies the sequence in which an item is scheduled to be produced. Skip To fields allow you to enter an operation sequence that you want to begin 
the display of information. You can use decimals to add steps between existing steps. For example, use 12.5 to add a step between steps 
12 and 13.

szDescriptionLine1DSC1charNONENONE

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

szLineTypeLNTYcharNONENONE

A code that controls how the system processes lines on a transaction. It controls the systems with which the transaction interfaces, such as 
General Ledger, Job Cost, Accounts Payable, Accounts Receivable, and Inventory Management. It also specifies the conditions under 
which a line prints on reports, and it is included in calculations. Codes include the following: S Stock item   J Job cost   N Nonstock item   F Freight  
T Text information   M Miscellaneous charges and credits   W Work order

mnVendorNumberVENDMATH_NUMERICNONENONE

The address book number of the preferred provider of this item.

jdTransactionDateTRDJJDEDATENONENONE

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

mnOutsideOpItemNumberITMMATH_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

szOutsideOp2ndItemNumberLITMcharNONENONE

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.

szOutsideOp3rdItemNumberAITMcharNONENONE

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.

cErrorCodeERRCcharNONENONE

This error code indicates if any errors occurred during the creation of the Trip Document Detail (F4914) records by the Delivery Document 
Set Server program (XT4914).

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.

cSuppressErrorMessageSUPPScharNONENONE

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.

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.

szPurchasingUOMUOM3charOPTNONE

A code (table 00/UM) that identifies the unit of measure in which you usually purchase the item.

cPotencyFlagOT1YcharOPTNONE


^

mnStandardPotencySTDPMATH_NUMERICOPTNONE

The percentage of active ingredients normally found in an item.

szItemMasterTFLATFLAcharOPTNONE

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

Related Functions

B4001050 Get Branch Constants Fields
B4100050 Inventory Cardex Shell
B4100210 Check Item Branch
B4100290 Insert Item Master Row
B4100840 F4102 Update Item Branch Record
B9800100 Get Audit Information
X4101 Validate and Retrieve Item Master
XF41021 Update F41021 Locations

Related Tables

F4101 Item Master
F4102 Item Branch File
F41021 Item Location File
F4111 Item Ledger File