SPI Common Extensions Manual

Introduction to SPI Extensions

SPI Common Extensions Manual—427508-001

1-6

Subsystem Support

To determine whether a subsystem uses the extended SPI interface, see the

management programming manual for that subsystem.

Procedures

Basic SPI provides standard procedures for working with SPI messages: SSINIT,

SSNULL, SSPUT, SSPUTTKN, SSGET, SSGETTKN, SSMOVE, and SSMOVETKN.

For information on these procedures, see the

SPI Programming Manual

The common extensions to SPI assume the use of these procedures.

Data Definitions

Basic SPI provides a set of data definitions commonly used by programs that process

SPI messages. These definitions are based on Data Definition Language (DDL) source

code contained in the file ZSPIDDL. The DDL compiler uses this file to generate

language-specific declaration files for C, COBOL85, TACL, and TAL named ZSPIC,

ZSPICOB, ZSPITACL, and ZSPITAL, respectively.

Extended SPI supplements the ZSPI definitions with additional commonly used

declarations whose names begin with ZCOM. These declarations are also distributed

in language-specific files named ZCOMC, ZCOMCOB, ZCOMTACL, and ZCOMTAL.

The standard DDL definition files provided by Compaq are usually found in

$release-volume.ZSPIDEF.*. The file names begin with the four-character

subsystem mnemonic; for example, ZSPIDDL, ZCOMDDL, and ZEMSDDL. Language-

specific files for languages such as TAL, COBOL85, TACL, and C are generated from

each subsystem DDL file and named ZSPITAL, ZSPICOB, ZSPITACL, and ZSPIC.

Commands

Basic SPI defines a single SPI command: GETVERSION (ZSPI-CMD-GETVERSION).

Extended SPI defines 42 additional commands and specifies the contents of each

command message and corresponding response. Extended SPI also defines some

command modifiers that let you apply commands to specific objects based on the

summary state they are reporting and their position in the subsystem object hierarchy.

Errors

Basic SPI defines two types of errors: errors returned by the SPI procedures and errors

returned in SPI messages to characterize message processing.

Extended SPI defines additional errors to describe common SPI problems.