TACL Reference Manual

Built-In Functions and Variables

HP NonStop TACL Reference Manual—429513-018

9-146

#EMSGETV Built-In Function

Use #EMSGETV to obtain binary token values from an SPI buffer and put them into a

STRUCT. You can use #EMSGETV with any type of token (in fact, you must use

#EMSGETV with extensible structured tokens and tokens of type

ZSPI^TYP^STRUCT). #EMSGETV invokes the EMSGET procedure.

option

is any of these:

COUNT count

INDEX index

SSID ssid

These are the same as those described for #EMSGET, substituting token-id

for all references to token-code.

buffer-var

is the same as described for #EMSGET.

get-op

is one of these:

token-id

is either a token code or a token map. It directs #EMSGETV to return the token

value or values associated with token-id.

If token-id is a token that marks the beginning of a list, #EMSGETV selects

the list so that subsequent calls can retrieve tokens within the list. If token-

code is ZSPI^TKN^ENDLIST, #EMSGETV pops out of the list.

ZSPI^TKN^COUNT c-token-id

ZSPI^TKN^LEN l-token-id

ZSPI^TKN^NEXTCODE

ZSPI^TKN^NEXTTOKEN

ZSPI^TKN^OFFSET o-token-id

are the same as those defined for #EMSGET, except that #EMSGETV returns

results in result-var, rather than in the function result.

You must supply appropriate token code definitions. TACL supports the special

semantics for only those SPI special token codes shown; any other token

codes are assumed to adhere to standard semantics.

#EMSGETV [ / option [ , option ] ... / ] buffer-var get-op

result-var