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
r , STOP ISPOOL I ICPTRACEI ITAPE I L .I CLOSE lUTODISK If SPOOL is specified, the VM/370 Monitor data collection to a
spool file or tape is stopped or the CP internal trace table
is stopped. If no option is specified and the VM/370 Monitor is active, then data collection will be terminated whether a
spool file or tape is in use. Internal tracing can only be
stopped by specific use of the CPTRACE option. If automatic VM/370 Monitor data collection is active when the MONITOR STOP SPOOL command is entered, monitoring ceases and will not start
again (even if the current time is within the bounds of the TIME operand of the SISMON macro) unless the system fails or
is shut down and reloaded.
If CPTRACE is specified it terminates the internal trace table
event tracing. Event recording ceases but the pages of
storage containing the CP internal trace table are not
released. Tracing can be restarted at any time by issuing the MOBITOR START CPTRACE command. If TAPE is specified it stops data collection by MOlITOR on
the tape. A zero mask is immediately stored in control
register 8, thus disabling MONITOR CALL interruptions. The
last partially filled page is written out, two tape marks are
written, and the tape is rewound and unloaded. The two buffer
pages, which were obtained at the time the MCNITOR START TAPE command was processed, are released.
Note: The CPTR1CE and TAPE or SPOOL operands of the MOlITOR coiiand are completely separate functions. Co •• ands affecting
the status of one function have no effect on the other.
closes the current spool file, making it available to the
reader of the recipient virtual machine and continues monitoring with a new spool file. This option may be used
when the Yft/370 ftonitor is spooling the collected performance
data and you want to reduce the data collected thus far. }
overrides the specification in the SISMOB macro for automatic
monitoring. This only affects the automatic startup of monitoring& If autoBatic Bonitoring is already active, only a MOlITOR STOP command will stop it manually. In general, any attempts to override the definitions of
the SISMON macro instruction with co.mands are temporary. 10 Monitor checkpointing is attempted so that an IPL or crash
causes full restoration of the initial automatic monitoring
definitions. 100 VM/370 Operator's Guide
Previous Page Next Page