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

MONITOR SAMPLE
Usage Notes
USER USERID userid
specifies a list of users that are to be enabled or disabled for sample data
collection. userid is a list of one or more user identifiers, separated by blanks.
SAMPle INTerval n MINutes
SAMPle INTerval n SEConds
specifies the time interval at which the sample data is to be reported. MINUTES
is the default. For additional information, see “Specific Usage Notes for
INTERVAL” on page 640.
SAMPle RATE n SECONDS
specifies the frequency at which the high-frequency sample data is to be
sampled. The operand n is the length of time between high-frequency sampling.
High-frequency sample data is a set of counters and data that represent the
state of the system at the moment they are sampled.
High-frequency sampling is automatically activated whenever the MONITOR
SAMPLE START command is issued, unless the RATE value has been
previously set to STOP. For additional information, see “Specific Usage Notes
for RATE” on page 640.
SAMPle RATE STOP
immediately terminates the sampling of high-frequency data. Data for the
current interval is lost.
SAMPle CONFIG SIZE n
specifies the size in 4 KB pages to be allocated in the saved segment for
SAMPLE configuration records.
SAMPle CONFIG LIMIT n MINutes
SAMPle CONFIG LIMIT N SEConds
specifies the time limit that the configuration records remain in the CONFIG
area of the saved segment before they are refreshed or zeroed.
SAMPle STArt
starts sample monitoring for the domains and their elements specified in
preceding MONITOR SAMPLE commands.
If no application is connected (with an active path) for sample data when the
command is issued, sample recording is held pending. However, high-frequency
sampling, if enabled, is started.
When recording is activated (that is, when there is a user connected with an
active path for sample data), sample configuration records from the monitor
domain are generated. Sample configuration records include information
concerning the memory, processor, paging, real I/O configurations, and initial
sample configuration settings.
SAMPle STOP
deactivates sample monitoring. Collection of single sample data and high
frequency data are stopped. All data collected for the current interval are
purged. The monitor sample profile is not affected by this command.
Note: Do not use this command to stop the MONWRITE utility. (See
“MONWRITE” on page 1853 for more information.)
(General)
638 z/VM: CP Commands and Utilities Reference
1. The following must be done to activate sample recording:
v A saved segment must be defined and saved for the monitor