SPI Programming Considerations
NonStop Pathway/iTS Management Programming Manual—426749-002
3-18
Data Lists and Error Lists
For example, the command-modifier token ZPWY-DDL-PAR-CONTROL-TCP has the
following DDL definition:
Within ZPWY-DDL-PAR-CONTROL-TCP, the ZBACKUPCPU field has the type
ZPWY-DDL-CPU. ZPWY-DDL-CPU is defined earlier in the Pathway DDL definitions
file (ZPWYDDL) as follows:
To further expand the definition, look up ZSPI-DDL-INT in the SPI definitions file
(ZSPIDDL). The definition for ZSPI-DDL-INT is as follows:
Consequently, ZBACKUPCPU is a 16-bit integer.
ZDUMPFILE has the SPI type ZSPI-DDL-FNAME32. The definition for
ZSPI-DDL-FNAME32 in the ZSPIDDL file is as follows:
Previously in the ZSPIDDL file, ZSPI-DDL-CHAR8 is defined as eight ASCII
characters. ZSPI-DDL-FNAME is defined as a Guardian internal format file name,
including disk name, process name, and device name.
Throughout this manual, the type of a field is indicated wherever the field is described.
Definitions for Pathway subsystem private token and field types are in Section 5,
ZPWY-DDL- Definitions, and Section 6, ZPWY-MAP- Definitions. The type names
defined by SPI (using the prefix ZSPI- ) are fully described in the SPI Programming
Manual.
Data Lists and Error Lists
Responses from the Pathway subsystem can contain data lists and error lists, as
described in the SPI Programming Manual.
The Pathway subsystem does not support arrays or multiple instances of tokens. The
PATHMON process never returns more than one response in a message; however,
the single response can be enclosed in a data list for consistency with other
def ZPWY-DDL-PAR-CONTROL-TCP.
02 ZBACKUPCPU token-type ZPWY-DDL-CPU.
02 ZDUMPINFO.
03 ZDUMP token-type ZPWY-DDL-ON-OFF.
03 ZDUMPFILE token-type ZSPI-DDL-FNAME32.
02 ZSTATS token-type ZPWY-DDL-ON-OFF.
end.
def ZPWY-DDL-CPU token-type ZSPI-DDL-INT.
def ZSPI-DDL-INT token-type BINARY 16.
def ZSPI-DDL-FNAME32.
02 Z-SYSNAME token-type ZSPI-DDL-CHAR8.
02 Z-LOCALNAME token-type ZSPI-DDL-FNAME.
end.