OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide

OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide—424822-001
xi
About This Manual
This manual describes the Compaq OSI/MHS Gateway Programmatic Interface (GPI),
which is the Compaq implementation of the X.400 Gateway Application Program
Interface (X.400 API). The GPI provides a programmatic interface to the Compaq Open
Systems Interconnection/Message Handling System (OSI/MHS) at the message transfer
agent (MTA) boundary. This manual provides a detailed overview of GPI components
and operation. It also describes how to plan, write, and debug a program which uses the
GPI.
Who Should Read This Manual?
Application programmers who are writing gateway interface programs should use this
manual to learn about the GPI procedural interface. All readers should be experienced
in using the Compaq Transaction Application Language (TAL) or the C programming
language and know how to develop application programs to be run on a Compaq
NonStop system. Readers should also have some understanding of X.400 networks and
the Compaq OSI/MHS subsystem.
What’s in This Manual?
Here is a brief description of each section in the manual:
•
Section 1, Introduction, is a quick briefing on the GPI. It relates the GPI to X.400
and OSI/MHS. It also provides a general description of GPI components and how
they work.
•
Section 2, The GPI Library, is a general description of the GPI procedural interface.
The interface consists of a set of 18 library procedures and four declaration files.
The library procedures are described within the context of overall program
objectives.
•
Section 3, GPI Object Management, describes how to use and manage objects:
structures that represent X.400 information in the gateway. A basic knowledge of
objects is key to using GPI procedures.
•
Section 4, Planning Your Program, describes GPI software requirements and how to
handle multiple GPI sessions, fault recovery, gateway security, and CCITT protocol
changes.
•
Section 5, Writing Your Program, focuses on GPI program development. It
describes each GPI procedure in detail and provides program examples.
•
Section 6, Recovering From Errors, describes how to check for and diagnose GPI
failures. It provides examples of code structures for error checking and diagnostics.
•
Appendix A, TAL Program Example, is a comprehensive TAL language program
that shows how to call each GPI procedure.
•
Appendix B, C Program Example, is the same example as Appendix A, coded in the
C language.