TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-387
#SSPUT Built-In Function
token-value
is the token value in external representation. Its data representation is determined
by the token-type field of token-code.
Result
#SSPUT returns a numeric status code indicating the outcome of the SSPUT
procedure, as follows:
Considerations
•
You can omit the token-value parameter if the token length specified by token-
code is zero; otherwise, the token-value parameter is required.
•
Specifying a count value greater than 1 is equivalent to calling #SSPUT count
times in succession without the COUNT option (but supplying a new token-value
before each call).
•
If count is greater than 1 and the token is of variable length, each token value must
be an even number of bytes in length to ensure word alignment.
•
The order in which tokens are added to the buffer is not significant, except in the
cases of:
°
#SSPUT calls that start and end lists (using tokens such as
ZSPI^TKN^DATALIST, ZSPI^TKN^ERRLIST, and ZSPI^TKN^ENDLIST).
°
A few subsystem-specific exceptions mentioned in the subsystem manuals
(the ZEMS^TKN^SUBJECT^MARK token in an event message, for example).
Code Condition
0 No error
-1 Invalid buffer format
-2 Invalid parameter value
-3 Missing parameter
-4 Invalid parameter address
-5 Buffer full
-6 Invalid checksum
-7 Internal error
-8 Token not found
-9 Invalid token code or map
-10 Invalid subsystem ID
-11 Operation not supported
-12 Insufficient stack space