OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual

Information Architecture and Data Structures
OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual—522223-001
2-8
Descriptor Lists
In the figure, four attributes are requested, beginning at attribute position 0.
GPI_OM_EXAMINE_ returns only one descriptor for the multivalued attribute. This
descriptor contains the attribute type, syntax OM-S-UNSPECIFIED, and element
OM-ELEMENTS-UNSPECIFIED. The syntax and element indicate that the attribute is
multivalued. You must use the GPI_OM_LIST_ procedure to retrieve the actual
descriptors of a multivalued attribute (shown in value positions 0, 1, and 2).
When you create an object, you can specify that you want it to contain the attributes that
are defined as having initial values. If you create an object with initialized values, these
attributes begin at position zero. You can insert values for other attributes by calling the
GPI_OM_INSERT_ procedure (or the GPI_OM_WRITE_ procedure to insert string
values).
To get the values of multivalued attributes, you call the GPI_OM_LIST_ procedure.
Figure 2-5
shows an example of calling this procedure to get the values of the attribute
in position 1, beginning at value position 0.
Figure 2-4. Descriptor List of GPI_OM_EXAMINE_
Attribute
Position 0
Attribute
Position 1
GPI_OM_EXAMINE_
Descriptor-List
Buffer
• • •
Reserved Object
Value
Position 0
Value
Position 1
Value
Position 2
Value
Position 0
Descriptor of
Single-Valued
Attribute
Descriptor of
Multivalued
Attribute
Descriptor of
Multivalued
Attribute
Descriptor of
Multivalued
Attribute
Descriptor of
Single-Valued
Attribute
Descriptor of
Single-Valued
Attribute
Descriptor of
Multivalued
Attribute
Descriptor
with
Indicators
Attribute
Position 4
Attribute
Position 3
Attribute
Position 2
204VST .VSD