TACL Reference Manual

Built-In Functions and Variables

HP NonStop TACL Reference Manual—429513-018

9-380

#SSINIT Built-In Function

Use #SSINIT to initialize a STRUCT as an SPI message buffer, preparing it for use

with the other #SSxxx built-in functions. #SSINIT gives the buffer an appropriate

header and, optionally, adds parameter information.

Use #SSINIT only to initialize a buffer for a command or a response; do not use it to

initialize an event-message buffer.

TYPE 0

declares the header type of the SPI message buffer being initialized. Type 0, a

command or response header, is the default. Type 0 is the only type supported by

TACL at this time.

buffer-var

is the name of a writable STRUCT to be used as an SPI buffer. #SSINIT

automatically passes to the SSINIT procedure the data length of the STRUCT. Any

current contents of the STRUCT are lost.

ssid

is the subsystem ID of the subsystem. For requester functions, this subsystem ID

identifies the target subsystem; the version field must identify the version of the

subsystem definitions that your requester function is using. For server functions

(subsystems), this subsystem ID must identify your server, including its version.

command

is the command number.

type-0-option

can be any of these:

CHECKSUM num

is the checksum flag. If num is zero, checksum protection of the data portion of

the buffer is disabled; if it is a nonzero value, checksum protection of the data

portion is enabled. If you omit this option, it defaults to zero.

MAXRESPONSES num

is the maximum number of response records to be returned by the subsystem

in each reply message. A value of zero specifies one response record per

reply, not enclosed in a list. Any value greater than zero specifies up to that

many response records, each enclosed in a list. A value of -1 specifies as

#SSINIT [ / TYPE 0 / ] buffer-var ssid command

[ / type-0-option [ , type-0-option ] ... / ]