TS/MP 2.5 Management Programming Manual

PWY (ZPWY) definition file
EMS (ZEMS) definition file
For example, a management application written in COBOL that sends commands to and retrieves
event messages issued by the Pathway subsystem would copy or load the definition files:
ZSPIDEF.ZSPICOB
ZSPIDEF.ZPWYCOB
ZSPIDEF.ZEMSCOB
If your application manages subsystems other than Pathway, it also needs the definition files
required by those subsystems. For instance, you might want your Pathway management application
to manage an associated TMF system as well. If you were writing the COBOL management
application mentioned previously and also wanted to manage a TMF subsystem, you must require
an 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 TS/MP definitions are described in this manual.
Message Elements for the Pathway Subsystem
The following subsections provide subsystem-specific information about elements of TS/MP
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.
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 dashes with circumflex characters (^).
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 TS/MP objects, the Pathway subsystem supports the programmatic commands listed in Table 5
(page 31).
Table 5 TS/MP Programmatic Commands
DescriptionCommand
Adds an object description to the PATHMON configuration
file
ZPWY-CMD-ADD
Changes an object configuration when it is not activeZPWY-CMD-ALTER
Changes an object configuration while it is activeZPWY-CMD-CONTROL
Removes an object description from the PATHMON
configuration file if the object is not active
ZPWY-CMD-DELETE
Message Elements for the Pathway Subsystem 31