TS/MP 2.5 Management Programming Manual

Table 4 PATHCOM and SPI Commands for TS/MP (continued)

Equivalent SPI Commands (ZPWY-CMD- ) and Object Types

(ZPWY-OBJ- )PATHCOM Commands and Object Types

STATUS SC + STATUS SCPROCESS + STATUS TCPLINK

STATUS SERVER, PROCESSES

(STATUS TCPLINK is a Pathway/iTS command

STOP SCSTOP SERVER

THAW SCTHAW SERVER

Pathway Management Programming Interface

The Pathway Management Programming interface is a token-oriented interface based on the SPI

message format, procedures, and definition files. The interface consists of a set of programmatic

commands that allow a management application to communicate directly with the PATHMON

process.

Some sample management applications that might communicate with TS/MP are:

• A program that saves event messages for the Pathway subsystem objects and issues STATUS

and INFO commands to provide more information on why the event is being reported. (This

program communicates with EMS and Pathway subsystem.)

• A program that starts SERVER objects automatically at a specified time at the beginning of

the day. (This program communicates with the Pathway subsystem only.)

• A program that performs automatic recovery after an object failure. (This program communicates

with EMS and Pathway subsystem.)

The following section provides an overview of the tasks involved in setting up and managing a

Pathway subsystem. For more information on the strategy for performing specific system management

tasks, see the TS/MP 2.5 System Management Manual.

Control and Inquiry

To communicate with the PATHMON process through the Pathway Management Programming

interface, a management application must follow these steps:

1. Start a PATHMON process if one is not already running.

2. Open the PATHMON process.

3. Build a message to send to PATHMON.

4. Send the message to PATHMON.

5. Receive a response from PATHMON.

6. Decode the response.

7. Handle errors.

8. Take any appropriate actions.

9. Close PATHMON.

Starting and Opening PATHMON

The PATHMON process is usually started by an operator. To start the PATHMON process

programmatically, use the Guardian NEWPROCESS procedure as described in the Guardian

Procedure Calls Reference Manual.

To open a PATHMON process programmatically, use the file name #ZSPI as:

$PATHMON-process-name.#ZSPI

$PATHMON-process-name is the name of the PATHMON process. The name must begin with

a dollar sign ($) and include alphanumeric characters; a maximum of six characters is allowed.

The first character must be a letter (for example, $abcd2). If the PATHMON name is to be used

Pathway Management Programming Interface 25