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

SPI Programming in TACL
SPI Programming Manual—427506-006
8-24
#SSGETV
If the default subsystem ID comes from a list token, the version field of the returned
subsystem ID value is set to ZSPI^VAL^NULL^VERSION. Therefore, when comparing
subsystem ID values for equality, your program should omit the version field from the
test.
#SSGETV
Use #SSGETV to obtain binary token values from an SPI buffer and put them into a
STRUCT. You can use #SSGETV with any type of token. With tokens of type
ZSPI^TYP^STRUCT and extensible structured tokens, you must use #SSGETV.
option
is any of:
COUNT count
INDEX index
SSID ssid
These options are the same as those described under #SSGET, substituting
token-id for all references to token-code.
buffer-var
is the same as described for #SSGET.
get-op
is one of these:
token-id
is either a token code or a token map. It directs #SSGETV to return the token
value or values associated with
token-id.
If
token-code is a token that marks the beginning of a list
(ZSPI^TKN^DATALIST, ZSPI^TKN^ERRLIST, ZSPI^TKN^SEGLIST, or
ZSPI^TKN^LIST), #SSGET selects the list so that subsequent calls can
retrieve tokens within the list. If
token-code is ZSPI^TKN^ENDLIST,
#SSGET deselects (pops out of) the list.
ZSPI^TKN^COUNT c-token-id
ZSPI^TKN^LEN l-token-id
ZSPI^TKN^NEXTCODE
ZSPI^TKN^NEXTTOKEN
ZSPI^TKN^OFFSET o-token-id
are the same as defined for #SSGET, except that #SSGETV returns the results
in
result-var rather than in the expansion.
#SSGETV [ / option [ , option ]... / ]
buffer-var get-op result-var