NAME

cstm - Command line interface to the Support Tool Manager
 

SYNOPSIS

/usr/diag/bin/cstm [-l log file name]
 

DESCRIPTION

CSTM provides access to a variety of support actions via a command line user interface. CSTM is a complementary interface to XSTM, which is a graphical interface for the X11 environment. Unlike XSTM, CSTM can be run on an HP compatible ASCII terminal and can be easily script driven. 
 
When CSTM is started, a banner is displayed; followed by a prompt. The "map" command may be used to generate a map of the I/O and system configuration which includes processors, I/O cards, and peripherals. The map includes the physical path of each device, a brief description of each device, and the status of all support operations that have been initiated on each device. The operations currently available are diagnose, exercise, and verify.

A "help" command is provided, which displays either a brief list of commands available in CSTM, or more detailed information on a particular command.  The command list may be obtained by typing "help" or "?". Help information for a particular command can be obtained by following the "help" command with the name of the command for which help is desired. 
 
Support operations for a given device can be initiated by entering the appropriate command followed by the physical path of the device as shown on the output from the "map" command. For example, "verify 2/0/1" results in a verifier being run on device 2/0/1. Many commands accept parameters such as "loop", "time", "all", etc. The exact syntax, including allowable parameters for a given command, can be determined using the "help" command.
 

The operations which may be performed on the specified device depend on the support tool functions available for the type of device.  Typically these actions are "verify" and "diagnose" or "exercise".  "Verify" operations consist of tasks that will access the device in a way that a typical user would, to determine if the device is functional.  "Diagnose" operations will perform hardware diagnostic tests on the selected device. "Exercise" operations will attempt to stress the device. 
 

When an operation such as "diagnose", "exercise", or "verify" is selected, a message is displayed indicating that the operation was initiated. If a "map" command is issued prior to the completion of the operation, the corresponding status for the selected device will be "Running", indicating that a test is in progress.  When the action has completed, a message is displayed indicating the result of the operation. Additionally, the status in the map is changed to reflect the result. Typical result statuses are "Success", "Failed", and "Warning". In the case of "Warning" and "Failure", the result will be displayed in inverse video in order to make it easier to recognize. If an operation fails, detailed information concerning the exact nature of the failure can be obtained by issuing the "viewlog" command for the device which results in the creation of a "vi" editing session on the failure log file. 

Some actions may require assistance from the user, such as mounting a tape and making sure that the tape drive is on-line.  When such operator intervention is required, a prompt is displayed to which the user must enter a response. 
 

OPTIONS

-l log file name

This argument allows you to specify the name of the file to which log events that occur during the time the application is active are posted.  The default is "./stm.log". The contents of this log may be viewed by issuing the "viewlog" command with no parameters. 
 
 
SESSION LOG FILE

 
The session log (default name: stm.log) contains a detailed history of the actions performed by XSTM. This log begins with a chart indicating the system and I/O configuration for the system and records the results for each action performed during the session. Each line of the chart specifies the location of the device, a description of the device, the current status of the diagnose action, and the current status of the verify action.

Please note that the Diagnostic, Verifier, and Exerciser status columns will contain entries of "N/A" or "Not Checked".  "N/A" signifies that the corresponding action is not available for the device. "Not Checked" signifies that the action has not been invoked, which is always the case when CSTM is first invoked. 
 

OTHER FILES

 
/usr/diag/bin/am - support application manager.
/usr/diag/bin/dtm - diagnostic tool manager.
/usr/diag/bin/DTMDUI.sh - diagnostic interface shell.
/usr/diag/bin/diskdaf - disk device access verifier.
/usr/diag/bin/idiskdaf - removable-media disk device access verifier.
/usr/diag/bin/tapedaf - tape device access function.
/usr/diag/bin/CSVER000 - NLS message catalog for the platform.
/usr/diag/bin/CSTM000  - NLS message catalog for CSTM.
 

SEE ALSO

 
xstm(1m)
 

WARNINGS

Due to the nature of this application and its associated processes, overall system performance may be degraded while CSTM is running. 
 

COPYRIGHT

(C) Copyright 1991, Hewlett-Packard Company
 

ORIGIN

cstm was written by Hewlett-Packard Company. 

Hewlett-Packard Company  —  HP-UX Release 8.5: June 1991