X25AM Management Programming Manual

Commands and Responses
X25AM Management Programming Manual—528037-001
6-52
ALTER SUBDEVICE Command
ZSPI-TKN-RETCODE
is the standard SPI return token described in the SPI Programming Manual. Some
values of RETCODE that are likely to occur in response to the ALTER
SUBDEVICE command are the following:
For command-specific information about these error numbers, see Error-Handling
Notes. For descriptions of all X25AM error numbers, see Appendix A, Error
Numbers and Error Lists.
ZSPI-TKN-ERRLIST
is a standard SPI error list, as described in the SPI Programming Manual. The list
ends with the token ZSPI-TKN-ENDLIST.
Operational Notes
•
ALTER SUBDEVICE is a sensitive command.
•
The subdevice must be in the STOPPED summary state when this command is
issued.
•
To obtain the current values of the attributes of a subdevice, use the INFO
command.
•
No summary-state transition is associated with this command.
Error-Handling Notes
•
The error identified by the error number ZCOM-ERR-NO-MEM-SPACE is returned
if the block-mode or conversational-mode PAD parameters are to be altered and
the X25AM subsystem cannot obtain enough memory space to perform the
alteration.
•
If an attempt is made to alter the attributes of a subdevice that is not in the
STOPPED summary state, the error identified by the error number ZCOM-ERR-
CMD-INV-IN-SUMSTATE is returned.
-17 (ZCOM-ERR-OBJ-NOT-FOUND): The specified object cannot be
found.
-14 (ZCOM-ERR-NO-MEM-SPACE): The X25AM subsystem cannot
obtain enough memory space to
process the command.
-3 (ZCOM-ERR-CMD-INV-IN-SUMSTATE): The current summary state of the
object prevents processing of the
command.
4999 (ZX25-ERR-EMPTY-RESPONSE): The empty response record is
being returned.