TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-374
#SSGET Built-In Function
are returned in two parts-the byte length followed by the actual value-separated by
a space
•
If you specify ZSPI^TKN^COUNT c-token-id, the total number of occurrences
of the specified token, starting at the occurrence specified by index If you specify
ZSPI^TKN^LEN l-token-id, the length of the token specified by the token code
or token map l-token-id
•
If you specify ZSPI^TKN^NEXTCODE, the next token code that is different from
the current token code, followed by the subsystem ID
•
If you specify ZSPI^TKN^NEXTTOKEN, the next token code, regardless of
whether it is different from the current token code, followed by the subsystem ID
•
If you specify ZSPI^TKN^OFFSET o-token-id, the byte offset of the token
specified by token code or token map o-token-id
If the status code is not zero, its meaning is:
Considerations
•
Tokens extracted by #SSGET are not deleted or removed from the buffer.
•
When the current position is within a particular list, all #SSGET calls pertain only to
tokens within that list (except that header fields are always accessible). You can
exit from the list by calling #SSGET to get the ZSPI^TKN^ENDLIST token.
•
When token-code is ZSPI^TKN^ENDLIST, the index and count parameters have
no effect. However, if you supply them, index must be 0 or 1; count is always
returned as 1.
Code Condition
-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