TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-144
#EMSGET Built-In Function
The meaning of the status code:
If the status code is 0 (no error), it is followed by a space and a space-separated list of
the relevant EMSGET results in the TACL external representation:
•
If you specified token-code, #EMSGET returns the number of token values
returned, followed by a space-separated list of those values in external form;
variable-length token values are returned in two parts-the byte length, followed by
the actual value-separated by a space.
•
If you specified ZSPI^TKN^COUNT c-token-id, #EMSGET returns the number
of occurrences of the specified token, starting at the occurrence specified by index.
•
If you specified ZSPI^TKN^LEN l-token-id, #EMSGET returns the length of the
token specified by the token code or token map l-token-id.
•
If you specified ZSPI^TKN^NEXTCODE, #EMSGET returns he next token code
that is different from the current token code, followed by the subsystem ID.
•
If you specified ZSPI^TKN^NEXTTOKEN, #EMSGET returns the next token code,
regardless of whether it is different from the current token code, followed by the
subsystem ID.
•
If you specified ZSPI^TKN^OFFSET o-token-id, #EMSGET returns the byte
offset of the token specified by o-token-id.
Considerations
•
Tokens extracted by #EMSGET are not deleted or removed from the buffer.
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