Expand Management Programming Manual

COMMANDS AND RESPONSES
SWITCH Command
(ZSPI-TKN-) MAXRESP, CONTEXT, RESPONSE-TYPE, ALLOW-TYPE, and
COMMENT are standard SPI tokens described in the Distributed
Systems Management (DSM) Programming Manual . With the exception
of ZSPI-TKN-COMMENT, duplicate occurrences of these tokens are
not allowed.
Tokens in Response Buffer
ZSPI-TKN-DATALIST is a standard SPI data list, as described in
the Distributed Systems Management (DSM) Programming Manual . The
list ends with the token ZSPI-TKN-ENDLIST.
ZCOM-TKN-OBJNAME is an object-name token that contains the object
name of a line-handler process that was switched by the command.
This token is present in every response record. ZCOM-TKN-OBJNAME
is described in Section 6, "Common Definitions."
ZCOM-TKN-OBJTYPE is an object-type token that contains the value
ZCOM-OBJ-PROCESS. This token is present in every response
record, and it is described in Section 6, "Common Definitions."
ZSPI-TKN-RETCODE is the standard SPI return token described in
the Distributed Systems Management (DSM) Programming Manual .
Some values of RETCODE that are likely to occur in response to
the SWITCH command are the following:
-16 (ZCOM-ERR-OBJ-ALRDY-IN-SUMSTATE): The object is already
in the desired summary state.
1 (ZEXP-ERR-TOO-MANY-OBJNAMES): More than 30 object names
were in the command.
2 (ZEXP-ERR-NEG-LH-RSP): The EXPAND line handler returned
a negative response.
3 (ZEXP-ERR-EMPT-RSP): The empty response record is being
returned.
4 (ZEXP-ERR-TKN-CONFL): A token conflict occurred in the
command.
For command-specific information about these error numbers,
see "Error-Handling Notes" below. For descriptions of all
EXPAND error numbers and their associated error lists, refer to
Appendix A.
ZSPI-TKN-ERRLIST is a standard SPI error list, as described in
the Distributed Systems Management (DSM) Programming Manual . The
list ends with the token ZSPI-TKN-ENDLIST.
7-114