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

Purpose
Operands
MONITOR EVENT
Use MONITOR EVENT to establish or modify a profile for event data collection. You
can also use this command to begin or end event monitoring. An event data profile
lists:
v Data domains and domain elements to be monitored
v The number of pages reserved for event configuration records
v The block and partition values the shared segments.
Note: MONITOR EVENT START/STOP does not affect the profile and is not a
subset of MONITOR EVENT ENABLE/DISABLE.
ENable
enables the specified domains and their elements for event data collection.
Event data is collected only from those domains that have been enabled.
ENABLE is the default.
Note: The MONITOR domain is always enabled for event monitoring.
DISable
disables the specified domains or their elements from event data collection.
Note: The MONITOR domain cannot be disabled from monitoring.
ALL
specifies that all domains and all their elements will be enabled or disabled for
event data collection, including:
v APPLDATA (all authorized users)
v I/O (all devices)
v PROCESSOR
v SCHEDULER (all users)
v SEEKS (all DASD devices)
v STORAGE
v USER (all users)
Note: The MONITOR domain is enabled for event data collection at all times.
APPLdata
specifies that the APPLDATA domain will be enabled or disabled for event data
collection. APPLDATA domain is where CP collects data generated by an
application program in a virtual machine. The virtual machine issues
DIAGNOSE X'DC' START to declare a buffer from which CP can collect the
information. For information on DIAGNOSE X'DC', see the z/VM: CP
Programming Services book.
APPLDATA ALL
specifies that all authorized users will be enabled or disabled for event
monitoring in the APPLDATA domain. To be authorized for monitoring in the
APPLDATA domain, the user’s directory entry must contain an OPTION
APPLMON statement.
APPLdata USERID userid
specifies a list of users to be enabled or disabled for event monitoring in the
APPLDATA domain. The userid is a list of one or more user IDs, separated by
blanks, from whom data is collected. Each user specified in this list must have
the OPTION APPLMON statement in their directory entry. Users that do not
have this statement in their directory entries will not be enabled for this domain.
Chapter 2. CP Commands 627