Expand Management Programming Manual

COMMANDS AND RESPONSES
ALTER LINE Command
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 ALTER LINE command are the following:
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.
5 (ZEXP-ERR-OBJ-TYPE-NAME-MISMATC): A conflict exists be-
tween the object type and an object name.
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.
ZSPI-TKN-CONTEXT is the standard SPI context token described in
the Distributed Systems Management (DSM) Programming Manual .
Operational Notes
• ALTER LINE is a sensitive command.
• The line must be in the STOPPED summary state.
• To obtain the current values of the attributes of a line, use
the INFO LINE command.
• Not all line attributes are valid for all types of lines.
Refer to Appendix C for a table that lists the applicable line
attributes for the different types of line handlers. If an
attempt is made to alter an attribute that is not valid for
the line, the error identified by the error number ZEXP-ERR-
NEG-LH-RSP results.
• No summary-state transition is associated with this command.
7-18