MONITOR command
Summary
- Privileges
- System administrator
- Function
- Displays the status and performance of an Online system. See ONLINE monitoring for more information.
Syntax
MONITOR [[[[SYSTEM | USERS | ? ] [STATISTICS [format-opt [[,] format-opt...]]]] | (usernum [[,]usernum2...])] [[EVERY] n | REPORT] [FSTAT] (filename [[,] filename...])[ACTIVE]]
Where: The parameters and parameters with arguments are optional. The default behavior of the MONITOR command without specifying parameters is:
MONITOR USERS
Specify the following parameters and arguments to display the status and performance you want to examine.
| SYSTEM | indicates that only system information is displayed. | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| USERS | indicates that information for all active users and pseudo subtasks is displayed. | ||||||||||||||
| ? | indicates that all possible sub-commands are displayed.
The synonym of 'HELP' may also be used in place of a question mark. |
||||||||||||||
| STATISTICS | indicates that unformatted (that is, in a format similar to the journal) cumulative system or user statistics are displayed. | ||||||||||||||
| format-opt | includes the following:
|
||||||||||||||
| usrnum | is a number, enclosed by parentheses, representing a user(s) for whom status information is displayed. User numbers can be separated by commas or by one or more blanks. | ||||||||||||||
| EVERY | updates a display every unit of time specified by n. | ||||||||||||||
| n | is the number of seconds Model 204 waits after completing a display before beginning the next display. | ||||||||||||||
| REPORT | requests that a report be started after each set of performance lines is printed on the journal. If neither is specified, a single display is generated. Note that if a MONITOR command containing a REPORT or EVERY option is issued from a full screen terminal, a display is generated each time the ENTER key is pressed. | ||||||||||||||
| FSTAT | displays individual file statistics for each file in the file name list or for all open files for the user. The unformatted display includes all the nonzero file statistics associated with each file. If the keyword FSTAT is omitted and the first position of the first file name you specify is alphabetic, a file list is assumed. | ||||||||||||||
| filename | is the name of an open Model 204 file. If you do not specify a file name list, statistics for all open files are displayed. | ||||||||||||||
| ACTIVE | instructs Model 204 to process only currently active users; that is, users that are not off queue (OFFQ). |
Syntax notes
MONITOR format options can be separated by commas or by one or more blanks. If no arguments are specified, MONITOR generates a single, non-repeating, formatted display of basic information for Model 204 and for all active users.
MONITOR SL is equivalent to MONITOR USERS BASIC SL.
MONITOR CONFLICT is equivalent to MONITOR SL CONFLICT.
PERFORMANCE and CONFLICT are conflicting options.
The chapter on using a system journal and statistics in the Model 204 System Manager's Guide has a description of the individual statistics shown in a MONITOR command display.
Examples
This example displays cumulative system statistics updated every minute:
MONITOR STATISTICS EVERY 60
This example displays cumulative user statistics for users 1, 3, and 5, if they are active:
MONITOR (1, 3, 5) STATISTICS
This example displays all files currently open by active users and pseudo subtasks:
MONITOR FILE
This example displays since-last, file, and performance statistics:
MONITOR SL FILE PERF
Usage notes
The MONITOR command lets the system manager check ongoing system operations and examine system and user statistics when a problem occurs. This command can be used in conjunction with the journal/audit trail statistics to help identify possible bottlenecks or overallocation of resources.
If an unformatted display (STATISTICS) is requested, only system information is displayed. If a formatted display is requested, information about Model 204 and all active users is displayed.
The REPORT display can be stopped at any time by pressing the Attention Key (PA1 or an equivalent key).
When MONITOR displays the CPU statistic as a whole number value, the units are milliseconds; when the value is a decimal number, the units are seconds.
All forms of the MONITOR command can be entered with the synonym M, for example: M DISKBUFF, instead of MONITOR DISKBUFF
Displaying MONITOR and MONITOR SL commands
The output from the MONITOR and MONITOR SL commands accommodate larger statistics, specifically, the columns for the statistics DKRD, DKWR, UDD, OUT, FINDS and RECDS.
Since the number of buffers in a run may exceed 99999 and the number of files may exceed 999, the header label produced by various forms of the MONITOR command has been reformatted. Now a 6-byte number can be displayed under the BUF (number of active buffers) column and a 4-byte number can be displayed under the FLS (number of open files) column. To adjust for these expansion, two bytes were appropriated from the SMPLS (value of RPTCNT) column, so that value can now not exceed 9999. In display the header produced by the MONITOR command has changed from:
USER SVR BUF FLS PCPU SMPLS RUNG 26 87654 876 0.228 60 0.000
to:
USER SVR BUF FLS PCPU SMPLS RUNG 26 987654 9876 0.228 60 0.000
The alignment of columns starting at column 33 to the end of the line have not changed.
Displaying the running users
The user who issues a MONITOR command against the scheduler queues is described as running (RUNG), not just ready (REDY).