TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-377
#SSGETV Built-In Function
result-var
is the name of the writable STRUCT into which #SSGETV is to store the data
returned. The original contents of the STRUCT are lost.
If the status code in the function result is zero (no error), the result stored in
result-var is as follows:
•
If you specified token-id, the result is the value of the token.
•
If you specified ZSPI^TKN^COUNT c-token-id, the result is an INT giving
the number of occurrences of the token specified by c-token-id, starting at
index.
•
If you specified ZSPI^TKN^LEN l-token-id, the result is an INT giving the
length of the specified token.
•
If you specified ZSPI^TKN^NEXTCODE, the result is an INT2 giving the next
token code that is different from the current token code, an INT giving the
number of contiguous occurrences of that token code, and the subsystem ID.
•
If you specified ZSPI^TKN^NEXTTOKEN, the result is an INT2 giving the next
token code, whether different from or identical to the current token code,
followed by the subsystem ID.
•
If you specified ZSPI^TKN^OFFSET o-token-id, the result is an INT2 giving
the byte offset of the token specified by o-token-id.
Result
#SSGETV returns a numeric status code indicating the outcome of the SSGET
procedure. The meaning of the status code is as follows:
If no error occurred, and if get-op is token-id, the status code is followed by a
space and the number of token values returned.
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