EMS Manual

Collector Commands and Responses
EMS Manual—426909-005
19-36
CONTROL Command (ZEMS-CMD-CONTROL)
Tokens in Command Buffer
ZEMS-MAP-COL-CONTROL
is an extensible structured token that lets you change collector attributes or give
commands to a primary or alternate collector. If you supply one or more collector-
attribute fields within the structured token, the collector changes the corresponding
attributes. If, in a particular command message, you do not supply a particular field,
the collector leaves the corresponding attribute unchanged. The attribute is left at
the value last given it, or at a system-supplied default value.
Some fields specify a new value for a collector attribute; for example, ZCOL-
MAXFILENNNN tells the collector how many log files the log subvolume may
contain. Other fields contain commands to the collector. For example, the ZCOL-
NEXTLOGFILE field, when set to TRUE, tells the collector to switch log files, and
ZCOL-PRIMARYCPU, when set to the backup CPU number, tells a collector to
switch to that CPU.
ZCOL-PRIMARYCPU (uint field)
contains the number of the CPU in which a collector is to operate. This is a
request for the collector to switch CPUs—that is, to begin operating in its
backup CPU. The only valid value for this field is the number of the current
backup CPU.
ZCOL-LOGSUBVOL (subvol field)
contains the names of the volume and subvolume a collector is to use to create
log files. These names are the first two parts of an HP internal-format file
name. If access to the identified subvolume is not possible, logging continues
in the current subvolume.
ZCOL-NEXTLOGFILE (Boolean field)
if TRUE, tells a collector to close the current log file, create the next sequential
file, and open it. The collector then generates a ZEMS-EVT-FILESWITCH
event message and resumes event-message logging with the new file.
ZCOL-ROTATEFILES (Boolean field)
sets a new value for the ROTATEFILES attribute. A value of TRUE in this field
causes ROTATEFILES to be set to ON, while FALSE sets the attribute to OFF.
Tokens in Response Buffer
ZSPI-TKN-RETCODE token-type ZSPI-TYP-ENUM.
ZSPI-TKN-SERVER-VERSION token-type ZSPI-TYP-UINT.
ZSPI-TKN-SSID token-type ZSPI-TYP-SSID.
ZSPI-TKN-COMMAND token-type ZSPI-TYP-ENUM.