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

TS/MP Management Programming
NonStop TS/MP Management Programming Manual—540082-001
2-4
Control and Inquiry
•
A program that starts SERVER objects automatically at a specified time at the
beginning of the day. (This program would communicate with the Pathway
subsystem only.)
•
A program that performs automatic recovery after an object failure. (This program
would communicate with EMS and Pathway subsystem.)
These paragraphs give 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 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 from one to five additional alphanumeric
characters; a maximum of six characters is allowed. The first alphanumeric character
must be a letter. If the PATHMON name is to be used across a network, a maximum of
five characters is allowed—a dollar sign followed by no more than four alphanumeric
characters (for example, $abc2).
#ZSPI identifies the application as using the SPI interface and directs the PATHMON
process to process requests and replies using the SPI procedures.