TS/MP Management Programming Manual (G06.24+, H06.03+)

NonStop TS/MP Management Programming Manual—540082-001

2-1

TS/MP Management Programming

This section summarizes the SPI interface to the Pathway subsystem and the

commands and object types defined for the subsystem. This 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 should take, as well as

what additional information you must specify.

The object types used with the management programming interface are not always the

same as the object types used in PATHCOM. In some cases, they 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 SC ADD SCPARAM

ADD SCASSIGN ADD SCPROCESS

ADD SCDEFINE ADD SCSTARTUP

Table 2-1 on page 2-2 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-.