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

SPI Concepts and Protocol

SPI Programming Manual—427506-006

2-27

Commands

A command directs an SPI server to perform an action on one or more objects. The

action can affect the objects in some way or might just retrieve information about the

objects.

The command in an SPI request is identified by a command number, which the

requester specifies in the SSINIT procedure call that initializes the message. SSINIT

stores the command number in the header token ZSPI-TKN-COMMAND. Command

numbers have names of the form

subsys-CMD-command.

Basic SPI defines a single command number, ZSPI-CMD-GETVERSION. Additional

common commands are defined by the SPI extensions described in the

SPI Common

Extensions Manual

. Other commands are defined by individual subsystems and

described in the subsystem management programming manuals.

GETVERSION Command

The GETVERSION command returns basic server version information. SPI recognizes

two forms of the command: a basic GETVERSION command and an extended

command.

The Basic GETVERSION Command

A basic GETVERSION command contains the null object type (specifies ZSPI-VAL-

NULL-OBJECT-TYPE for the object type in the SSINIT call). In its response, a server

returns its version in the ZSPI-TKN-SERVER-VERSION header token and a server

identification string in the response token ZSPI-TKN-SERVER-BANNER. (See the

description of ZSPI-TKN-SERVER-BANNER for the format of the server ID string.)

The response can also contain any of:

•

Additional SERVER-BANNER tokens declaring the versions of various subsystem

components. (The first instance of the token always declares the version of the

server specified by the subsystem ID in the command.)

•

One or more ZSPI-TKN-IPM-ID tokens to identify interim product modifications that

have modified the interface to the subsystem.

A single call to SSINIT, specifying ZSPI-CMD-GETVERSION for the command and

ZSPI-VAL-NULL-OBJECT-TYPE for the object type parameter, is sufficient to prepare

a basic GETVERSION command—no additional tokens are required.

All SPI servers support this basic GETVERSION command.