TCP/IP Management Programming Manual

SPI Programming Considerations
HP NonStop TCP/IP Management Programming Manual—529636-001
4-2
Discontinuing a Command in Progress
Discontinuing a Command in Progress
General programming considerations for discontinuing a command in progress are
discussed in the SPI Common Extensions Manual.
The TCP/IP subsystem supports the use of the token ZSPI-TKN-ALLOW-TYPE, which
allows an application to specify, in a command operating on multiple objects, whether
this subsystem should continue immediately to the next object if an operation failed on
the previous object. The only value supported for this token is ZSPI-VAL-NORM-ONLY.
This means that the TCP/IP subsystem continues to the next object only if no errors or
warnings occurred on the previous object.
When the TCP/IP subsystem discontinues a command because of an error or a
warning, it immediately sends a reply message to the application. The reply message
contains a context token. The application can then either resend or abandon the
command. If the application resends the command, it uses the context token to inform
the TCP/IP subsystem to proceed 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 to TCP/IP commands that operate on objects always contain
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. The supported values of
the token ZSPI-TKN-MAXRESP are 0, -1, and n (any integer value greater than 0).
If multiple response records are to be returned in one reply message, the
recommended buffer size (in bytes) for the response is a predefined value with the
symbolic name ZTCI-VAL-MAX-BUFLEN. If a single response record is to be returned
in each reply message, the recommended buffer size (in bytes) for the response is the
predefined value ZTCI-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.