OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide

Writing Your Program
OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide—424822-001
5-52
Editing a Root Object
Figure 5-14 shows use of the GPI_OM_REMOVE_ procedure. Conditions before the
procedure call are shown to the left of the vertical bracket; those after the call are to the
right. In this simplified example, you are removing two values of the multivalued
attribute of type C. As specified by value-position, the remove operation is to
start at value 2 of C. The value for maximum-number indicates that up to three values
can be removed.
For purposes of another example, suppose the object specified was object Y, and
attribute-type was type F, a single-valued attribute. After the call, the attribute
position 1 of object Y would be vacant.
Example: Removing an Attribute Value
The following TAL example shows a call to GPI_OM_REMOVE_ to remove a single-
valued attribute.
Data declarations:
INT
status, -- STATUS code
attribute_type := MH_T_PRMD_IDENTIFIER; -- Whose values are
-- to be removed
Figure 5-14. Using GPI_OM_REMOVE_
514CDT .CDD
OBJECT X (OBJECT_X_ID)
Attribute Type A
OM-S-Object
Object_Y_ID
1
0
OM-T-Class
OM-S-Integer
Object X
OBJECT Y (OBJECT_Y_ID)
Attribute Type F
Syntax of F
Value of F
1
OM-T-Class
OM-S-Integer
Object Y
0
2
Attribute Type C
Syntax of C
Value 0 of C
Value 1 of C
• • •
18
Attribute Type W
Syntax of W
Value of W
Attribute Type H
Syntax of H
Value of H
3
Input Parameters
object: OBJECT_X_ID
value-position: 2
attribute-type: Attribute Type C
maximum-number: 3
OBJECT X (OBJECT_X_ID)
Attribute Type A
OM-S-Object
Object_Y_ID
1
0
OM-T-Class
OM-S-Integer
Object X
OBJECT Y (OBJECT_Y_ID)
Attribute Type F
Syntax of F
Value of F
1
OM-T-Class
OM-S-Integer
Object Y
0
2
Attribute Type C
Syntax of C
Value 0 of C
Value 1 of C
Value 2 of C
Value 3 of C
• • •
18
Attribute Type W
Syntax of W
Value of W
Attribute Type H
Syntax of H
Value of H
3