OSI/AS Management Programming Manual

Command Descriptions
Commands and Responses
056785 Tandem Computers Incorporated 5–7
Command
Descriptions
Each OSI/AS programmatic command and its response is described in detail on the
following pages. The command descriptions are presented in alphabetical order; for
commands that can be applied to more than one object type, a separate description is
given for each command object-type pair. Each command description includes a
syntax box that names (in DDL form) the command, the object type, the tokens in the
command buffer, and the tokens in the response buffer. Following the syntax box are
descriptions of the tokens in the command and the response, in the same order in
which the tokens are listed in the box. Finally, any special considerations (operational
notes) for this command are given.
Not all OSI/AS commands support every common data communications (ZCOM)
token that could apply to that command. If a token other than a header token does not
appear in the box for a command, that token cannot be used in that command.
The syntax notation used for simple tokens is a shorthand version of the essential
information given in the DDL TOKEN-CODE statement. The notation used for
extensible structured tokens gives the token map name first, followed by the DDL DEF
statement declaring the corresponding structure, showing all the fields and their types.
In the syntax box, the contents of error lists are indicated by ellipses; error-list contents
depend on which error occurred (indicated by the value of ZSPI-TKN-RETCODE). For
descriptions of OSI/AS error lists, see Appendix A. For descriptions of common data
communications error lists, refer to the Communications Management Programming
Manual.
The token descriptions that follow the syntax box state whether each token (or field of
an extensible structured token) is required or optional, what its ranges or possible
values are, and what its defaults are, if applicable. Each required field of an extensible
structured token must be assigned a value other than its null value. Optional fields
can also be assigned a value other than the field’s null value, but this is not required.
Descriptions of simple tokens in this section do not identify their token numbers.
However, the symbolic names of the token numbers can be derived from the token
names by simply replacing -TKN- with -TNM-. For example, the token number of the
ZSPI-TKN-MANAGER token is ZSPI-TNM-MANAGER.
The syntax boxes do not include the SPI header tokens, which are always present in
every command and response buffer. Table 5-3 lists the header tokens that can be
queried by using SSGET in response buffers and, in some cases, changed with SSPUT
in command buffers.