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

SPI Programming Considerations
NonStop TS/MP Management Programming Manual—540082-001
3-22
Receiving and Decoding Response Messages
Resetting Fields With the TACL Program
To reset fields of type FNAME32, CRTPID, or SUBVOL with the TACL program, you
must use the #SETBYTES built-in function. More information on resetting fields with
the #SETBYTES built-in function is available in the SPI Programming Manual.
Receiving and Decoding Response Messages
These subsections summarize the steps your application must take to receive and
decode SPI command responses. These summaries are followed by subsystem-
specific programming considerations for the Pathway subsystem.
For more information on receiving and decoding SPI commands and responses, see
the SPI Programming Manual.
Summary of Steps
Here is a summary of the steps your application must take to receive and decode a
response message:
1. Declare a buffer of appropriate size.
2. Read the response message by using the mechanism appropriate to your
programming language (for example, a WRITEREAD call in TAL).
3. Call SSGET or SSGETTKN to retrieve the values of header tokens and other
tokens from the buffer.
4. On encountering the data-list token (ZSPI-TKN-DATALIST) or the error-list token
(ZSPI-TKN-ERRLIST), make another call to SSGET or SSGETTKN to retrieve the
tokens inside the data list, including the error list if one exists.
5. On encountering a context token (ZSPI-TKN-CONTEXT), finish reading the other
tokens in the buffer. Then, optionally, use SSMOVE or SSMOVETKN to copy the
context token into the command buffer, and resend the command to get the next
message in the response.
ZPWY-VAL-RESETNUMERICINT4 A numeric quadrupleword
ZPWY-VAL-RESETFNAME32 A 32-byte field
ZPWY-VAL-RESETCRTPID A field containing a process ID
ZPWY-VAL-RESETOBJECTNAME A field containing an object name
ZPWY-VAL-RESETSUBVOL A field containing a subvolume name
Table 3-4. Reset Constants
This Constant… Resets…