TCP/IP TELNET Management Programming Manual

Receiving and Decoding the Response Buffer
SPI Programming Considerations
4–2 53474 Tandem Computers Incorporated
subsystem should continue to the next object only if no errors or warnings occurred on
the previous object.
Although this option stops processing whenever an error or warning occurs, the
application can still continue the command by using the context token according to the
following procedure: When the TELNET subsystem discontinues a command because
of an error or warning, it immediately sends a reply message to the application. The
reply message contains a context token. The application can then either re-send or
abandon the command. Should the application re-send the command, it can use the
context token to inform the TELNET subsystem to continue to the next object in the
set.
Receiving and
Decoding the
Response Buffer
The following programming considerations apply when an application receives and
decodes the response buffer.
Response records of responses to TELNET commands that operate on objects always
contain response information for the operation of the command on a single object.
The subsystem supports multiple response records in a single reply message. The
number of response records returned in one reply message is controlled by the value
of the header token ZSPI-TKN-MAXRESP in the command. Here are the values of the
ZSPI-TKN-MAXRESP token supported by TELNET:
n Specifies up to n responses, where n is an integer greater than 0, each
enclosed in a list.
0 Specifies a single response, not enclosed in a list.
-1 Specifies as many responses as will fit in the buffer, each enclosed in a list.
If multiple response records are going to be returned in one reply message, the
recommended buffer size (in bytes) for the response is a predefined value with the
symbolic name ZTNT-VAL-MAX-BUFLEN. If a single response record is going to be
returned in each reply message, the recommended buffer size (in bytes) for the
response is the predefined value ZTNT-VAL-BUFLEN.
The subsystem supports multiple response records over multiple messages
(continuation) by returning a context token when a response is continued.
The responses to the INFO, LISTOPENS, RESETSTATS, STATISTICS, and STATUS
commands each contain an extensible structured token that returns the requested
information.
The object-name token, ZCOM-TKN-OBJNAME, can appear more than once in a
response record returned by the LISTOBJECTS command. This is the only case in
which a token might appear multiple times in a response record.