TS/MP 2.5 Management Programming Manual

default values in each optional field. Consequently, the program does not have to determine either
the PATHMON process null values or the defaults.
Specifying Continuation
As the Pathway subsystem does not support multiple responses per response buffer, your
management application must use continuation if you want to change or query a series of objects
or sub-objects with a single command. Continuation allows your management application to
resubmit a command repeatedly until all objects or sub-objects in a series are accessed. The
Pathway subsystem supports response continuation for some commands but always returns only a
single response per response buffer.
Continuation, therefore, is helpful to use when you want to:
• Affect, query, or control more than one object or subobject
• Query a specific object or subobject when you do not have its name or when its name has
changed
Continuation Procedure
To specify continuation for commands that support it, your program must:
1. Call the SSINIT procedure, specifying the appropriate command (ZPWY-CMD- ) and object
(ZPWY-OBJ- ).
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” (page 40).
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.
3. Put the selector token and any other needed tokens in the command buffer using SSPUT.
4. Issue the command for the first time, and then, 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 by 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 a response is 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
These tokens represent the predefined values assigned to TS/MP object name fields in object-selector
tokens:
DefinitionPredefined Value
Multiple LINKMON processZPWY-VAL-ALLLM
All requesters of PATHMONZPWY-VAL-ALLPMREQUESTER
40 SPI Programming Considerations