EMS Manual

Collector Commands and Responses
EMS Manual—426909-005
19-39
CONTROL Command (ZEMS-CMD-CONTROL)
allocated is the same as that described in EMSACOLL—Alternate Collector
Program on page 13-2.
ZEMS-TKN-CDISTPRICPU (type uint; nonshared)
is the token that contains the number of the CPU in which the compatibility
distributor is to operate. This is a request for the compatibility distributor to switch
CPUs—that is, to begin operating in its backup CPU.
This token and the token map ZEMS-MAP-COL-CONTROL-CDIST are mutually
exclusive: do not use both in the command buffer.
ZEMS-MAP-COL-CONTROL-CDIST
is an extensible structured token that helps you give commands to the compatibility
distributor to change its operating characteristics; for example, ZCOL-CDIST-
PRICPU tells it to switch CPUs. In a command message, if you do not supply a
particular field, the distributor leaves that operating characteristic unchanged; that
is, the characteristic is left at the value last given it or at its default value.
This token map and ZEMS-TKN-CDISTPRICPU are mutually exclusive: do not use
both in the command buffer.
ZCOL-CDIST-PRICPU (uint field)
contains the number of the CPU in which the distributor is to operate. This is a
request for the distributor to switch CPUs—that is, to begin operating in its
backup CPU.
ZCOL-CDIST-CONSOLE-OUT (Boolean field)
if TRUE, tells the distributor to ignore the ZCOL-CDIST-TEXTOUT-SET field
and to use the default console, selected at SYSGEN, for text output.
ZCOL-CDIST-TEXTOUT-SET (fname field)
gives the destination file name of the console to which $Z0 sends text output if
the ZCOL-CDIST-CONSOLE-OUT field is FALSE. You can also specify the
destination file name with the EMSCCTRL utility (keyword TEXTOUT—see
EMSCCTRL—Control Collector Utility on page 13-9) or with the PUP
CONSOLE command in D-series RVUs. This field allows certain device types
only.
This field is ignored if the ZCOL-CDIST-CONSOLE-OUT field is TRUE.
Note. You must include the ZEMS-MAP-ACOL-CONTROL or ZEMS-MAP-COL-
CONTROL token in the command buffer when you use the CONTROL command to
manage the alternate collector. You can include both tokens in the command buffer if
you want to both change alternate collector attributes and allocate MAXFILE log files.