OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual

OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual—522223-001
4-1
4
Procedure Calls
This section contains detailed reference information about the GPI procedures provided
with the OSI/MHS GPI subsystem. The information includes:
•
A description of each procedure
•
The syntax of each procedure
•
Parameter descriptions for each procedure
•
Considerations (added information about the procedure)
Before using this section, you should be familiar with the material in Section 2,
Information Architecture and Data Structures, and Section 3, Object Classes and
Attribute Types. For many procedure calls, you will also need to refer to the DDL
structure and value definitions in Appendix A, DDL Definitions
.
Files Provided by Compaq
The external declarations for the current version of the GPI procedures are provided in
the following files:
•
GPIEXT (TAL declarations)
For applications coded in TAL, you must use the ?SOURCE directive to include the
content of the GPIEXT declarations at the beginning of the external procedures
section of your program.
•
GPIEXTH (C declarations)
For applications coded in C, you must use the #include directive to include the
GPIEXTH declarations in your program before making any calls to the procedures.
For more information about the location of these files, which reside in a user library, see
the OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide.
The distribution subvolume for the Compaq OSI/MHS GPI product supplies two files
containing data declarations:
•
GPIDEFS contains TAL declarations for data structures used in parameters to the
procedure calls; you can use the ?SOURCE directive to include these declarations in
your TAL application programs.
•
GPIDEFSH contains the corresponding C declarations; you can use the #include
directive to include them in C programs.
Procedure Names and Categories
The names of all GPI procedures start with the prefix GPI_.