TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-147
#EMSGETV Built-In Function
result-var
is the name of the writable STRUCT into which #EMSGETV 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:
•
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 the token code or token
map c-token-id, starting at the position specified by 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
#EMSGETV returns a numeric status code indicating the outcome of the SSGET
procedure. The meaning of the status code:
Code Description
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