Updated December 2020; see History
SYSTAT {switches}
SYSTAT displays "system statistics" like the following:
Example 1: SYSTAT
Status of A-Shell/32 Ver. 6.5.1622.2 on Friday, July 13, 2018 08:33:34 TSKAAA TSKAAA Ty DSK3:347,0 RN SYSTAT 9428 4546K 1 jobs allocated on system, 1 in use Total memory on system: unknown Sys Uptime is unknown
DSK0 770087 MB free DSK1 770087 MB free DSK3 770087 MB free DSK2 770087 MB free 4 devices on system, total free blocks may be shared among devices
|
Example 2: SYSTAT/C/N/ATE
Status of A-Shell Version 6.5.1692.4 on Tuesday, December 08, 2020 10:32:29 SSCALE SSCALE tsk:30077 DSK1:300,200 RN SSCALE TASAAC TASAAC tsk:7108 DSK1:300,200 RN TCPXFR TSKAAD TSKAAD pts/3:5004 DSK1:300,200 RN MASTMU ATE/SRV 6.4.1556.2 TSKACQ TSKACQ pts/53:31587 DSK1:300,200 RN SYSTAT ATE/SRV 6.5.1693.0 4 jobs allocated on system, 4 in use Total memory on system: 12137428 kB Sys Up: 10:32:29 up 190 days, 15:55, 65 users, load average: 0.48, 0.61, 0.61
|
Column Descriptions
Col |
Description |
|---|---|
1 |
Jobname. Determined by the -j command line switch, or auto-generated using the format TSKxxx for foreground jobs and TASxxx for background jobs. In the example above, SSCALE was launched with -j SSCALE; the others were auto-assigned. |
2 |
Terminal name. This is a legacy hold-over and is virtually always the same as the job name. |
3 |
Either the login name, or in the case of /C, the console identifier, or for /I, the IP address. The format of console identifiers differs between operating systems, but as a general principle, those that match up to the colon are originating from the same client machine. |
4 |
Logged-in location |
5 |
Status. Either RN for running a program, or ^C for at the dot prompt |
6 |
Name of the running program |
7 |
Process ID. In the case of the /ATE switch, either "ATE/SRV" for a server-licensed ATE session, "ATE/PC" for a PC-licensed ATE session, or blank for anything else. |
8 |
Either the current direct memory allocation, or in the case of /ATE, the ATE version, or in the case of /VER, the A-Shell version. |
9-15 |
In the case of /W, these seven extra columns show the number of reads, writes, queue-locks, commands, instructions, keystrokes, and the elapsed login time. |
Comments
| • | In the list of devices, one or more of the 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 Windows example above, DSK0 thru DSK3 are all hosted on the same physical file system. So the actual total amount of free space is 770087 MB—as opposed to four times that, as it may appear from the display. |
| • | The display format is automatically widened, but only if necessary, to prevent numeric overflow of the available disk blocks, which is more than 999,999,999 blocks. |
| • | Beginning with A-Shell 1693 of December 2020, a plus sign ( + ) is shown next to the trmdef name for jobs that are current using a node license. |
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. |
/ERZ |
Displays ersatz locations instead of dev:p,pn. |
/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. |
/LIC |
Causes a "+" to be displayed next to the trmdef name for jobs that currently are using a node license. |
/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. Also reports the program version edit number—if available—as a parenthesized suffix to the current program name. |
/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. |
/? |
Writes switch listing to the screen. |
History
2020 December, A-Shell 6.5.1693: SYSTAT 3.2(185) adds the switch "LIC" which causes a "+" to be displayed next to the trmdef name for jobs that currently are using a node license.
2020 July, A-Shell 6.5.1688: SYSTAT.LIT 3.2(183) adds /V switch.
2018 November, A-Shell 6.5.1651: SYSTAT.LIT 3.2(182) has been updated to avoid a read-only error related to the smart-scrollback activation feature.
2017 July, A-Shell 6.5.1610: SYSTAT.LIT 3.2(180) now makes the scroll bar visible if the environment supports it (A-Shell/Windows and ATE version 6.5.1610 or later) and the output of the command causes the screen to scroll.
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.
