Print
login Account
Search

Utility To Read and Write Asset ID Information for DOS - ThinkPad

Name
Operating System
Version
Released
Download now
Utilities To Read and Write Asset ID Information - DOS

137.4 KB
Not Applicable
1.02
7/17/2012
README for Utilities To Read and Write Asset ID Information - DOS

12.0 KB
Not Applicable
1.02
5/28/2014

The utilities running on DOS to read out and store an asset ID data from ThinkPad is to provide query and set feature of an asset ID and other information.

The AIACustm.exe, AIACustm.ini, AIARead.exe, AIARead.txt, AIAWrite.exe and AIAWrite.txt files should be copied to DOS bootable media (Floppy, CD/DVD, USB memory key, etc.).
AIARead.exe shows an Asset Information Area (AIA) data.
AIAWrite and AIACustm set or modify the AIA data.

 

Contents
Supported ThinkPad Systems
Supported Operating System
Summary of Changes
Program execution notes
Device groups and fields
Program Return Codes (Exit codes)
Determining which Version is Installed

 

Supported ThinkPad Systems
  • Edge 11, Edge 13, Edge 14, Edge 15
  • Edge E10, Edge E30, Edge E31, Edge E40, Edge E50
  • Edge E120,Edge E220s, E125,E320,E325,E425,E525,S430
  • Edge E420s, Edge E420, Edge E520
  • G40, G41
  • Helix (Type 3xxx)
  • L410, L412, L420, L421, L510, L512, L520
  • L430,L530
  • Reserve Edition
  • R40, R40e, R50, R50e, R50p, R51, R51e, R51p, R52
  • R60, R60e, R61, R61e
  • R400, R500
  • S531
  • SL410, SL510
  • Twist S230u
  • T40, T40p, T41, T41p, T42, T42p, T43, T43p
  • T60, T60p, T61, T61p
  • T400, T400s, T410, T410i, T410s, T410si, T420, T420i, T420s, T420si
  • T430,T430i,T430s,T430si,T530,T530i
  • T500, T510, T510i, T520, T520i
  • W500, W510, W52, W530
  • W700, W700ds, W701, W701ds
  • X30, X31, X32, X40, X41, X41 Tablet
  • X60, X60s, X60 Tablet, X61, X61s, X61 Tablet
  • X100e, X120e
  • X200, X200s, X200si, X200 Tablet
  • X201, X201i, X201s, X201 Tablet
  • X220, X220i, X220 Tablet, X220i Tablet, X300, X301
  • X1, X1 Carbon (Type 34xx), X121e,X130e,X230,X230i,X230 Tablet,X230i Tablet
  • Z60m, Z60t, Z61e, Z61m, Z61p, Z61t

 

Supported Operating System
  • DOS

 

Summary of Changes

Where:

  • [Important] Important update
  • (New) New function or enhancement
  • (Fix) Correction to existing function

Version 1.02

  • (New) Added support for S5-S531,S531,Twist,Twist S230u,Helix (Type 3xxx),X1 Helix (Type 3xxx), X1 Helix (Type 3xxx) 3G.
  • (New) Added support for ThinkPad L430,L530,T430,T430i,T430s,T430si,T530,T530i, W530,X1,X1 Carbon (Type 34xx),X121e,X130e,X230,X230i,X230 Tablet,X230i Tablet.
  • (New) Added support for ThinkPad Edge E120,E125,E320,E325,E425,E525,S430.

Version 1.01

  • (New) Added support for ThinkPad T420, T420i, T420s, T420si, T510, T520, T520i, W520, X220, X220i, X220 Tablet, X220i Tablet, L412, L420, L421, L512, L520, Edge E220s, Edge E420s, Edge E420, Edge E520, X120e, Edge 11", E10, Edge 13", Edge E31, Edge 14", E40, Edge 15", E50.
  • (Fix) The version number changed to package version.

Version 1.00

  • (New) Initial release.

 

Program execution notes

AIACustm.exe, AIARead.exe and AIAWrite.exe run with "/?" command line parameter to show information about the execution of these programs.
DOS more.com command will be helpful to read those help text.
AIACustm /? | more
(this would require that the MORE.COM file is in the execution path)
It shows the optional command line parameters, the description of the groups and fields and the return code (exit code) information.
The command line format of each of these utility programs follows:

AIACustm.exe [inputfilename]
Where:

inputfilename is the name of the ini file that defines the AIA data to be written to the ThinkPad. If no inputfilename is specified, then AIACustm.ini will be used. The AIACustm.ini or other input file must be edited or created with the desired keyword values before executing AIACustm.exe.

AIAWrite.exe group field1=[value1]...[fieldn=[valuen]]|/f=filename
Where:

group is the name of the device group.

fieldn is the name of the field to write.

valuen is the value to be assigned to fieldn. For the USERDEVICE group, a blank value means delete this field if the field already exists or create the field with a NULL value if the field does not exist. For all other groups, it means assign a zero or null value.

filename is the name of the file that contains the desired field/value pairs. Each line in this file contains one field/value pair, separated by '='.

AIARead.exe group [field] [/f=filename] [/a] [/s] [/x] [/p=prefix]
Where:

group is the name of the device group.

field is the name of the field to read (default is all fields).

filename is the name of the file where the output results are to be written to (default is stdout).

/a is used to append to the output file (default is to overwrite the file).

/s is used to format the output as SET statements. Ie., 'SET name=value' (default is name=value).

/x is used to exclude fields that are set to null strings or have a value of zero.

/p is used to prepend the 'prefix' to the name of each field.

 

Device groups and fields

All options, group names and field names are case-insensitive, except for the USERDEVICE group and the prefix value.

If no options are specified or an incorrect option is specified, then the help text for the utility is displayed. Here is a list of the valid group names and their associated fields:

NETWORKCONNECTION

NUMNICS
GATEWAY
IPADDRESS[n] (1<=n<=NUMNICS, default is 1)
SUBNETMASK[n]
SYSTEMNAME
LOGINNAME

USERDEVICE [Field1] - These fields are defined by the user.
: Maximum number of user fields is five.
[Fieldn]
PRELOADPROFILE IMAGEDATE
IMAGE
USERASSETDATA PURCHASE_DATE
LAST_INVENTORIED
WARRANTY_END
WARRANTY_DURATION
AMOUNT
ASSET_NUMBER
LEASEDATA LEASE_START_DATE
LESE_END_DATE
LEASE_TERM
LEASE_AMOUNT
LESSOR
OWNERDATA OWNERNAME
DEPARTMENT
LOCATION
PHONE_NUMBER
OWNERPOSITION

 

Program Return Codes (Exit codes)

This is the list of return codes (exit codes) provided by the AIACustm.exe, AIARead.exe and AIAWrite.exe programs when they end. The return code is able to be tested within a batch file by the ErrorLevel batch file command if desired. (Please refer to your DOS mamnual for the usage)

Hex Code Description
00 Successful completion
01 RFID EPROM Error - Communication error
02 RFID EPROM Error - Bad header
03 RFID EPROM Error - Unknown version
04 RFID EPROM Error - Out of space
05 RFID EPROM Error - Reread failure 1
06 RFID EPROM Error - Reread failure 2
07 RFID EPROM Error - Invalid checksum
08 RFID EPROM Error - Invalid instance
09 RFID EPROM Error - RFID EPROM not found
0A RFID EPROM Error - User area is corrupt
0B RFID EPROM Error - RFID area is corrupt
20 File open failed (disk full, write protected file, other open error)
21 A valid field was not found in the AIA data area
22 Error attempting to format and display an output line
23 Group option is required, but was not specified
24 An unknown Group name was entered
25 Cannot find the Field name associated with the Group
26 The '=' separator field is missing from the /f option
27 The '=' separator field is missing from the /p option
28 An unsupported option was specified
29 User specified the nth NIC 'n' which is either invalid or larger than the NUMNICS value
2A More than five (5) Label=Value pars were specified for the USERDEVICE group
2B This system does not appear to have an RFID EPROM (EEPROM)

 

Determining which version is installed

[AIACustm.exe]

Run the AIACustm without parameter, it will show the version information.

[AIAWrite.exe, AIARead.exe]

Run the AIAWrite and AIARead with /d parameter, it will show the version information followed by help and additional information.