SPI Programming Manual (G06.24+, H06.03+, J06.03+)

The SPI Procedures
SPI Programming Manual—427506-006
3-20
Special Operations With SSGET and SSGETTKN
ZSPI-TKN-NEXTTOKEN: Get the Next Token Code in the
Buffer
Use this token code to get the token code of the next token in the buffer:
This operation differs from ZSPI-TKN-NEXTCODE in that it always returns the token
code of the next token, whether or not it is the same as that of the current token, and
whether or not the token is within a list. The operation returns multiple occurrences of
the same token code in the same order as they were added to the buffer with SSPUT
or SSPUTTKN.
For this operation,
ssid is an output parameter only; you do not supply any
information in this token, but merely provide a variable in which SSGET returns the
subsystem ID that qualifies the token code. If you do not supply a variable for
ssid,
and the subsystem ID associated with the next token code is not the same as the
default subsystem ID, a “missing parameter” error is returned. Therefore, always
supply a variable for SSID when calling SSGET with ZSPI-TKN-NEXTTOKEN unless,
for some special reason, you are certain that all tokens the program could encounter
are qualified by the default subsystem ID. The
ssid returned always has a version
field of zero (null).
The
index and count parameters have no effect on this operation. If supplied, index
must be equal to zero, and
count is always returned as 1.
See the NOTE at the end of ZSPI-TKN-NEXTCODE: Get the Next Different Token
Code in the Buffer on page 3-19.
ZSPI-TKN-OBJECT-TYPE: Retrieve Object Type
Call SSGET or SSGETTKN with this token code to retrieve the object type from the
corresponding header token. If you specify an
index parameter, it must have a value
of 0 or 1. In a response reporting a malformed command, the object-type number might
not be reliable.
SSGET ( buffer
SSGETTKN , ZSPI-TKN-NEXTTOKEN
, [ next-token-code ] ! o
,
,
, [ ssid ] ) ! o