TS/MP 2.5 Management Programming Manual

2 TS/MP Management Programming
This section summarizes the SPI interface to the Pathway subsystem and the commands and object
types defined for the subsystem. The section also provides information about starting and opening
the PATHMON process programmatically.
Comparison of PATHCOM and SPI Commands
Like PATHCOM, the SPI Management Programming interface to the Pathway subsystem uses
commands that operate on objects. A combination of a command and an object type determines
what action the PATHMON process can take, as well as what additional information you must
specify.
The object types used in the Management Programming interface might not be the same as the
object types used in PATHCOM. In some cases, the object types correspond exactly, but in other
cases a single PATHCOM object type is represented in the Management Programming interface
by a small group of object types, each of which handles a portion of the PATHCOM object
description. For example, the PATHCOM SERVER object is represented in the SPI Management
Programming interface by the objects SC, SCASSIGN, SCDEFINE, SCPARAM, SCPROCESS, and
SCSTARTUP.
The object name and additional command parameters are represented in the Management
Programming interface by tokens in the message buffer.
Not all PATHCOM commands are needed in the Management Programming interface. Applications
must independently implement the basic commands, which are CMDVOL, EXIT, FC, HELP, OBEY,
OBEYVOL, and OPEN. Other commands, such as SET, SET LIKE, RESET, ALTER RESET, and
SHOW, must also be implemented independently.
Some PATHCOM functions require more than one SPI command for implementation. For example,
to add a server class (the equivalent of the PATHCOM ADD SERVER command), you must send all
these SPI commands:
ADD SCPARAM
ADD SCPROCESS
ADD SCSTARTUP
ADD SC
ADD SCASSIGN
ADD SCDEFINE
Table 4 (page 23) compares the PATHCOM commands with the equivalent SPI command for the
objects supported by TS/MP. All SPI commands begin with the prefix ZPWY-CMD-, and all SPI
object types begin with the prefix ZPWY-OBJ-.
Table 4 PATHCOM and SPI Commands for TS/MP
Equivalent SPI Commands (ZPWY-CMD- ) and Object Types
(ZPWY-OBJ- )PATHCOM Commands and Object Types
Commands for LINKMON Processes
STATUS LMSTATUS LINKMON
Commands to Control Pathway subsystem
CONTROL PMALTER PATHMON
CONTROL PMCONTROL PATHMON
INFO PATHWAYINFO PATHMON
INFO PATHWAYINFO PATHWAY
CONTROL PMLOG1
CONTROL PMLOG2
Comparison of PATHCOM and SPI Commands 23