EMS Manual

EMS Programs
EMS Manual—426909-005
13-12
EMSCCTRL—Control Collector Utility
generates a “No Operation” message on its OUT file. If PLF is already
enabled, FILTER ON has no effect on the collector.
Specifying FILTER RESET disables PLF and causes the collector to delete
any previously entered filters. If PLF is already disabled and the collector
has no retained filters, FILTER RESET has no effect on the collector.
The filter specified in the filter-name variable can be a compiled filter, a
filter table, or a single burst filter. If a burst filter is specified and the
SUPPRESS keyword is also specified, EMSCCTRL generates an error
message in its OUT file. Only one burst filter can be specified for a
collector. Specifying a burst filter when BDS is enabled causes the BDS
configuration parameter values to be replaced by those contained in the
burst filter.
If a burst filter is deleted and BDS is subsequently enabled, the burst filter
configuration parameters from the deleted burst filter are still active for that
collector.
If BDS is specified using the SUPPRESS keyword, only SUPPRESS
ON/OFF can enable or disable BDS.
LOGSUBVOL [ subvol ]
if subvol is present, it gives the name of the volume and subvolume in
which a collector will create log files. If subvol is omitted, this option
directs the collector to use the user’s current volume and subvolume.
The default value of the LOGSUBVOL parameter for the primary collector,
which is established at system load, is:
sysvol.ZLOGnn
If a new file is needed when ROTATEFILES is ON and MAXFILE log files
already exist in the log subvolume, the primary collector purges the log file
containing the messages logged earliest, and creates a new file with the
next name in the sequence (files are named ZZEV0000 through
ZZEV9999).
For example, suppose that the MAXFILE value is four, that all four files are
in use, that a new file is needed, and that the current log file is named
ZZEV0034. The collector purges ZZEV0031, creates ZZEV0035, and
resumes logging event messages.
sysvol
name of the disk volume from which the system was loaded—
typically $SYSTEM.
nn
number in the name of the subvolume from which the system was
loaded: SYSnn.