TACL Reference Manual

Built-In Functions and Variables

HP NonStop TACL Reference Manual—429513-018

9-386

#SSPUT Built-In Function

Use #SSPUT to convert token values from external representation to binary form and

put them into an SPI buffer previously initialized by #SSINIT.

You cannot use #SSPUT to insert values of extensible structured tokens using a token

map or using a token code of type ZSPI^TDT^STRUCT. Use #SSPUTV instead.

option

is either of these:

COUNT count

is an integer in the range 1 through 65535 that specifies the token count; you

must supply that number of token values. If count is greater than 1, it states

that token-value is a space-separated list of count elements, each of which

is described by token-id. (Note that you must state a variable-length value in

two parts-the byte length, followed by the actual value-separated by a space.)

If you omit COUNT, you must supply exactly one value (the default).

If token-code denotes a special operation whose semantics do not allow a

token value, you must omit COUNT. For the special token code

ZSPI^TKN^DELETE, you must supply a count value; #SSPUT interprets it as

the index value of the token code to be deleted.

SSID ssid

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

or if SSID is zero (0.0.0), ssid 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; the variable level must be a writable STRUCT that has been initialized by

#SSINIT.

token-code

either identifies the token whose token value is being supplied or denotes a special

operation (described under “Header Tokens and Special Operations for #SSPUT

and #SSPUTV,” later in this subsection).

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

token-code [ token-value [ token-value ] ... ]