Safeguard Management Programming Manual (G06.29+, H06.08+, J06.03+)

Safeguard Management Programming Manual—422086-028
6-1
6 Common Definitions
This section introduces the definitions that apply to the multiple commands, responses,
and event messages you can use in a management application that communicates
with the Safeguard subsystem:
•
SPI standard definitions
•
EMS standard definitions
•
Data communications standard definitions
•
Safeguard specific standard definitions
The SPI standard definitions and Safeguard definitions are the sources of definitions
for tokens used in the programmatic interface to the Safeguard subsystem. The EMS
standard definitions are the source of definitions for tokens used in programs that
request event messages. All items in the definition files are given symbolic names.
HP provides each set of standard definitions in the form of a file of DDL source
declarations. Each software component that supports a programmatic interface,
reports events through EMS, or defines SPI error lists has a DDL source file.
Information about a definition specific to a particular command, response, or event
message is given in the description for that command, response, or event message.
This section uses a notation that expresses definitions in DDL. Both fixed and
extensible structures are defined using DDL DEFINITION statements. For more
information about DDL for SPI, see the SPI Programming Manual.
SPI Standard Definitions
Definition names beginning with ZSPI- are SPI standard definitions. These definitions
are available to all subsystems that support SPI procedures and are located in the SPI
DDL file, ZSPIDEF.ZSPIDDL.
Table 6-1
lists the SPI standard definitions used in the management programming
interface to the Safeguard subsystem. SPI definitions applicable to the Safeguard
subsystem consist of:
•
Header tokens and other special tokens available to all applications using SPI
•
Simple tokens in Safeguard commands, responses, event messages, and error
lists
•
Token types and fixed structures
•
Token values
Table 6-1
does not list SPI error numbers or definitions used only in error lists
associated with those error numbers, nor does it list all SPI token values that can be
used in an application. For information about these definitions, see the SPI
Programming Manual.