Updated March 2017; see History
SYSTAT {switches}
SYSTAT displays "system statistics" like the following:
|
Status of A-Shell/32 Ver. 6.3.1543.9 on Thursday, February 23, 2017 22:42:51 TSKAAA TSKAAA Ty DSK3:347,0 RN SYSTAT 12292 4546K 1 jobs allocated on system, 1 in use Total memory on system: unknown Sys Uptime is unknown
DSK0 797761 MB free DSK1 797761 MB free DSK3 797761 MB free DSK2 797761 MB 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. |
|
CU |
Like /C but displays both the machine name and unique identifier (in place of the user name and login columns). |
|
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
2017 March, A-Shell 6.4.1546, SYSTAT.LIT 3.2(178): (UNIX) Reduce the excessive ITC error messages (one per job) to just one overall when the /W mode is unable to send ITC messages due to privilege issues. Allow clean exit with Q or ESC from paging mode.
2015 May, A-Shell 6.1.1408, SYSTAT.LIT 3.1B(171): Updated routine to recognize and preserve a new unique identifer field in the JOBTBL. The new version is backward compatible with earlier versions of A-Shell and has a "B" in the version number to help easily identify it. Also: Added new switch /CU.
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+
2011 June, A-Shell 5.1.1221: Remove the limit on the number of PPNs allowed per device.