AM3270 Management Programming Manual

COMMANDS AND RESPONSES
Command Descriptions
With the exception of the tokens ZSPI-TKN-DATALIST, ZSPI-TKN-
ERRLIST, and ZSPI-TKN-ENDLIST, the order of the tokens in the
lists of tokens in the command buffer and response buffer is not
necessarily the order in which they will actually appear in a
command or response.
• The token ZSPI-TKN-DATALIST, if present in a response, always
appears at the beginning of a response record.
• The token ZSPI-TKN-ERRLIST, if present in a response, always
appears at the beginning of an error list.
• The token ZSPI-TKN-ENDLIST always appears at the end of a
response record started by the token ZSPI-TKN-DATALIST or of
an error list started by the token ZSPI-TKN-ERRLIST.
The list of tokens in the response buffer, except for the context
token ZSPI-TKN-CONTEXT, represents the tokens that can be present
in one reply message that consists of a single response record
or multiple response records. For more information on such
responses, and for information on the context token, refer to the
Distributed Systems Management (DSM) Programming Manual .
The notation used in the box for simple tokens is a shorthand
version of the essential information given in the DDL TOKEN-CODE
statement. Extensible structured tokens are defined by using DDL
DEF statements.
For each token in the command and response buffers, and for
each field of an extensible structured token in the command and
response buffers, the box contains an indication of whether or
not the token or field must be present in the command and of
other dependencies. See "Notation Conventions" at the beginning
of this manual for a description of the notation scheme used.
Error lists are indicated in the box by following the token
ZSPI-TKN-ERRLIST by an ellipsis (...) and the ZSPI-TKN-ENDLIST.
The tokens following the ZSPI-TKN-DATALIST, including the token
ZSPI-TKN-ERRLIST, are indented to show that they are contained
within the data list. The value of the token ZSPI-TKN-MAXRESP
determines whether data lists are used in a response. For
more information on data lists and error lists, refer to the
Distributed Systems Management (DSM) Programming Manual .
Following the box, the tokens in the command buffer and the
tokens in the response buffer are described in the same order as
they appear in the box.
6-7