OSI/AS Management Programming Manual

LISTOBJECTS SUBSYS Command
Commands and Responses
056785 Tandem Computers Incorporated 5–177
must be the same as the OSI manager process name specified in either ZSPI-TKN-
MANAGER or ZCOM-TKN-XMGR.
ZCOM-TKN-SUB
specifies whether LISTOBJECTS is to return the name of the specified subsystem
(that is, the name of its OSI manager process), the names of its subordinate objects
in the OSI/AS object hierarchy, or both. The possible values are as follows:
ZCOM-VAL-SUB-ALL Select the named subsystem and all of its subordinate
objects.
ZCOM-VAL-SUB-NONE Select only the named subsystem.
ZCOM-VAL-SUB-ONLY Select only the subordinate objects.
ZCOM-OBJ-objtype Select only those subordinate objects of the specified
object type.
This token is optional, but can occur no more than once in the command. The
default value is ZCOM-VAL-SUB-NONE. Note that if you do not assign this
token a value other than ZCOM-VAL-SUB-NONE, the response will be trivial
(only the specified subsystem name will be returned).
ZCOM-TKN-CMD-TIMEOUT
is described in the Communications Management Programming Manual.
ZSPI-TKN-RESPONSE-TYPE, ZSPI-TKN-ALLOW-TYPE, ZSPI-TKN-COMMENT,
and ZSPI-TKN-CONTEXT
are described in the Distributed Systems Management (DSM) Programming Manual.
Tokens in Response Buffer
ZSPI-TKN-DATALIST
introduces a data list, as described in the Distributed Systems Management (DSM)
Programming Manual; the final ZSPI-TKN-ENDLIST ends the data list. These
tokens enclose the other response tokens only if the value of the header token
ZSPI-TKN-MAXRESP is nonzero. If ZSPI-TKN-MAXRESP is nonzero, all object
names for a particular object type are enclosed in a single data list, provided they
can fit into one response message. Multiple data lists, containing names of objects
of different object types, can appear in the response if ZCOM-TKN-SUB is
specified with a value other than ZCOM-TKN-SUB-NONE. In addition, multiple
response messages can be returned.
ZCOM-TKN-OBJTYPE and ZCOM-TKN-OBJNAME
are described in the Communications Management Programming Manual. One ZCOM-
TKN-OBJNAME token is included for each subordinate object returned.