The EXCLUDE option specifies the devices for which seeks data
should not be collected.
The DISPLAY option enables the contents of the list to be
reviewed.
The DELETE option cancels the list, thus freeing the occupied
real storage. A device list established with the IICLUD! or EXCLUDE option is retained across separate monitoring sessions. A list is not cleared when a MOlITOR STOP co •• mand is entered;
however, the DISPLAY and DELETE options are provided for list
revision when SEEKS analysis is completed.
Though as many device addresses as can fit on
line may be entered, for performance reasons
be kept as short as possible.
a single input
the list should
The MONITOR command's response to unusual conditions are detailed in the
following paragraphs. Auto.s!if SHUTDOWN: Data collection is terminated with a MOlITOR STOP SPOCL coiiand: The spool file is closed and moved for data reduction to the
reader chain of the designated virtual machine. FAILURE: The current monitor data collection buffer is abandoned
but the--Spool file containing all previously output buffers is closed
and made available to the virtual reader of the designated virtual machine for further data reduction. PROGRAM LOAD: If automatic monitoring has been specified with
the SYSMON--iacro of- DMKSYS and the IPL occurs within the time range
specified on that same macro, monitor data collection is automatically started. The -operator is infor.-ed-butnoaction is-required. He say, however, use the MOlITOR DISPLAY SPOOL command to check the
specifications for automatic monitoring. If automatic monitor data collection is
and system messages are issued indicating serious loss
several checks should be made by the operator:
regularly active
of spool space, • Ensure that adequate arrangements have been made to read and reduce
the monitor spool files on a day-to-day basis so that the occupied
spool space can be returned to the system. • Ensure that the data collection classes do not include trace classes,
which produce large volumes of data (e.g. IITSIM or SEEKs). Do this
with the HORITOR DISPLAY command remembering that the specifications
of the DMKSYS maerQ SIS MOB may be temporarily overridden by the
operator or systems analyst using the MONITOR command. • If spool space is a scarce or critical resource, monitoring can
either be done to tape or the LIMIT parameter used. The LIMIT parameter of the SYSMON macro or the LIMIT option of the MOlITOR START SPOOL command can be used to restrict the maximum size of the
monitor spool file by terminating monitoring when the maximum record
count is reached.
102 V8/370 Operator's Guide

The system analyst may determine, after studying the data
reduction reports, that data collection suspension is occurring because
of insufficient buffer space. The operator may be requested to increase
the buffer allocations using the BUFFS n option of the MONITOR START co.mand until the SYSMON macro in DMKSYS can be revised. Q2ing Data reduction may determine that data collection suspension
is occurring because of insufficient buffer space. This usually occurs
when classes USER and/or DASTAP are enabled, while large numbers of
users are logged on, or the system IIO configuration is extensive. Loss
of data may be avoided by specifying additional buffers (with the BUFFS option of the MONITOR START TAPE command) until no more suspensions are
reported by data reduction. UNRECOVERABLE TAPE ERROR: Unrecoverable tape errors are errors that the j/o error--handlIng-routines cannot recover from by standard recovery
procedures. When an unrecoverable error occurs, MONITeR tries to write
two tape marks and rewind/unload the tape. The use of the tape is
abandoned and data collection stops. The operator is informed or action
taken. Whether or not the write-tape-marks and rewind/unload is
successful, the tape drive is released. £Q!QIIIQ!: When end-of-tape occurs, a tape mark is written
on the tape and it is rewound and unloaded. MOIITOR·is stopped and the
operator is informed of the action taken.
INITIAL PROGRAM LOAD: MONITOR START CPTRACE is active after real systea automatic). The MOlITOR tape data collection is off
after IPL. System shutdown i.plies a MOlITOR STOP TAPE co.mand. The system performs normal com.and processing for the STOP TAPE function. If the VM/370 system fails and data collection is
active, an attempt is made to write two tape marks and rewind/unload the
tape. If the tape drive fails to rewind and unload, be sure to write a
tape mark before rewinding and unloading the tape. MONITOR data
collection is terminated by the system failure. lLQ A supported tape drive must be dedicated to the system for
the duration of the monitoring. The following response occurs if you issue the MOlITOR DISPLAY co.mand and data collection is on tape. If spool files are used, then the
automatic monitoring specifications and status are listed as described
in the MONITOR DISPLAY section. CLS nn
nn KEYWORD keyword
keyword
CPTRACE STATUS ENABLED
DISABLED
ENABLED
Section 3. CP Commands 103