OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide

GPI Object Management

OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide—424822-001

3-8

Object Identifiers

When the client creates or copies an object, the GPI assigns a unique object identifier to

that object. You use the object identifier to refer to the object in calls to procedures that

operate on it. For example, when you transfer an object to the output queue, you specify

its object identifier.

Following are some important considerations about object identifiers:

•

The identifier references all information represented by the object.

•

If an object has an attribute that is a subobject, the attribute’s value is the identifier

of the subobject (Figure 3-7). Attribute value is described in Attribute Value on

page 3-12.

Object Classes

As mentioned previously, object class is determined by the types of attributes associated

with objects. The GPI Reference Manual contains detailed reference on each object

class; it also lists and describes the attributes associated with each class.

XAPIA specifications group object classes into packages. The GPI currently supports

classes of four packages:

•

Message handling (MH) package

•

Interpersonal messaging (IM) package

•

Object management (OM) package

•

Electronic data interchange (EDI) package

Table 3-2 lists the name of each class the GPI supports.

Figure 3-7. Object Identifiers

307CDT .CDD

OBJECT X (OBJECT_X_ID)

Attribute B

Object_Y_ID

Attribute A

Value of A

Attribute C

Value of C

OBJECT Y (OBJECT_Y_ID)

Value of A

Attribute A