Updated September 2011 (see History)
SYSTAT {switches}
The A-Shell SYSTAT command is very similar to the AMOS counterpart, and produces a display something like this:
|
Status of A-Shell/32 Version 4.9(927) on Monday, June 06, 2005 10:25:33 PM TSKAAA TSKAAA jack DSK0:7,6 RN SYSTAT 62343 400K bytes TSKAAB TSKAAB jack DSK0:1,4 ^C SET 66145 400K bytes 2 jobs allocated on system, 2 in use DSK0 36592 Blocks free DSK1 36592 Blocks free DSK2 36592 Blocks free DSK3 -1 Blocks free 4 devices on system, total free blocks may be shared among devices
|
The lines which correspond to the individual jobs are actually formatted identically to the AMOS version of SYSTAT, except that the memory size is always shown in K, to make room for the UNIX process id, which displays (under A-Shell/UNIX) between the program name and the memory size. The available job states are currently only “RN” and “^C”, unlike the AMOS version which shows many more states.
Note that in the list of devices, one or more of the pseudo AMOS-like devices may share the same physical disk device on the host operating system, and thus the number of blocks free is the same. In the example above, DSK0, DSK1, and DSK2 are all hosted on the same device, while DSK3 is apparently not accessible.
Note also that beginning in SYSTAT.LIT 3.0(161) of December 2009, the display format is automatically widened, but only if necessary, to prevent numeric overflow of the available disk blocks (more than 999,999,999 blocks).
Switches
The A-Shell version of SYSTAT offers a number of switches which can be listed with SYSTAT/?.
|
Switch |
Description |
|
A |
Displays all of the “allocated” jobs (i.e. those listed in TRMDEF.INI) even if no corresponding process has been launched. |
|
ATE |
Identifies ATE connections (in place of the pid); either "ATE/SRV" to indicate that the license was issued by the server, or "ATE/PC" for other ATE connections. The ATE version number will be displayed in place of the memory partition size (added in A-Shell build 1138). |
|
B |
Displays only background jobs. |
|
C |
Controlling Terminal: Displays the controlling terminal’s device identification. |
|
E |
MAC Address: Displays the client MAC address if known. |
|
F |
Displays only foreground jobs (i.e., jobs with display devices attached). |
|
H |
Displays available disk space in "human-readable" units (GB or MB) rather than 'blocks'. This feature added in SYSTAT 3.0(161), A-Shell build 1169 of Dec 09. |
|
I |
Displays IP address. This feature added in SYSTAT 3.0(150). |
|
K |
Kill Phantoms: Checks for and kills phantom jobs under UNIX. |
|
L |
Sends the output of the display to the file SYSTAT.LST in the current directory rather than to the screen. This is useful when you want to examine the state of the users programmatically. |
|
M |
Displays the minimum amount of free (unused) memory so far in the life of each job, instead of the allocated amount. This can be useful in judging whether your memory partitions are reasonably sized. |
|
N |
Eliminates the display of the devices. This is particularly useful when you have a lot of devices, especially if some of them are slow to respond due to being offline or connected over a WAN. |
|
P |
Pause after each page of display. Also see the notes on PAGE.LIT for another way to get the same effect. |
|
R |
Display “Real” jobs only. Omits PolyShell control jobs from the display. |
|
S |
Sort the display of users by job name. |
|
SU |
Sort the display of users by user name. |
|
ST |
Sort by job type (daemon, pshell, background, foreground) |
|
V |
Display the A-Shell version running for each job. This is useful during updates or in situations where the executable may be loaded from different places in order to verify that all users are on same version. (See history) |
|
W |
Display in Wide mode, totals several of the columns. |
|
X |
May be used with /L to force the new layout in the file version. (See history) |
|
Z |
Kill Zombies: Similar to /K but for zombies rather than phantoms. |
|
ZS |
Identical to /Z except that it skips zombies that were launched via SUBMIT. Such jobs predictably become zombies if the submitting job exits, even though they may continue to function as intended. Thus you may not necessarily want to kill them along with other zombies. |
History
2011 September, A-Shell 5.1.1235: SYSTAT 3.1(164) enhancements to support the revised job table layout:
• Screen layout adjusted slightly to allow for ten character program name. (File layout with /L remains as before to preserve compatibility with programs that generate a listing and then parse it.)
• Add new switches /V and /X.
Note that this version of SYSTAT will continue to work with the older job table, but older versions of SYSTAT will not see the program name or A-Shell version for jobs running A-Shell 5.1.1235+