SPI Programming Manual (H06.24+, J06.13+)

SPI Programming in TACL
SPI Programming Manual—427506-007
8-16
#SSPUTV
byte values for #SSPUT or as an 8-byte STRUCT for #SSPUTV. For this operation to
be valid, the contents of the buffer prior to the previously saved position must not have
been modified by ZSPI^TKN^DELETE, ZSPI^TKN^DATAFLUSH, or #SSMOVE
operations. Otherwise, this operation can corrupt the buffer and cause later operations
to give indeterminate results. If
token-value is zero or not supplied, this operation
sets the current position to the beginning of the buffer.
ZSPI^TKN^RESET^BUFFER: Reset the Buffer
Use this token code before extracting tokens from an SPI buffer received (in either a
command or a response) from another process. This operation performs three actions:

It resets the maximum buffer length to the value given in token-value.

It clears the last-error information to null values (equivalent to the action of
ZSPI^TKN^CLEARERR).

It resets the current position to the beginning of the buffer (equivalent to the action
of ZSPI^TKN^INITIAL^POSITION with ZSPI^VAL^INITIAL^BUFFER).
TACL checks to be sure the value given in
token-value does not exceed the size of
the structure passed as the buffer. If
token-value exceeds the buffer size, the SPI
error -5 (buffer full) is returned. SPI still resets the maximum buffer length in the SPI
message header, causing subsequent SPI calls for that buffer to fail with error -1
(invalid buffer format).
ZSPI^TKN^SERVER^VERSION: Set Server Version Header
Token
Use this token code to set the header token containing the release version of the
server. For
token-value, supply an unsigned integer representing the appropriate
release version. For example, if the server is a NonStop Kernel subsystem of version
G06,
token-value should be the unsigned integer with the ASCII character G in the
left byte and “06” in the right byte, or 18182.
#SSPUTV
Use #SSPUTV to take binary token values from a variable and insert them into an SPI
buffer. You can use #SSPUTV with any type of token. With tokens of type
ZSPI^TYP^STRUCT and extensible structured tokens, you must use #SSPUTV.
option
is either of:
#SSPUTV [ / option [ , option ]... / ]
buffer-var token-id source-var