EMS Manual

Collector Commands and Responses
EMS Manual426909-005
19-46
INFO Command (ZCOM-CMD-INFO)
INFO Command (ZCOM-CMD-INFO)
The ZCOM-CMD-INFO command requests the configuration values of the specified
object. These values are initially set at collector startup (performed by SYSGEN or by
the TACL RUN command) and might have been modified by ZCOM-CMD-ALTER or
ZEMS-CMD-CONTROL. All the configuration attributes are returned in an extensible -
INFO structure (see EMS-Specific Tokens on page 19-10).
The supported objects are EMS collectors (ZCOM-OBJ-COLL) and EMS filters
(ZCOM-OBJ-FILTER). At least one object name is required. The wild-card object name
(*) and the ZCOM-TKN-SUB command modifier token are also supported.
Command Token Usage Considerations
Basic SPI signifies that the presence of this token in the command is dictated by
the basic SPI command language standards that govern multiple objects and
responses.
Optional signifies that the token is optional and need not be supplied by the user.
Required signifies that the token is required and must be supplied by the user.
The optional ZCOM-TKN-INFO-DFLT token is a Boolean that specifies whether
default or current configuration values should be returned in the response. A value
of TRUE requests the default values; a value of FALSE requests the current
values.
The optional ZCOM-TKN-ENQ token specifies the token number of the token
desired. There may be multiple occurrences of this token. Each occurrence causes
a separate response record to be returned. If the specified token is not related to
the specified object, a ZCOM-ERR-CMD-MISMATCH error is returned.
Command Tokens
ZSPI-TKN-MAXRESP
ZCOM-TKN-XMGR
ZCOM-TKN-REQID-xxxx
ZCOM-TKN-OBJNAME
ZCOM-TKN-SUB
ZCOM-TKN-INFO-ENQ
ZCOM-TKN-INFO-DEFLT
ZSPI-TKN-CONTEXT
Token Type
ZSPI-TYP-INT
ZSPI-TYP-STRING
ZSPI-TYP-STRING
ZSPI-TYP-ENUM
ZSPI-TYP-ENUM
ZSPI-TYP-BOOLEAN
ZSPI-TYP-BYTESTRING
Usage
Basic SPI
Optional
Optional
Required
Optional
Optional
Optional
Basic SPI