TCP/IP Management Programming Manual

Common Definitions
HP NonStop TCP/IP Management Programming Manual—529636-001
5-4
SPI Standard Definitions
been specified for a command or the NULL object has been specified for the
LISTOBJECTS command.
The server places information in this token, which the server requires to continue
execution of the command at the next object. When a requester receives a
response containing the context token, the requester copies the context token into
a duplicate of the original command message and sends this command message
to the server. The server then processes the next object in the set. This sequence
is repeated until all the objects in the set have been processed.
Once all the objects in the set are processed, the ZSPI-TKN-CONTEXT token is
not placed in the response by the server. Its absence indicates that all objects of
the set have been processed. If the server receives a command with the context
token and there are no more objects to be processed, the server returns the empty
response value (ZCOM-ERR-EMPT-RSP) in the return token
(ZSPI-TKN-RETCODE).
The contents of ZSPI-TKN-CONTEXT should not be processed or altered by the
requester; they should only be echoed to the server in a command. Only one
context token can be present in a command.
ZSPI-TKN-DATALIST
indicates the beginning of a data list within a response. The presence of this token
depends on the value of ZSPI-TKN-MAXRESP. If the value of
ZSPI-TKN-MAXRESP is nonzero, the response tokens, excluding header tokens
and the ZSPI-TKN-CONTEXT token, are enclosed in one or more data lists.
Although there can be multiple data lists within a single response buffer, each data
list must contain information about only one object type.
ZSPI-TKN-ENDLIST
indicates the end of a data list or an error list within a response.
ZSPI-TKN-ERRLIST
indicates the beginning of an error list. All information about warnings or errors,
except ZSPI-TKN-RETCODE, must be enclosed in an error list. An error list is
present only if the return code is nonzero. Note that the empty response does not
contain an error list.
The contents of an error list are owned by the server returning the error list. The
exception is a nested error list, which may have a different owner.
Multiple error lists can be returned in a single response buffer or even in a single
data list.
ZSPI-TKN-ERROR
is the standard SPI error token described in the SPI Programming Manual. Its
value consists of the TCP/IP subsystem ID and one of the TCP/IP subsystem-