OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide

GPI Object Management

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

3-13

Attribute Descriptor Lists

Each attribute value requires a separate description. For a multivalued attribute, or

several single-valued attributes, several descriptors are required. A collection of

descriptors is called a descriptor list (Figure 3-10). Here, descriptors 0 and 1 are for

single-valued attributes; descriptors 2, 3, and 4 correspond to a multivalued attribute.

Attribute Position and Value Position

Some GPI procedures have as parameters attribute-position and value-

position. The attribute position indicates the relative position of an attribute within

an object. The value position indicates the relative position of a value within a

multivalued attribute. Both the attribute position and the value position start at zero.

For example, in Figure 3-11, object X has 18 first-level attributes. A single-valued

attribute of type OM-T-CLASS occupies attribute position 0. An attribute which

represents an object, attribute type A, occupies position 1. An attribute of type C, a

multivalued attribute, occupies position 2. Two single-valued attributes occupy

positions 3 and 18, attribute type H and attribute type W, respectively. Finally,

attributes at positions 4 through 17 are not shown.

As shown, attribute type C has four values. The values occupy four value positions

within the object, beginning at position 0.

Figure 3-10. Descriptor List

310CDT .CDD

MH-T-ADMD-NAME

MH-T-COUNTRY-NAME

OM-S-PRINTABLE-STRING

11 , "POSTMASTER1"

2 , "US"

MH-T-ACTION

OM-S-ENUMERATION

MH-AC-RELAYED

OM-S-ENUMERATION

MH-AC-EXPANDED

MH-AC-REDIRECTED

Type Syntax Value