TS/MP Management Programming Manual (G06.24+, H06.03+)

SPI Programming Considerations

NonStop TS/MP Management Programming Manual—540082-001

3-17

Specifying Continuation

Because 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 subobjects with a single command. Continuation allows

your management application to resubmit a command repeatedly until all objects or

subobjects in a series have been 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 perform:

•

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 on page 3-18.

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, 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.

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.