OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual

OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual—522223-001
A-1
A
DDL Definitions
This appendix contains Data Definition Language (DDL) definitions of the data
structures used in parameters to the GPI procedures.
The information in this appendix is in DDL format. As part of the OSI/MHS GPI
product, you receive the DDL in two forms:
•
The equivalent of TAL code (in the file GPIDEFS) is provided for you to include in
your TAL program by using the ?SOURCE directive.
•
The equivalent of C code (in the file GPIDEFSH) is provided for you to include in
your C program by using the #include directive.
This appendix describes two major types of DDL definitions:
•
Basic data types are building blocks on which the parameter structures are based.
•
Named values identify specific values or sets of values (constants) that can be
assigned to parameters or parameter fields.
In the headings in this section, the abbreviation xxx is used to indicate the remainder of
a DDL name that follows a prefix.
DDL definitions used to return status and error information from the GPI procedures are
described in Appendix B, Return Codes.
Basic Data Types
Some DDL data types are built upon other data types. Intermediate data types are used
in the definitions of other data types. The precise definitions of intermediate data types
in C are system-defined. First-level (primary) data types are the lowest-level building
blocks. Second-level (secondary) data types are made from one or more first-level data
types. Third-level (tertiary) data types are made from one or more second-level data
types.
Intermediate Data Types
The GPI defines intermediate data types for binary numbers.
OM-SINT
This data type defines a signed 16-bit integer.
Note. When the DDL compiler translates these definitions into TAL and C, the compiler
changes hyphens ( - ) in the names to underscores ( _ ). You should use underscores in DDL
names included in your programs. Because the C language distinguishes uppercase and
lowercase letters, you must use the DDL names exactly as they are declared in the
GPIDEFSH file or create your own declarations file.
DEFINITION OM-SINT TYPE BINARY 16.