OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide

OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide—424822-001
4-1
4
Planning Your Program
There are a number of things to consider before writing a GPI client program. For
instance, you need to consider how to handle gateway fault recovery, security, and
protocol changes. You also need to decide if you want to implement multiple GPI
sessions, and if so, how to do so. Of course, it’s also necessary to verify that the
software required for GPI operation is installed and configured.
The topics covered in this section are:
•
Verifying GPI requirements
•
Planning for multiple GPI sessions
•
Planning for gateway fault recovery
•
Planning for gateway security
•
Using extensions and criticality
Verifying GPI Requirements
The GPI runs on a Compaq NonStop II system or later system. In addition to GPI
components, the following software must be installed and configured:
•
Compaq NonStop operating system (version C30 or later)
•
OSI/MHS subsystem
•
Queue manager
The GPI uses the queue manager for control of GPI service input and output queues. If
desired, Pathway can be used to configure and manage the queue manager. If Pathway
is used, a stopped queue manager can be restarted automatically by the Pathway
Pathmon process.
In addition to the software requirements listed above, a Compaq C compiler (version
C30 or later) is required to develop GPI applications in the C language.
Note that the GPI must be installed on the same system as the software listed above.
The GPI does not operate through an Expand network.
A GPI gateway is configured and managed by the MHS manager of the OSI/MHS
subsystem to which the gateway connects. You use Subsystem Control Facility (SCF)
commands to communicate with the MHS manager. Following is a summary of key
OSI/MHS configuration steps that relate to the GPI:
•
Using the SCF ADD command, you configure a GATEWAY object.
•
Using the ADD command, you configure gateway interface (GI) CLASS and
GROUP objects (to set up GIPs).
•
Using the ADD command, you configure an APPL object for your gateway
application (provides address for messages, probes, reports sent to the application).