TACL Reference Manual

Built-In Functions and Variables

HP NonStop TACL Reference Manual—429513-018

9-391

#SSPUTV Built-In Function

Use #SSPUTV to move binary token values from a variable level into an SPI message

buffer. You can use #SSPUTV with any type of token, but you must use #SSPUTV with

tokens of type ZSPI^TYP^STRUCT and extensible structured tokens).

option

is either of these:

COUNT count

is the token count, an integer in the range 1 through 65535. If greater than 1,

count specifies that source-var contains an array of count elements, each

of which is described by token-id. If you omit this option, it defaults to 1.

If token-id is one of the special SPI token codes whose semantics do not

allow a token value, you must omit the COUNT option. For the special token

code ZSPI^TKN^DELETE, you must supply COUNT; in this case, #SSPUTV

interprets count as the index value of the token code to be deleted.

SSID ssid

specifies a subsystem ID that qualifies the token code. If you omit this option,

or if SSID is zero (0.0.0), it defaults to the subsystem ID of the current list or, if

the current position is not in a list, to the subsystem ID specified in the SPI

message header (ZSPI^TKN^SSID).

buffer-var

is the name of the SPI message-buffer variable level into which tokens are to be

placed.

token-id

is a token code or a token map. It either identifies the token being supplied or

denotes a special operation (described in the previous section under “Header

Tokens and Special Operations for #SSPUT and #SSPUTV” in the description of

the #SSPUT built-in function).

source-var

is the name of the variable level, of type STRUCT, from which #SSPUTV is to

obtain the binary token values. The contents of the STRUCT are not altered.

#SSPUTV [ / option [ , option ]... / ] buffer-var

token-id source-var