EditPrimaryAssetNumber

Return Primary Asset Number

Minor Business Rule

Object Name: N1700150

Parent DLL: CCRIN

Location: Client

Language: NER

1.Functional Description

1.1Purpose

The purpose of Return Primary Asset Number is to allow the user to pass in the Asset Number (NUMB) and for the program to return the Primary 

Asset Number (ASII).  This program converts the Asset Number to a string and then calls the F1201 Validate Asset Number (X1202) to determine the 

primary number based on the Fixed Asset Constants.Additionally, Return Primary Asset Number will edit an asset number and if the constants are defined 

so that Serial Number is primary, the program will display a window to return a unique asset number if multiple serial numbers are found.  This mode 

of operation is only applicable within the CSMS system where Serial Number is unique in combination with product model.

1.2Setup Notes and Prerequisites


1.3Special Logic

The mode parameter should be used in the following way: 

• 1  -  Display the primary format on a form or a grid in the ASII field
• 2  -  Edit the ASII Equipment Number field and determine if there are duplicate serial numbers
• 3  -  Edit the NUMB Asset Number field in a Batch program   
• 
• The Primary Asset Number Types are 
• 1  -  Asset Number
• 2  -  Unit Number
• 3  -  Serial Number

Data Structure

D1700150 - Return Primary Asset Number


^

Parameter NameData ItemData TypeReq/OptI/O/Both
szAssetNumberInputASIIcharOPTNONE

An identification code that represents an asset. You enter the identification code in one of the following formats: 1 Asset number (a 
computer-assigned, 8-digit, numeric control number)   2 Unit number (a 12-character alphanumeric field)   3 Serial number (a 25-character alphanumeric 
field) Every asset has an asset number. You can use unit number and serial number to further identify assets. If this is a data entry field, the first 
character you enter indicates whether you are entering the primary (default) format that is defined for your system, or one of the other two 
formats. A special character (such as / or *) in the first position of this field indicates which asset number format you are using. You assign special 
characters to asset number formats on the fixed assets system constants form.

mnAssetItemNumberNUMBMATH_NUMERICOPTNONE

An 8-digit number that uniquely identifies an asset.

szDescription001DL01charOPTNONE

A user defined name or remark.

cModeOptionsOPTOWcharOPTNONE

1 = Pass the asset number to get the primary number for display in grid or form 
control.

2 = Pass the primary (alpha value) equipment number and determine if there are 

multiple equipment records matching the entered value.  If multiple serial numbers 

are found, a selection screen will be displayed to allow selection of the equipment 

desired.

szProductModelPRODMcharOPTNONE

A code that classifies an inventory item into a model for customer service. Some examples include: Laser Printer, Inkjet or Fax.

szProductFamilyPRODFcharOPTNONE

A code that classifies an inventory item into a group for customer service. Some examples include: Laser Printer, Inkjet, or Fax.

mnIdentifierShortItemITMMATH_NUMERICOPTNONE

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

mnCustomerNumberAN8MATH_NUMERICOPTNONE

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

mnSiteNumberLANOMATH_NUMERICOPTNONE

The address book number for the lessor, renter, or lending institution.

mnEnteredCustomerNumberAN8MATH_NUMERICOPTNONE

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

szDefaultBusinessUnitMCUcharOPTNONE

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.

szBranchPlantMMCUcharOPTNONE

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.

szInstalledBaseCatCode01ZE01charOPTNONE

A user defined reporting code for equipment.

szInstalledBaseCatCode02ZE02charOPTNONE

A user defined reporting code for equipment.

szInstalledBaseCatCode03ZE03charOPTNONE

A user defined reporting code for equipment.

szInstalledBaseCatCode04ZE04charOPTNONE

A user defined reporting code for equipment.

szInstalledBaseCatCode05ZE05charOPTNONE

A user defined reporting code for equipment.

szInstalledBaseCatCode06ZE06charOPTNONE

A user defined reporting code for equipment. Enter a value from UDC 17/B6.

szInstalledBaseCatCode07ZE07charOPTNONE

A user defined reporting code for equipment.

szInstalledBaseCatCode08ZE08charOPTNONE

A user defined reporting code for equipment.

szInstalledBaseCatCode09ZE09charOPTNONE

A user defined reporting code for equipment.

szInstalledBaseCatCode10ZE10charOPTNONE

A user defined reporting code for equipment.

szEquipmentStatusEQSTcharOPTNONE

A user defined code (12/ES) that identifies the equipment or disposal status of an asset, such as available, down, or disposed.

szLotLOTNcharOPTNONE

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

cPrimaryAssetNumberTypeEV01charOPTNONE

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

mnEnteredSiteNo_LANOLANOMATH_NUMERICOPTNONE

The address book number for the lessor, renter, or lending institution.

cCustomerChangeBehaviorEV01charOPTNONE

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

cSiteChangeBehaviorEV01charOPTNONE

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

szDescription02DL02charOPTNONE

Additional text that further describes or clarifies a field in the system.

szDescription03DL03charOPTNONE

Additional text that further describes or clarifies an element.

cSymbolIdentifierSYMIDcharOPTNONE

idF1201RecordPointerGENLNGIDOPTNONE

General purpose ID variable.

szUnitNumberAPIDcharOPTNONE

A 12-character alphanumeric code used as an alternate identification number for an asset. This number is not required, nor does the 
system assign a number if you leave the field blank when you add an asset. If you use this number, it must be unique. For equipment, this is 
typically the serial number.

szSerialNumberASIDcharOPTNONE

A 25-character alphanumeric number that you can use as an alternate asset identification number. You might use this number to track 
assets by the manufacturer's serial number. You are not required to use a serial number to identify an asset. Every serial number that you enter 
must be unique.

cReturnPointerEV01charOPTNONE

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

cSuppressErrorMessagesEV02charOPTNONE

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

szErrorMsgIDDTAIcharOPTNONE

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.

cAssetNumberSymbolSMIcharOPTNONE

A value that identifies an asset. You can assign one of three different types of numbers:   o  Asset Number - an eight digit, system assigned 
number   o  Serial Number - a 25 digit model or serial number   o  Unit Number - a 12 digit, alphanumeric, user defined number  When you enter 
an asset number, you may use a prefix or symbol to designate the type of number you enter. For the type of asset number you use most 
often, you should use no prefix, so that you just need to enter the number. For the other two types of asset numbers, you should define a symbol 
for each, such as / or *, that you will enter as a prefix before the number to identify which type of number you are representing. For example, if 
you enter serial numbers most often, you should use no prefix for serial numbers. Then you might use / as a prefix for asset numbers and * 
as a prefix for unit numbers.  Note: You can leave only one type of asset number with no prefix. The other two must have a symbol so that all 
three numbers are unique. Verify that the symbols that you use are not significant for any other purposes of data entry, for example, a period or 
comma.

cUnitNumberSymbolSMUcharOPTNONE

A value that identifies an asset. You can assign one of three different types of numbers:   o  Asset Number - an eight digit, system assigned 
number   o  Serial Number - a 25 digit model or serial number   o  Unit Number - a 12 digit, alphanumeric, user defined number  When you enter 
an asset number, you may use a prefix or symbol to designate the type of number you enter. For the type of asset number you use most 
often, you should use no prefix, so that you just need to enter the number. For the other two types of asset numbers, you should define a symbol 
for each, such as / or *, that you will enter as a prefix before the number to identify which type of number you are representing. For example, if 
you enter serial numbers most often, you should use no prefix for serial numbers. Then you might use / as a prefix for asset numbers and * 
as a prefix for unit numbers.  Note: You can leave only one type of asset number with no prefix. The other two must have a symbol so that all 
three numbers are unique. Verify that the symbols that you use are not significant for any other purposes of data entry, for example, a period or 
comma.

cSerialNumberSymbolSMScharOPTNONE

A value that identifies an asset. You can assign one of three different types of numbers:   o  Asset Number - an eight digit, system assigned 
number   o  Serial Number - a 25 digit model or serial number   o  Unit Number - a 12 digit, alphanumeric, user defined number  When you enter 
an asset number, you may use a prefix or symbol to designate the type of number you enter. For the type of asset number you use most 
often, you should use no prefix, so that you just need to enter the number. For the other two types of asset numbers, you should define a symbol 
for each, such as / or *, that you will enter as a prefix before the number to identify which type of number you are representing. For example, if 
you enter serial numbers most often, you should use no prefix for serial numbers. Then you might use / as a prefix for asset numbers and * 
as a prefix for unit numbers.  Note: You can leave only one type of asset number with no prefix. The other two must have a symbol so that all 
three numbers are unique. Verify that the symbols that you use are not significant for any other purposes of data entry, for example, a period or 
comma.

cDisplayModeEV01charOPTNONE

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

Related Functions

None

Related Tables

None