SPI Programming Manual (G06.24+, H06.03+, J06.03+)

The SPI Procedures

SPI Programming Manual—427506-006

3-6

SSNULL Procedure

The SSNULL procedure initializes an extensible structure with null values. Always use

this procedure before setting values within an extensible structured token. For more

information about null values, see Section 5, General SPI Programming Guidelines

General Syntax

token-map

INT .EXT:ref:*

is a token map to be used in initializing the fields of the structure.

struct

STRING .EXT:ref:*

is the structure to be initialized with null values.

constants

FIXED .ref:1

is a pointer to the set of constant values returned by the XSTACKTEST procedure.

If the constants are specified in the call, SSNULL does not need to call

XSTACKTEST, which it must do if the constants are not provided. This parameter

is used only by software that HP provides for the NonStop server.

Considerations

Always use SSNULL to initialize an extensible structured token, even if you put values

into all of the structure’s fields. Doing so ensures that your application continues to run

correctly if new fields are later added to the structure.

SSNULL ( token-map ! i

, struct ! o

[ , constants ] ) ! i