z/VM: CP Commands and Utilities Reference - z/VM - IBM

MONITOR START/STOP
Responses
v A virtual machine must load the monitor saved segment and connect to the
*MONITOR CP system service
v A MONITOR START command must be issued.
If the START command is issued when no virtual machine is connected with an
active path to *MONITOR for event data, event recording is held pending until
there is a connection with an active path.
Specific Usage Note for BLOCK:
1. The default BLOCK value is four 4 KB pages.
2. The minimum value for BLOCK is four 4 KB pages.
3. The maximum value for BLOCK is half the number of pages to be used for the
event data area (partition-event config size).
4. The value of BLOCK is saved when monitoring is stopped.
Specific Usage Notes for PARTITION:
1. The default PARTITION size is half the size of the saved segment. The
minimum is nine pages.
2. The minimum PARTITION size is eight pages plus the number of pages
reserved for event configuration records.
Notes:
a. The QUERY MONITOR EVENT command can be used to display the
number of pages currently designated for event configuration records.
b. The MONITOR EVENT CONFIG SIZE command can be used to specify the
number of pages to be reserved for the event configuration area. If the
MONITOR EVENT CONFIG command has not been issued before the
MONITOR START is issued, 68 pages are reserved for event configuration
recording, and the PARTITION size must be at least 76 pages.
c. The maximum PARTITION size depends on whether sample monitoring has
already been started, and on whether any user is connected to *MONITOR
when the command is issued to start event monitoring.
If sample monitoring has not started, and:
v If one or more users are connected, the maximum PARTITION value that
can be entered is the number of pages in the first type SC range of the
saved segment that is currently being used by the monitor.
v If there are no users connected to *MONITOR, the maximum value for
PARTITION is equal to the maximum number of pages that can be
specified as a type SC range with the DEFSEG command.
If sample monitoring has started, the maximum number of pages that can
be specified by PARTITION is reduced by one more than the number of
pages reserved for sample configuration records. (QUERY MONITOR
EVENT and QUERY MONITOR SAMPLE display the number of pages
currently reserved for the event and the sample configuration areas.)
3. The maximum PARTITION size depends on whether sample monitoring has
already been started, and on whether any user is connected to *MONITOR
when the command is issued to start event monitoring.
4. When monitoring is stopped, the value of PARTITION reverts to the default
value.
Response 1:
644 z/VM: CP Commands and Utilities Reference
MONITOR SAMPLE STARTED -- RECORDING IS ACTIVATED.