EMS Manual

Distributor Commands and Responses
EMS Manual—426909-005
17-13
ALTER Command (ZCOM-CMD-ALTER)

Required signifies that the token is required and must be supplied by the user.

Filter signifies that the required filter parameter tokens are required only if they are
defined as required parameter tokens in the filter.

Unconditional signifies that the token always appears in the response.

The data list (all tokens from -DATALIST to -ENDLIST) forms a single response
record.

Error signifies that this token is present only when an error or warning is reported
in the response record.
For a detailed description of these command and response tokens, see Common
Definitions for ZCOM- Commands on page 17-5.
ALTER Command (ZCOM-CMD-ALTER)
The ZCOM-CMD-ALTER command changes objects in the EMS distributor. The
supported objects are distributors (ZCOM-OBJ-DIST), EMS filters (ZCOM-OBJ-
FILTER), and target collectors (ZCOM-OBJ-TARGET).
The ZCOM-CMD-ALTER can also be used to allow positioning by generation time or
log time, and to alter the settings of the EOF delay and sequential blocking ON and
OFF parameters. All of these attributes are submitted in a control structure; that is,
more than one attribute at a time can be changed. The timestamp fields must be set to
zero (0) if positioning is not required. For Boolean fields, the ZDIST-<XXX>-PRESENT
field must be set to FALSE if a corresponding attribute value is not present, or to TRUE
if it is present. For the ALTER command with object ZCOM-OBJ-DIST, the ZCOM-
TKN-OBJNAME token is optional.
DEFINITION ZEMS-DDL-CONTROL-DIST.
02 ZDIST-GMTTIME TYPE ZSPI-DDL-TIMESTAMP.
02 ZDIST-LOGTIME TYPE ZSPI-DDL-TIMESTAMP.
02 ZDIST-DELAY-PRESENT TYPE ZSPI-DDL-BOOLEAN.
02 ZDIST-EOFDELAY TYPE ZSPI-DDL-INT.
02 ZDIST-BLOCKING-PRESENT TYPE ZSPI-DDL-BOOLEAN.
02 ZDIST-SEQ-BLOCKING TYPE ZSPI-DDL-BOOLEAN.
END
For definitions of the DDL fields, see ZEMS-MAP-CONTROL-DIST Definitions
on
page 17-15.
When the object is an EMS distributor, this command functions like its basic SPI
counterpart (ZEMS-CMD-CONTROL). The only additional token required is the
distributor control map token (ZEMS-DDL-CONTROL-DIST).
Command Tokens (OBJ-DIST)
ZSPI-TKN-MAXRESP
ZCOM-TKN-OBJNAME
ZEMS-MAP-CONTROL-DIST
Token Type
ZSPI-TYP-INT
ZSPI-TYP-STRING
ZEMS-DDL-CONTROL-
DIST
Usage
Basic SPI
Optional
Required