START value for.. is two seconds. If specified, the interval may range from 1 to 99 seconds. It must be less than the
specified value of nnnnn.
If the MONITOR INTERVAL command is not issued, the default
interval is 60 seconds for the primary sampling interval, and
2 seconds for the high-frequency sampling interval. The MONITOR INTERVAL command can be issued at any time; however, if data collection is already in progress, the new interval
does not take effect until the current interval has elapsed.
The MONITOR interval is reset to the defaults when: Iou issue MORITOR STOP, or the monitor stops automatically. The system stops the monitor because of an unrecoverable I/O error. The end-of-tape is reached, or the spool record limit is
reached. r ISPOOLI [to userid] {BUFFS n]
, I , ICPTRACE ITAPE r ,
raddr I MODE { 800} I [BUFFS n] I I I I I 1600 I I I 6250 I L L J J If SPOOL is specified, VM/370 Monitor data collection is begun
to the spool file or tape, or the CP internal trace table is
started. If no optional parameter is provided, SPOOL is the
default. When data collection is stopped and the spool is closed, the
spool file is added to the chain of reader files destined for
the virtual reader of the virtual machine defined by "to userid." The userid may be specified as an asterisk (*) if
the recipient virtual machine is to be the one from which the START co.mand is issued. If the "to userid" option is omitted, the userid specified in the SISMON macro instruction i-su-se4. (See II!- &!anninq AI!,g The "to userid" option overrides
the SISMON specification and stays in effect until the system is re-IPLed or a new co.mand that uses the "to userid- option
is entered.
The monitor spool file is closed by a MONITOR STOP or MONITOR CLOSE co •• and, or when the record count limit is reached (as
specified in the SISMON macro), or when a system restart or system shutdown occurs.
The filename and filetype of the monitor spool file are
generated internally with the filetype, identifying date and time of starting. The class of spool file is specified in the SISMOB macro and defaults to "ft." If no classes of data
collection have been specified with an ENABLE command, those
specified with the SISSON macro are used.
The number of monitor buffers used are as specified SISMON macro, or as requested with the BUFFS option START co.mand. The BUFFS option overrides the
in the
of the SISMON 'The default value is the active trace facility that is SPOOL or TAPE.
98 VM/370 Operator's Guide
specification for the duration of the data collection session.
Future monitoring sessions will also return to the SYSMON specification unless again overridden. If the nu.ber .of
buffers specified in the SYSKON macro has been defaulted, then
the defaults, as described in the MONITOR START TAPE command,
are adopted.
If CPTRACE is specified, the tracing cf events that occur on
the real machine is begun. The events are recorded on the CP internal trace table in chronological order. When the end of
the table is reached, recording continues at the beginning of
the table, overlaying data previously recorded.
1.f TAPE is specified, data collection by MONITOR onto a tape
mounted on a 9-track tape drive is begun. Specify the real
hexadecimal address of the tape drive that you want to use in
raddr. This activates data collection for those classes of MONITOR CALL previously specified in a MONITOR ENABLE command
and begins data collection. The mask that was saved by the MONITOR ENABLE command is moved into control register 8. The
data is collected into buffer pages in real storage. These
pages are separate fro. the internal trace table pages. The BUFFS n operand, where n is a value from 1 to 10, specifies
the nu.ber of 4096-byte buffers to be used for monitoring
operations. If the operand is omitted, a default value is
supplied depending upon the processor model number. 135
138
145 148 155
158
165
168 3031 3032 3033 Buffers
--2--
2
2
3
3
3 4 4
4
4 4 The operator may specify BUFFS 1 if the command entry is limited to ENABLE PERFORM for data collection. Once monitoring is in progress with one buffer specified, it is not
possible to invoke MONITOR with additional ENABLE operands
because of the buffer limitation. Single buffer operation is useful for basic performance
analysis in minimum main storage configurations. 1s each data page is filled, it is written on the tape. CP issues a rewind command followed by a SET MODE co •• and for the
reset value of tape density when MONITOR is started. You can request a different mode setting by specifying the MODE option
in the MOlITOR START TAPE command. Bode values of 800, 1600, or 6250 maybe specified. If you specify a density mode that
the tape drive cannot handle, the control unit does not return
an error condition. In this case, the mode setting is ignored and the default control unit setting is used.
Section 3. CP Commands 99
Previous Page Next Page