Pathway/iTS Management Programming Manual

SPI Programming Considerations
NonStop Pathway/iTS Management Programming Manual—426749-002
3-22
Specifying Continuation
2. Initialize the ZNAME field in the ZPWY-DDL-SEL-objecttype token by
assigning a value in the form ZPWY-VAL-ALLobjecttype to the field. The values
are described under Values for Specifying Continuation on page 3-22.
3. Put the selector token and any other needed tokens in the command buffer using
SSPUT.
4. Issue the command for the first time. Upon completion of the command, move the
context token (that is, ZSPI-TKN-CONTEXT) that was returned by the PATHMON
process in the response buffer to the command buffer, using SSMOVE.
5. Reissue the command repeatedly, returning the context token that is returned by
the PATHMON process each time your program resubmits the command. Your
program must keep issuing the command and returning the context token until a
context token is no longer returned and the Pathway subsystem returns the error
ZPWY-ERR-PM-NODATA.
End of Continuation
The Pathway subsystem management programming interface is designed to return a
context token during continuation whenever there is a response in the response buffer.
As a result, the Pathway subsystem always returns an empty response for the last
record of a continuation. The value ZPWY-ERR-PM-NODATA denotes an empty
response buffer, as well as the end of the response continuation dialog.
You must code your management application to expect and interpret
ZPWY-ERR-PM-NODATA during response continuation; this token is the final
indication of the end of continuation.
Values for Specifying Continuation
The following tokens represent the predefined values assigned to Pathway/iTS object
name fields in object-selector tokens:
These values have the same meaning as the asterisk (*) used in the PATHCOM
commands. For example, to implement the PATHCOM INFO TERM * command, you
use the predefined value ZPWY-VAL-ALLTERM in the object-selector token
ZPWY-DDL-SEL-TERM.
Note. When the value you assign to the name field is longer than the name field itself, do
not move the entire literal to the name field. Instead, move only what is needed of the
literal.
Predefined Value Definition
ZPWY-VAL-ALLPROG Multiple PROG objects
ZPWY-VAL-ALLTCP Multiple TCP objects
ZPWY-VAL-ALLTELL Multiple tell messages
ZPWY-VAL-ALLTERM Multiple TERM objects
ZPWY-VAL-ALLTERMTYPE Multiple device types