TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-392
#SSPUTV Built-In Function
Result
#SSPUTV returns a numeric status code indicating the outcome of the SSPUT
procedure, as follows:
Considerations
•
If the token length specified by token-id is zero, you must supply a variable level for
source-var, but its contents do not matter.
•
Specifying a count parameter greater than 1 for #SSPUTV is equivalent to calling
#SSPUTV count times without the COUNT option (but supplying a new token-
value before each call).
•
The order in which tokens are added to the buffer is not significant except in the
cases of:
°
#SSPUTV calls with token codes for tokens that start and end lists
(ZSPI^TKN^DATALIST, ZSPI^TKN^ERRLIST, ZSPI^TKN^LIST, and
ZSPI^TKN^ENDLIST).
°
A few subsystem-specific exceptions mentioned in the subsystem manuals (for
example, the ZEMS^TKN^SUBJECT^MARK token in an event message).
•
If the data in source-var is longer than the data area provided by #SSPUTV, the
excess bytes are ignored without any notification. If the data in source-var is
shorter than the data area provided, #SSPUTV sets the remainder of the token
value to unspecified values.
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