MONITOR command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
m (misc formatting and remove "Displaying MONITOR and MONITOR SL commands" section)
 
Line 16: Line 16:
</p>
</p>
   
   
<b>Where:</b>
Where:  
The parameters and parameters with arguments are optional. The default behavior of the MONITOR command without specifying parameters is:  
 
The parameters are optional. The default behavior of the <var>MONITOR</var> command without specifying parameters is:  
<p class="code">MONITOR USERS
<p class="code">MONITOR USERS
</p>
</p>
<p>Specify the following parameters and arguments to display the status and performance you want to examine.</p>
<p>
Specify the following parameters and arguments to display the status and performance you want to examine.</p>
<table>  
<table>  
<tr>
<tr>
<th><var>SYSTEM</var></th>
<th><var>SYSTEM</var></th>
<td> indicates that only system information is displayed.</td>
<td>Only system information is displayed.</td>
</tr>
</tr>
   
   
<tr>
<tr>
<th><var>USERS</var></th>
<th><var>USERS</var></th>
<td> indicates that information for all active users and pseudo subtasks is displayed.</td>
<td>Information for all active users and pseudo subtasks is displayed.</td>
</tr>
</tr>
   
   
<tr>
<tr>
<th><var>?</var></th>
<th><var>?</var></th>
<td> indicates that all possible sub-commands are displayed. The synonym of 'HELP' can also be used in place of a question mark.
<td>All possible sub-commands are displayed. The synonym <code>HELP</code> can also be used in place of a question mark.
<p>Introduced in V7.7.</p></td>
<p>
Introduced in V7.7.</p></td>
</tr>
</tr>
   
   
<tr>
<tr>
<th><var>STATISTICS</var></th>
<th><var>STATISTICS</var></th>
<td> indicates that unformatted (that is, in a format similar to the journal) cumulative system or user statistics are displayed.</td>
<td>Unformatted (that is, in a format similar to the journal) cumulative system or user statistics are displayed.</td>
</tr>
</tr>
   
   
<tr>
<tr>
<th>format-opt</th>
<th>format-opt</th>
<td> includes the following:
<td>Includes the following:
<table>
 
 
<table>
<tr> <th>
<tr class="head"><th><p>Option</p></th>  
<p>Option</p>
<th><p>Displays...</p></th></tr>
</th> <th>
<p>Displays...</p>
</th> </tr>
    
    
<tr> <th><var>
<tr> <th><var><p>ALL</p></var></th>  
<p>ALL</p>
<td><p>All formatted information (USERS displays only) except for CONFLICT information.</p></td> </tr>
</var></th> <td>
<p>All formatted information (USERS displays only) except for CONFLICT information.</p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var><p>BASIC</p></var></th>  
<p>BASIC</p>
<td>Basic information in all formatted displays. This is the default. </td></tr>
</var></th> <td>Basic information in all formatted displays. This is the default.   </td> </tr>
   
   
<tr> <th><var>
<tr> <th><var><p>CONFLICT</p></var></th>  
<p>CONFLICT</p>
<td><p>Since-last statistics that keep track of critical file resource conflicts and record locking conflicts (USERS displays only). CONFLICT is mutually exclusive with PERFORMANCE. </p></td></tr>
</var></th> <td>
<p>Since-last statistics that keep track of critical file resource conflicts and record locking conflicts (USERS displays only). CONFLICT is mutually exclusive with PERFORMANCE. </p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var><p>FILE[S]</p></var></th>  
<p>FILE[S]</p>
<td><p>Open files for each user, in a formatted display (USERS displays only).</p></td> </tr>
</var></th> <td>
<p>Open files for each user, in a formatted display (USERS displays only).</p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var><p>PERFORMANCE</p></var></th>  
<p>PERFORMANCE</p>
<td><p>Performance statistics (USERS displays only) if the <var class="product">Model&nbsp;204</var> parameters RPTCNT and SMPLTIM are nonzero. This option can be abbreviated as PERF. PERFORMANCE is mutually exclusive with CONFLICT.</p></td></tr>
</var></th> <td>
<p>Performance statistics (USERS displays only) if the <var class="product">Model&nbsp;204</var> parameters RPTCNT and SMPLTIM are nonzero. This option can be abbreviated as PERF. PERFORMANCE is mutually exclusive with CONFLICT.</p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var><p>SL</p></var></th>  
<p>SL</p>
<td><p>Since-last user statistics (USERS displays only). </p></td></tr>
</var></th> <td>
<p>Since-last user statistics (USERS displays only). </p>
</td> </tr>
 
</table>
</table>
</td>
</td></tr>
</tr>
   
   
<tr>
<tr>
<th>usrnum</th>
<th>usrnum</th>
<td> 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.</td>
<td>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.</td></tr>
</tr>
   
   
<tr>
<tr>
<th><var>EVERY</var></th>
<th><var>EVERY</var></th>
<td> updates a display every unit of time specified by n.</td>
<td>Updates a display every unit of time specified by <var class="term">n</var>.</td></tr>
</tr>
   
   
<tr>
<tr>
<th>n</th>
<th>n</th>
<td> is the number of seconds <var class="product">Model&nbsp;204</var> waits after completing a display before beginning the next display. </td>
<td>The number of seconds <var class="product">Model&nbsp;204</var> waits after completing a display before beginning the next display. </td>
</tr>
</tr>
   
   
<tr>
<tr>
<th><var>REPORT</var></th>
<th><var>REPORT</var></th>
<td> 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.</td>
<td>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 <var>MONITOR</var> command containing a <var>REPORT</var> or <var>EVERY</var> option is issued from a full screen terminal, a display is generated each time the Enter key is pressed.</td></tr>
</tr>
   
   
<tr>
<tr>
<th><var>FSTAT</var></th>
<th><var>FSTAT</var></th>
<td> 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.</td>
<td>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.</td>
</tr>
</tr>
   
   
<tr>
<tr>
<th>filename</th>
<th>filename</th>
<td> is the name of an open <var class="product">Model&nbsp;204</var> file. If you do not specify a file name list, statistics for all open files are displayed. </td>
<td>The name of an open <var class="product">Model&nbsp;204</var> file. If you do not specify a file name list, statistics for all open files are displayed. </td>
</tr>
</tr>
   
   
<tr>
<tr>
<th><var>ACTIVE</var></th>
<th><var>ACTIVE</var></th>
<td> instructs <var class="product">Model&nbsp;204</var> to process only currently active users; that is, users that are not off queue (OFFO). (OFFO is used as of version 7.7; OFFQ is used in version 7.6 and earlier.)</td>
<td>Instructs <var class="product">Model&nbsp;204</var> to process only currently active users; that is, users that are not off queue (OFFO).  
</tr>
<p class="note"><b>Note:</b> OFFO is used as of version 7.7. OFFQ is used in version 7.6 and earlier. </p></td></tr>
</table>
</table>
===Syntax notes===
===Syntax notes===
<p>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 <var class="product">Model&nbsp;204</var> and for all active users.  </p>
<p>
<p>MONITOR SL is equivalent to MONITOR USERS BASIC SL. </p>
<var>MONITOR</var> format options can be separated by commas or by one or more blanks. If no arguments are specified, <var>MONITOR</var> generates a single, non-repeating, formatted display of basic information for <var class="product">Model&nbsp;204</var> and for all active users.  </p>
<p>MONITOR CONFLICT is equivalent to MONITOR SL CONFLICT.</p>
<p>
<p>PERFORMANCE and CONFLICT are conflicting options.</p>
<code>MONITOR SL</code> is equivalent to <code>MONITOR USERS BASIC SL</code>. </p>
<p>See [[ONLINE monitoring]] for a description of the individual statistics shown in a MONITOR command display.</p>
<p>
<code>MONITOR CONFLICT</code> is equivalent to <code>MONITOR SL CONFLICT</code>.</p>
<p>
<var>PERFORMANCE</var> and <var>CONFLICT</var> are conflicting options.</p>
<p>
See [[ONLINE monitoring]] for a description of the individual statistics shown in a <var>MONITOR</var> command display.</p>


==Examples==
==Examples==
Line 139: Line 123:
<p class="code">MONITOR STATISTICS EVERY 60   
<p class="code">MONITOR STATISTICS EVERY 60   
</p>
</p>
<p>This example displays cumulative user statistics for users 1, 3, and 5, if they are active: </p>
<p>
This example displays cumulative user statistics for users 1, 3, and 5, if they are active: </p>
<p class="code">MONITOR (1, 3, 5) STATISTICS
<p class="code">MONITOR (1, 3, 5) STATISTICS
</p>
</p>
<p>This example displays all files currently open by active users and pseudo subtasks:</p>
<p>
This example displays all files currently open by active users and pseudo subtasks:</p>
<p class="code">MONITOR FILE
<p class="code">MONITOR FILE
</p>
</p>
<p>This example displays since-last, file, and performance statistics:</p>
<p>
This example displays since-last, file, and performance statistics:</p>
<p class="code">MONITOR SL FILE PERF
<p class="code">MONITOR SL FILE PERF
</p>
</p>


==Usage notes==
==Usage notes==
<p>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.</p>
<p>
<p>If an unformatted display (STATISTICS) is requested, only system information is displayed. If a formatted display is requested, information about <var class="product">Model&nbsp;204</var> and all active users is displayed. </p>
The <var>MONITOR</var> 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 over-allocation of resources.</p>
<p>The REPORT display can be stopped at any time by pressing the Attention Key (PA1 or an equivalent key). </p>
<p>
<p>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.</p>
If an unformatted display (<var>STATISTICS</var>) is requested, only system information is displayed. If a formatted display is requested, information about <var class="product">Model&nbsp;204</var> and all active users is displayed. </p>
<p>All forms of the MONITOR command can be entered with the synonym M, for example: M DISKBUFF, instead of MONITOR DISKBUFF</p>
<p>
====Displaying MONITOR and MONITOR SL commands====
The <var>REPORT</var> display can be stopped at any time by pressing the Attention Key (PA1 or an equivalent key). </p>
<p>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.</p>
<p>
<p>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: </p>
When <var>MONITOR</var> displays the CPU statistic as a whole number value, the units are milliseconds; when the value is a decimal number, the units are seconds.</p>
<p class="code">USER SVR  BUF FLS  PCPU  SMPLS    RUNG
<p>
  26    87654 876 0.228    60  0.000
All forms of the <var>MONITOR</var> command can be entered with the synonym <var>M</var>. For example: <code>M DISKBUFF</code> is equivalent to <code>MONITOR DISKBUFF</code>.</p>
</p>
 
<p>to:</p>
<p class="code">USER SVR    BUF  FLS  PCPU SMPLS  RUNG
  26    987654 9876 0.228  60  0.000
</p>
<p>The alignment of columns starting at column 33 to the end of the line have not changed.</p>
====Displaying the running users====
====Displaying the running users====
<p>The user who issues a MONITOR command against the scheduler queues is described as running (RUNG), not just ready (REDY). </p>
<p>
The user who issues a <var>MONITOR</var> command against the scheduler queues is described as running (RUNG), not just ready (REDY). </p>
 
[[Category: System administrator commands]]
[[Category: System administrator commands]]
[[Category:Commands]]
[[Category:Commands]]

Latest revision as of 17:22, 21 December 2016

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 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 Only system information is displayed.
USERS Information for all active users and pseudo subtasks is displayed.
? All possible sub-commands are displayed. The synonym HELP can also be used in place of a question mark.

Introduced in V7.7.

STATISTICS Unformatted (that is, in a format similar to the journal) cumulative system or user statistics are displayed.
format-opt Includes the following:

Option

Displays...

ALL

All formatted information (USERS displays only) except for CONFLICT information.

BASIC

Basic information in all formatted displays. This is the default.

CONFLICT

Since-last statistics that keep track of critical file resource conflicts and record locking conflicts (USERS displays only). CONFLICT is mutually exclusive with PERFORMANCE.

FILE[S]

Open files for each user, in a formatted display (USERS displays only).

PERFORMANCE

Performance statistics (USERS displays only) if the Model 204 parameters RPTCNT and SMPLTIM are nonzero. This option can be abbreviated as PERF. PERFORMANCE is mutually exclusive with CONFLICT.

SL

Since-last user statistics (USERS displays only).

usrnum 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 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 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 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 (OFFO).

Note: OFFO is used as of version 7.7. OFFQ is used in version 7.6 and earlier.

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.

See ONLINE monitoring for 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 over-allocation 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 is equivalent to MONITOR DISKBUFF.

Displaying the running users

The user who issues a MONITOR command against the scheduler queues is described as running (RUNG), not just ready (REDY).