X25AM Management Programming Manual

Commands and Responses
X25AM Management Programming Manual—528037-001
6-94
LISTOBJECTS Command (Lines or Subdevices)
Some values of RETCODE that are likely to occur in response to this form of the
LISTOBJECTS 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.
ZSPI-TKN-CONTEXT
is the standard SPI context token described in the SPI Programming Manual.
Operational Notes
•
All users can issue the LISTOBJECTS command.
•
No summary-state transition is associated with this command.
Error-Handling Notes
•
If the token ZCOM-TKN-SUB is present when the object type is ZCOM-OBJ-SU
and the value is not ZCOM-VAL-SUB-NONE, the error identified by the error
number ZCOM-ERR-TKN-VAL-INV is returned.
•
The error identified by the error number ZCOM-ERR-SUB-NOT-FOUND is
returned if, in the command, the object type is ZCOM-OBJ-LINE, the subordinate-
modifier token ZCOM-TKN-SUB is present and contains the value ZCOM-VAL-
SUB-ONLY, and the specified line has no subordinate subdevices.
•
The error identified by the error number ZCOM-ERR-OBJ-NOT-FOUND is returned
if the object type in the command is ZCOM-OBJ-SU and a specified subdevice
cannot be found.
-30 (ZCOM-ERR-TKN-VAL-INV): A supported token had an improper
value.
-25 (ZCOM-ERR-SUB-NOT-FOUND): No subordinate objects were found.
-17 (ZCOM-ERR-OBJ-NOT-FOUND): The specified object cannot be found.
4999 (ZX25-ERR-EMPTY-RESPONSE): The empty response record is being
returned.