SYS!ON Macro SYSMON Macro
The SYSMON macro is used to invoke daily automatic performance data
collection with the VM Monitor. The IBM Field Developed Program Virtual Machine Facility/370: Performance/Monitor Analysis Program is equipped
with a front end assembly language routine that contains the appropriate
diagnose commands to read the file and perform data reduction. r The format of the SYSMON macro is:
Name Operation SYS!ON r , IUSERID=OPERATORI j jUSERID=userid I I L .J
f I r , , I ,CLASS=!! , I I,CLASS=classl , L .J , , r , I I I,AUTO=YESI I L .J , Operands I r , I 'LENABLE=JEERFORM,USER,DASTAPL--- __ ' , "ENABLE= (classa,classb,classc, ••• ) I , L .J , , r , I , "TII1E=(h1:m1,h2:m2) I I I,TIME=ALL I , I,TIME=NONE I , L .! , , r , I ,.« LIMIT= J50000, NOSTOP} I I "LIMIT= (limit, STOP) I I " LIMIT= ( limit, NOSTOP) , f I,LI!!IT=(limit,SAMPLE) I I L J r , r ,
r 'LBUFlS=£EY default, I "BUFFS=n I , L J r , ,USERID=OPERATORI IUSERID=userid I L J is the userid of the virtual machine that will receive the monitor
spool file in its virtual reader. The default is OPERATOR but any valid system directory entry may be specified. Part 2. Defining Your V!/310 System 111

SYSP!ON P!acro r , I CL ASS=P! I I CL ASS=class I L .J
specifies the spool file to be generated to contain monitor data.
Any valid class (A through Z and 0 through 9) may be used but the
default P! is preferred since the VP!AP data reduction Field
Developed Program is designed to reduce only spool files of that
class.
r , I AUTO=NO I I AUTO=YES I L .J
specifies whether or not automatic monitoring should take place
according to the rema1n1ng SYSP!ON parameter specifications. The default, NO, requires the installation to make a specific change to
cause automatic monitoring. All other parameters may be system
default values, giving positive and useful monitoring results.
r , IENABLE=(PERFORM,USER,DASTAP) , lENABLE=(classa,classb,classc, ••• ) , L .J
specifies any combination of valid monitor classes of data
collection. It is assumed that the system analyst understands the
use of the various classes, the overhead incurred in data
collection, and the relative magnitude of the corresponding data
reduction. The default specifies sampled data classes only and are
considered minimal for useful data reduction. The default classes
are sufficient for analysis of a system's load environment and
performance profile with a view to diagnosis of possible bottleneCKS and for establishing long term growth trends.
r , lTIP!E=(09:00,17:00) , I TIM E= (h 1 : m 1 , h 2 : m 2) I ITIP!E=ALL , lTIME=NONE I L .J
specifies the time period in each day that automatic monitoring
(performance data collection) should take place. This parameter
may indicate a start and stop time in hours and minutes using a
24-hour clock; continuous monitoring (if ALL is specified) or no
monitoring (if NONE is specified) unless the operator or system
analyst overrides this specification with the PlONITOR command. If
a system restart occurs during an automatic monitoring period, the
old spool file is closed out and a new one is started, according to
the 5YSMON specifications. For useful data reduction, several
hours of monitoring is suggested.
Note: This same closeout occurs at midnight if ALL is specified.
r , I LIMIT= (50000, NOSTOP) I ILIP!IT=(limit,STOP) I I LIMIT= (limit, NOSTOP) , I LIMIT= (limit, SAMPLE) I L .J
specifies the maximum number of monitor record buffers that can be
added to the monitor spool file before it is closed, whether or not
monitoring should be terminated when the limit is reached or the
periodic closing of the monitor spool file after a specified number
of samples (also defined by the value of LIPlIT) have been
collected. This parameter gives the installation more control over 1
7 8 IBP! VM/370 Planning and System Generation Guide