Command line options

When Diag is run, either from the command line, or from a batch file, a number of switches (or options) may be included to “customize” the operation of Diag. Switches must be specified separately, and must begin with either a - or a / character. Upper or lower case may be used as desired. Switches may be used in any order. The switches, a brief description, and their use are described below:

Table 4 - Diagnotic Command Line Options

Switch

Description

-?

Report the standard command line options available.

-!

Report standard and hidden command line and keyboard commands available.

-cNxxxx

Specify Nth ROM checksum. The “BIOS flash ROMs” test the flash memory for

 

correctness. In order for Diag to maintain usefulness in the face of new and

 

different BIOSes, a way is needed to specify the BIOS ROM values. Though the

 

test will not fail (as of this writing) if the checksums are not specified, a ‘?’ will show

 

after a sum to indicate checksum uncertainty. All three checksums must be

 

specified to fully qualify the ROMs. As an example, to test a build with the

 

960701.ROM, the user would enter: Diag -c121E9 -c2D631 -c3C600. Batch files

 

that need to work with both F1175 and F1360 OmniBooks may specify two

 

checksums after each switch, the first one for the F1175 and the second one for the

 

F1360. For example, to test the 970121 ROMs for both units, use the following

 

switches: -c1B7386A45 -c2DC8CDC8C -c316001600.

-d

Select Dock tests only. For testers wishing to test docks, this switch restricts the test

 

shown to those that pertain to the dock only. The set of tests shown in this mode

 

include the following: Serial port, Printer port, SCSI loopback, Audio, Floppy disk,

 

Docked device, Dock keyboard, Dock PS2 mouse, Dock EEPROM.

-f

Run Fast IR loopback mode on startup. The IR port test needs a computer running

 

in “passive” mode to send IR data back to the computer being tested. An IR test

 

station can be automated by having the passive computer run Diag with the -f option

 

in its AUTOEXEC.BAT file. The key <Alt+F> can also be used to put the computer

 

into passive mode. Press <Esc> to exit from passive mode.

-k<file>

Run a Keyboard macro file. This switch is by far the most powerful and versatile in

 

that it lets the operator set up different configurations and test sequences and play

 

them back later just as though they were typing the commands from the keyboard.

 

For information on creating a keyboard macro file, see the <Alt+R> command.

-m

Enable Mouse keyboard control. For units that do not have a keyboard, use this

 

option to control Diag with a mouse. For more information on this feature, see the

 

<Alt+M> command

-r<test#>

Run nth test and return exit code. For testing from a batch file, this switch can be

 

used to run a single test and return the test result in the errorlevel. 0=pass, 1=fail,

 

2=aborted, 3=no loop/can’t run. Tests are specified by ordinal number counting

 

from 1 at the top. Use the -1, -2, -3 option below to set the test level.

-s

Disable control via Serial port. By default, the serial port can be used to control

 

Diag via a host computer (running Kermit connected at 9600, N, 8, 1) when no

 

keyboard is available, the unit cannot be easily accessed for entering commands, or

 

remote automated operation is needed. Serial control is always automatically

 

disabled during the serial port test, but if the serial port is used for other activities,

 

use this switch to completely disable control.

-x

Test for the eXtra key on foreign keyboards. Foreign keyboards have an extra key

 

to the left of the space key. To include this key in the internal keyboard test, add a -

 

X parameter when running Diag. Because the keyboard test is scancode based (not

 

ASCII character), the key names are NOT localized to their foreign equivalents.

12