SPI Programming Manual (G06.24+, H06.03+, J06.03+)
The SPI Procedures
SPI Programming Manual—427506-006
3-16
Special Operations With SSGET and SSGETTKN
ZSPI-TKN-BUFLEN: Retrieve Current Buffer Length
Call SSGET or SSGETTKN with this token code to retrieve the current buffer length
from the corresponding header token. If you specify an
index parameter, it must have
a value of zero or one.
ZSPI-TKN-CHECKSUM: Retrieve Value of Checksum Flag
Call SSGET or SSGETTKN with this token code to retrieve the checksum flag from the
corresponding header token. If you specify an
index parameter, it must have a value
of zero or one.
ZSPI-TKN-COMMAND: Retrieve Command Number
Call SSGET or SSGETTKN with this token code to retrieve the command number from
the corresponding header token. If you specify an
index parameter, it must have a
value of zero or one. If the command does not contain a command number, or if the
subsystem could not obtain it, the error response from NonStop Kernel subsystems
includes the null command number (ZSPI-VAL-NULL-COMMAND). In a response
reporting a malformed command, the command number might not be reliable.
ZSPI-TKN-COUNT: Count the Occurrences of a Token
Use this token code to get the total number of occurrences of a specific token (starting
from a specified index):
This operation returns, in
count, INT .EXT:ref:1, the total number of occurrences of
token-id. If index is zero or not supplied, counting starts from the current-token
pointer. To count all occurrences in the current list, specify an
index of 1.
If
token-id is either omitted or equal to ZSPI-VAL-NULL-TOKENCODE and index is
either omitted or zero, then SSGET or SSGETTKN counts occurrences of the current
token beginning with the current occurrence.
ZSPI-TKN-DEFAULT-SSID: Retrieve the Current Default SSID
Use this token code to get the default subsystem ID value of the token at the current-
token pointer:
SSGET ( buffer
SSGETTKN , ZSPI-TKN-COUNT
, [ token-id ] ! i
, [ index ] ! i
, count ! o
, [ ssid ] ) ! i
SSGET ( buffer
SSGETTKN , ZSPI-TKN-DEFAULT-SSID
, ssid ) ! o