Digital

NAME

vet − Starts a DEC Verifier and Exerciser Tool(VET) session. 

SYNOPSIS

/usr/sbin/vet [−d devices] [−F] [−f scriptfile] [−g groups] /usr/sbin/vet [−p passcount] [−r runtime] [−s] [−nw] [−display] [−h] /usr/sbin/vet [−[no]sizer]

DESCRIPTION

The DEC Verifier and Exerciser Tool (DEC VET) is part of the Serviceability Tools subset. DEC VET provides a mechanism for verifying and exercising both system hardware and the operating system. 

An Installation Verification Procedure (IVP) is built into DEC VET which ensures proper installation and operation of the hardware and base operating system. 

Prior to invoking DEC VET, you need to set up the VET database by running the /usr/sbin/vetsetup script file. For information on invoking the system IVP, refer to the Guide to Installing DEC OSF/1. 

DEC VET runs in command-line mode if the DISPLAY environment variable has not been defined or if you specify the −nw flag.  If the −d flag is specified, DEC VET tests the specified devices and then exits.  If the −f or −F flag is specified, DEC VET runs the specified script file and exits. Otherwise DEC VET prompts for user commands. 

DEC VET runs in window mode if the DISPLAY environment variable has been defined or if you specify a display device with the −display flag. DEC VET displays its main window and you select operations to be performed by using the mouse and keyboard. 

FLAGS

−nwInvokes DEC VET in command-line mode. 

−display display-device-name
Directs the DEC VET Motif interface to the specified display-device-name. 

−d devicesSpecifies the devices to be tested. DEC VET tests the devices and then exits.  The devices argument is a list of one or more devices, optionally including the node, path, or both, to which a device belongs. A blank character (space) must separate items in the list and a multi-item list must be delimited by quotation marks. 

Device names have a combination of letters and numbers, for example, rrz1c and rmt0h, and include the path name to the device, such as /dev/rrz1c. 

Path names can include host names, such as mynode:/dev/rra1c. If you enter a device name without a host name, DEC VET assumes that the device is local. 

You can use the wildcard character(∗) to match all remaining characters, for example, /dev/rra∗ for all ra-type disks. 

If you enter all for devices, DEC VET acts on all devices.  You issue the show devices all command to find the names of devices connected to your system. 

−f scriptfile
Specifies a script file containing commands to be executed by DEC VET. DEC VET executes the commands in the script and then exits.

−FSpecifies the default script file (vet_script.tmp). DEC VET executes the commands in the script and then exits. 

−g groupsSpecifies the test groups to run on the devices specified with the −d flag. Each group has a name that can consist of letters, numbers, and the underscore character, for example, memexer_2. 

The group argument is a list of one or more groups. A blank character (space) must separate items in the list and a multi-item list must be delimited with quotation marks. 

Issue the show groups all for all command to display the names of all test groups. If this flag is absent, the default group is executed. 

−hDisplays the vet usage message. 

−p passcount
Specifies the pass count. If this option is absent, the test group runs for a default pass count of 1 or the specified run time, whichever completes first. This flag can be used only if −d, −f, or −F is specified. 

−r runtime
Specifies the amount of time for which the test groups run. If the flag is absent, the test groups run for the specified pass count. This flag can be used only if −d, −f, or −F is specified. 

The runtime argument can take the following forms: mm, hh:mm, or hh:mm:ss, where hh is a whole number indicating the hours, mm is a whole number indicating the minutes, and ss is a whole number indicating the seconds. 

If you specify one number without the delimiter (:), DEC VET interprets the argument as minutes. There is no practical limit to the number.  If you specify 4:344:97987 as a time, DEC VET interprets the argument correctly. 

−sSpecifies that DEC VET should display a run summary after the run has completed. 

−[no]sizerSpecifies that DEC VET does not run or does run the sizer when it starts. If the sizer is not run, you must connect the devices to be tested before any tests can be run. By default, the sizer runs unless −nosizer is specified. 

RESTRICTIONS

After you install the serviceability tools subset, you must invoke vetsetup to set up the proper databases before issuing the shell-level vet command. 

You cannot use −display in conjunction with −d, −f, or −F. 

EXAMPLES

The following example illustrates issuing a vet command with display options. When the user issues the vet command with the −nw flag, DEC VET starts a new session in command-line mode. After the user terminates the DEC VET session, control returns to the operating system. 

csh> vet -nw
VET_setup>
 .
 .
 .
VET_setup> exit
csh>

The following example illustrates issuing the vet command to exercise tape drives /dev/rmt0h and /dev/rmt2h using the default test group. The user specifies that the run will last for 30 passes or 15 minutes, whichever completes first. Once the run has completed, DEC VET returns control to the DEC OSF/1 operating system. 

csh> vet -d "/dev/rmt0h /dev/rmt2h" -p 30 -r 15
... testing completed. Total errors = 0.
csh>