SNAX/APC Management Programming Manual

SNAX/APC Response Buffers
Commands and Responses
5–6 111813 Tandem Computers Incorporated
SNAX/APC Response
Buffers
SNAX/APC can return nonsegmented and segmented responses. Segmented
responses may be requested on the INFO PROC and LISTOPENS command.
The structure of a response record returned by SNAX/APC adheres to the definitions
in the SPI Programming Manual. The possible values of ZSPI–TKN–RETCODE and
their associated error lists are given in Appendix A, “Error Numbers and Error Lists.”
The structure of the segment list returned by SNAX/APC is:
Token Value
––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
ZSPI–TKN–SEGLIST Start Segment
ZCMK–TKN–SEGTYPE Segment Type
.
(data)
.
.
ZSPI–TKN–ERRLIST Error list (if present)
.
.
ZSPI–TKN–ENDLIST End error list
ZSPI–TKN–ENDLIST End segment
The token ZCMK–TKN–SEGTYPE is defined in Section 4, “Common Definitions,” and
in the SPI Common Extension Manual and identifies the segment type. In the INFO
PROC response, if a segmented response is requested, the token ZCMK–TKN–
SEGTYPE has the value ZCMK–VAL–SEGTYPE–CHFILE. In this case, each segment
contains information for one character map in the character map translation file. In the
LISTOPENS response, if a segmented response is requested, the token ZCMK–TKN–
SEGTYPE has the value ZCMK–VAL–SEGTYPE–LOPNS. In this case, each segment
contains information for one opener as the SNAX/APC process. An error list inside a
segment list is a warning that refers to the subject of the list.
A segmented response to the INFO PROC or LISTOPENS commands is only returned
if the ZSPI-TKN-ALLOW token is present in the command buffer with a value of
ZSPI-VAL-ALLOW-SEGMENTS.
For more information on segmented responses, refer to the SPI Programming Manual
and the SPI Common Extensions Manual.