Pathway/iTS Management Programming Manual

SPI Programming Considerations
NonStop Pathway/iTS Management Programming Manual—426749-002
3-4
Message Elements for the Pathway Subsystem
you were writing the COBOL management application mentioned previously and also
wanted to manage a TMF subsystem, you would need the following additional
definition file:
ZSPIDEF.ZTMFCOB
For information about the SPI, EMS, extended SPI definitions, operating system, and
file-system definitions, see the SPI Programming Manual, the EMS Manual, and the
Guardian Procedure Errors and Messages Manual, respectively. The NonStop
Pathway/iTS definitions are described in this manual.
Message Elements for the Pathway Subsystem
The following subsections provide subsystem-specific information about elements of
Pathway/iTS commands, responses, and event messages. For general information
about these elements, and for descriptions of elements whose meaning is not
subsystem-specific (such as the subsystem ID), see the SPI Programming Manual.
Commands
Programmatic commands for the Pathway subsystem are identified by command
numbers with symbolic names of the form ZPWY-CMD-name, where name identifies
the command. For example, the name used by management application programs for
the ALTER command is ZPWY-CMD-ALTER. These names represent the values that
can be assigned to the command number header token, ZSPI-TKN-COMMAND.
The Pathway subsystem has its own set of command numbers, which are 16-bit
integers represented in DDL by constants and in programs by TAL literals, COBOL
level-01 variables, C pragmas, or TACL text variables. The command number is one of
the tokens in the message header, which is a component of both command and
response buffers.
For Pathway/iTS objects, the Pathway subsystem supports the programmatic
commands listed in Table 3-1.
Note. Symbolic names are given in the DDL format, which is identical to the COBOL format.
To describe an object in TAL or TACL, replace hyphens with circumflex characters (^).
Table 3-1. Pathway/iTS Programmatic Commands (page 1 of 2)
Command Meaning
ZPWY-CMD-ABORT Stops a suspended or running TERM object
ZPWY-CMD-ADD Adds an object description to the PATHMON configuration
file
ZPWY-CMD-ALTER Changes an object’s configuration when the object is not
active
ZPWY-CMD-CONTROL Changes an object’s configuration while the object is
active