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

MONITOR EVENT
632 z/VM: CP Commands and Utilities Reference
3. The maximum value for BLOCK is half the number of pages to be used for
event data (partition-event config size).
4. The value of BLOCK is preserved when monitoring is stopped.
Specific Usage Notes for CONFIG SIZE:
1. The default size reserved for event configuration records when event monitoring
is started is 68 pages.
2. The MONITOR EVENT CONFIG SIZE can be issued only when event
monitoring is not active. To change the size after event monitoring has been
started, you must first stop event monitoring.
3. The minimum value for CONFIG SIZE is one 4 KB page.
4. The maximum value for CONFIG SIZE is equal to the maximum number of
pages that can be specified as a type SC range with the DEFSEG command,
minus 8 pages for event data records.
Note: The number of pages reserved must fit within the saved segment to be
used by monitor. This check is made when monitoring is started (if
someone is connected to *MONITOR and the saved segment is known)
or when the first user connects after monitoring has been started.
5. The value of CONFIG SIZE is preserved when monitoring is stopped.
Specific Usage Notes for CONFIG LIMIT:
1. The CONFIG time limit is the amount of time a user can keep the configuration
area in use.
2. The CONFIG time limit default is 1 minute.
3. The minimum value for CONFIG time limit is 1 second.
4. The maximum value for CONFIG time limit is 120 minutes.
5. The CONFIG time limit value must be specified as a whole number.
6. When the CONFIG time limit expires, CP:
v In the EXCLUSIVE environment–stops monitoring and issues message
HCP6239I
v In the SHARED environment–purges the configuration message, releases the
corresponding saved-segment pages, and issues message HCP6253I. Data
recording continues.
7. Configuration records are created and the CONFIG time limit enforced
whenever:
v Recording has begun. (A MONITOR START command is issued and at least
one user is connected, with an active path, for the type of monitoring being
started.)
v Recording is underway and:
– A user connects (with an active path) for that type of monitor data
– The path of a user connected for that type of data becomes active
– The user, whose path to *MONITOR was quiesced when *MONITOR tried
to send a configuration notification message, issues IUCV RESUME
– The user, whose path to *MONITOR was at its IUCV message limit when
*MONITOR tried to send a configuration notification message, issues
IUCV REPLY or REJECT to one or more previous messages from
*MONITOR.
8. CONFIG time limit is preserved when monitoring is stopped.
Specific Usage Notes for PARTITION:
1. The default value of PARTITION is half of the size of the saved segment.
2. The minimum PARTITION size is 8 pages plus the number of pages reserved
for event configuration records. The absolute minimum partition size is 9 pages.