EMS Manual

Configuring EMS
EMS Manual—426909-005
12-14
Compatibility Distributor ($Z0)
specified. The value can include both the date and time or just the time. The time
value is assumed to represent local civil time.
If you do not specify a value for the TIME option, the effect depends on whether
you have specified COLLECTOR or LOGFILE (that is, whether you are accessing
the current collector log or a saved log file). If you specified COLLECTOR, event-
message processing starts with the next incoming event message. If you specified
LOGFILE, event-message processing starts with the first event message in the log
file.

The filter used to select or detect messages. You can specify the file name of a
filter object file, filter table EDIT file, or burst filter EDIT file to indicate which filter
you want the distributor to use to select or detect event messages. Omitting the
FILTER parameter indicates that you intend to supply the filter through the
distributor’s programmatic interface or, for consumer and printing distributors, to let
the filter default to pass all event messages. (The default filter does not apply to
forwarding distributors. You must specify a filter.)
Not all option combinations are allowed. For example, you cannot initiate a printing
distributor and request that it send event messages to a collector on another node.
Compatibility Distributor ($Z0)
One compatibility distributor, named $Z0, is allowed on each system. It can be
configured during system generation and is initiated at system load. In that case, it
runs as a process pair. To change which process is the primary process, use the
SWITCH option of EMSCCTRL.
$Z0 can always be stopped by the CDISTSTOP option of EMSCCTRL. The utility
EMSCCTRL controls the operation of the primary collector, and $Z0 indirectly as well,
through a programmatic interface between $0 and EMSCCTRL. $Z0 can only be
started by a system load. After it is stopped, it cannot be restarted without bringing the
system down. For more information about EMSCCTRL, see EMSCCTRL—Control
Collector Utility on page 13-9.
Caution. In RVUs prior to G06.24, the command EMSCCTRL $0 CDISTSTOP should only be
used when both the CPUs on which the process Compatibility Distributor ($Z0) is configured to
run (for example, CPU 0,1) are up. If the command is issued when only CPU 0 is up, the $Z0
process on CPU 0 will stop. The backup process will reappear once CPU 1 comes up. If at any
instance after that, CPU 0 goes down, attempts to reload it will cause CPU halt %010005.
Caution. The command EMSCCTRL $0 CDISTSTOP should not be issued when any of the
CPUs on which $Z0 is configured to run is being reloaded.