Command line options, Switch Description

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.