OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual

Information Architecture and Data Structures
OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual—522223-001
2-2
Class Hierarchy
objects of that class. Classes available through the GPI are referred to by Data
Definition Language (DDL) constant names that begin with the following prefixes:
For example, MH messages are defined by the class MH-C-MESSAGE, and IM receipt
notifications are defined by the class IM-C-RECEIPT-NOTIFICATION. A package is
a set of classes that are grouped together because they are functionally related. Detailed
descriptions of classes are given in Section 3, Object Classes and Attribute Types.
Class Hierarchy
An object can be an attribute of another object. For example, the attribute value
identifying the originator of a message is an object of class MH-C-OR-NAME. The
message is the superobject and the originator object is the message’s subobject.
Classes of objects are related to each other in a tree hierarchy consisting of a root object
and objects that are its attributes (subobjects). The subobjects can also have attributes
that are objects. You can transfer to and from the GPI service only root objects, which
are of the following classes:
•
MH-C-MESSAGE
•
MH-C-PROBE
•
MH-C-REPORT
•
MH-C-P1-ENCODED-PDU
All other classes define objects that are subobjects of these classes. Interpersonal
messages (IPMs) and interpersonal notifications (IPNs) are subobjects of the
MH-C-MESSAGE and MH-C-REPORT classes, respectively.
The class hierarchies for the message handling and interpersonal messaging packages
are defined in the various X.400 API specifications and cannot be modified. For
diagrams of the class hierarchies, see Appendix D, Class Hierarchies
.
Attribute Descriptors
An attribute descriptor is the form you use to exchange a value with the GPI. Each
descriptor contains a type, syntax, and value. The type and syntax are integers. The
data type of the value is determined by the syntax.
Figure 2-1 represents the same descriptor in two ways, as DDL names and as integers:
•
The type is represented by the DDL constant MH-T-B4-WIDTH, which is a 16-bit
integer value of 215.
OM-C- Classes of the object management (OM) package
MH-C- Classes of the message handling (MH) package
IM-C- Classes of the interpersonal messaging (IM) package
EDI-C- Classes of the electronic data interchange (EDI) package