OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide

OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide—424822-001
3-1
3
GPI Object Management
XAPIA objects are structures that represent collections of information. Within the
gateway, objects represent X.400 messages or their parts. Using calls to the GPI service,
the client program manages objects in GPI library memory space.
This section provides a basic explanation of objects and how to use them. The topics
covered are:
•
GPI object management features
•
How objects work
•
Objects and classes
•
Attributes
GPI Object Management Features
The GPI has object management features that define objects and allow the client to
manage them. The features are an implementation of XAPIA specifications. The
features include:
•
An information architecture based on object-oriented structures (objects)
•
GPI library object management procedures
The information architecture defines how information is represented in the gateway. As
mentioned previously, the architecture is based on structures called objects. Objects are
composed of fundamental units called attributes. Objects are grouped into object
classes.
GPI object management procedures allow the client to operate on objects and their parts.
As mentioned in Section 2, The GPI Library
, objects can be composed, decomposed,
inspected, and copied. The object management procedures are summarized again in
Table 3-1.
Table 3-1. GPI Object Management Procedures (page 1 of 2)
Procedure Name Purpose
GPI_OM_COPY_ Creates a copy of an object
GPI_OM_CREATE_ Creates a new object of a specified class
GPI_OM_DELETE_ Deletes an object and invalidates its identifier
GPI_OM_EXAMINE_ Identifies the type of an object’s attributes
GPI_OM_FETCH_ Allows you to check whether specific attribute types are present in
an object
GPI_OM_INSERT_ Adds attribute values to an object
GPI_OM_LIST_ Identifies values of multivalued attributes of an object