SNAX/APC Management Programming Manual

LISTOBJECTS Command
Commands and Responses
111813 Tandem Computers Incorporated 5–67
Tokens in Response Buffer
ZSPI-TKN-DATALIST
is a standard SPI data list, as described in the SPI Programming Manual. The list
ends with the token ZSPI-TKN-ENDLIST.
ZCOM-TKN-OBJNAME
is a standard data communications token that identifies the object name and the
SNAX/APC process name. SNAX/APC object names have the format
$ snax/apc-process-name . object-name . This token is always present in the
response buffer. Refer to Section 3, “Elements of SPI Messages for SNAX/APC,”
for further information on object names.
ZCOM-TKN-OBJTYPE
is a standard data communications token that indicates the object type. For
ZCOM-CMD-LISTOBJECTS, the valid object types are CONVERSATION, LU,
PROC, PTNR-LU, PTNR-MODE, NULL, SESS, TPN, and TPI.
ZSPI-TKN-RETCODE
indicates whether the command was successful and, if not, the reason for failure.
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 discussed in the SPI Programming Manual.
Operational Notes
When an application issues the LISTOBJECTS command with ZCOM-OBJ-NULL
specified, the SNAX/APC subsystem returns the objects, one by one, in a data list.
Each object is represented in the data list by a pair of tokens: ZAPC-TKN-
OBJNAME and ZAPC-TKN-OBJTYPE.
Note that because the LISTOBJECTS command can return information on all
objects in SNAX/APC, the list of objects can be very large.
When ZCOM-OBJ-PROC is specified in the command buffer, only the process
name is returned.