|
|
|
|
The snarjestat command displays status information for one or more specified RJE workstations.
Sample command: snarjestat wks1
You must use this command on the computer on which the RJE workstation is running (the computer for which it is configured). Consult your System Administrator if necessary, or refer to the SNAP-IX Administration Guide for information about RJE workstation configuration.
The syntax for the snarjestat command is:
snarjestat [ -d | -l ]wkst ...
You can use one of the following options with the snarjestat command:
Displays status information for workstation devices (printers, punches, console, and reader) only. See Returned Messages, for more information about what is displayed.
Displays status information for workstation LUs only. See Returned Messages, for more information about what is displayed.
You can specify only one of these options. If you do not include either option, SNAP-IX displays status information for both LUs and devices belonging to the workstation.
You must use the following parameter with the snarjestat command:
Name of the RJE workstation whose status information will be displayed. This must be an RJE workstation in the current configuration file. The workstation name is not case sensitive.
You can specify more than one RJE workstation here, provided that you leave a space after each. Alternatively, you can enter the snarjestat command and press Enter. Then type the name of an RJE workstation followed by Enter to view its status. You can continue to view the status of other workstations by typing their names followed by Enter. When you have finished, press Ctrl + D to exit the command.
After you issue the snarjestat command, the workstation displays device and LU status information.
The format of the Device Status returned message is:
wkst devicename devstatus LUname action
The parameters on the returned messages when the option is used with the snarjestat command are as follows:
Name of the RJE workstation.
Name of a device owned by the RJE workstation. This can be a printer (PRTn), punch (PUN n), console (CONS), or reader (RDR1) device, where n is a one-digit decimal number.
This can take the following forms:
The device is currently in use.
The device is currently not in use.
There were not enough LUs available to the RJE workstation to carry out all its tasks at once. This device has been interrupted and the LU it was using is now being used by a device with higher priority.
Name of the LU that is used by the device.
This entry appears only for active or suspended devices. The form it takes depends on the type of device:
The type element indicates whether the output is being sent to a program, a directory, or a file. The name element is the name of the program, directory, or file to which the output is being sent.
The console is sending data to the host.
The console is receiving data from the host.
This is the job currently being sent to the host.
The following is an example of a Device Status returned message:
Wkst Device Status LU Name Action ------------------------------------------ RJE1 PRT1 Active LU2 Output to directory /var/opt/sna/rje/R427/output
The format of the LU Status returned message is:
wkst LUname LUstatus devicename
The parameters on the returned messages when the option is used with the snarjestat command are as follows:
The name of the RJE workstation.
The name of an LU owned by the RJE workstation.
This can take the following forms:
The LU is receiving data from the host.
The LU is sending data to the host.
The node or the communications link to the host is not active.
The node and the host communications link are active, but no session has been established.
A session has been established, but the session has no activity.
The name of the device that is using the LU. This can be a printer (PRN n), a punch (PUNn), the console (CONS), or the reader (RDR1), where n is a one-digit decimal number.
Wkst LU Name Status Device --------------------------------- RJE1 LU1 Sending RDR1
If the command detects an error, it writes a message to standard error. This message can indicate (for instance) the following:
Invalid option was supplied
Invalid workstation name was supplied
Parameter in the workstation style file was invalid
SNAP-IX software was not started
Workstation was already running
If only one workstation name is specified, the snarjestat command returns the following exit codes:
An error was detected (such as an invalid workstation name).
The workstation is active and connected to the host.
The workstation is active but not connected to the host.
The workstation is not active.
If more than one workstation name is specified, the exit code is always 0 (zero).
|
|
|
 |
|