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

SPI Programming in TACL
SPI Programming Manual—427506-006
8-10
#SSNULL
OBJECT object-type
gives the object type. If you do not supply this option, the object type defaults
to ZSPI^VAL^NULL^OBJECT^TYPE (zero).
SERVERVERSION server-version
is normally provided only by subsystems or by other programs that are acting
as a server. In those cases, it is a 16-bit unsigned integer value representing
the version of the subsystem or server program. SSINIT places this value in
the header token ZSPI^TKN^SERVER^VERSION for use in version
compatibility checking. If you do not supply this option, the server version
defaults to zero.
Expansion
#SSINIT expands to a numeric status code indicating the outcome of the operation.
The status code has one of these values:
0 No error
-2 Illegal parameter value
-3 Missing parameter
-4 Illegal parameter address
-5 Buffer full
-7 Internal error
-10 Invalid subsystem ID
-12 Insufficient stack space
For more information about nonzero status codes, see Appendix A, Errors.
Consideration
•
For the ssid parameter, if you are initializing a command buffer to send to a
NonStop Kernel subsystem, you can expand a name of the form
subsys^VAL^SSID. For example, this #SSINIT call initializes a buffer to send the
GETVERSION command to EMS:
#SSINIT buf [ZEMS^VAL^SSID] [ZSPI^VAL^GETVERSION]
#SSNULL
The #SSNULL built-in function initializes a structure with null values. Use this
procedure before setting values within a structure for an extensible structured token.
Note. Your macro or routine must always use #SSNULL before placing values in the fields of
a structure, even when all currently defined fields are set explicitly. This practice allows the
program to continue to work with future software releases.
#SSNULL token-map struct