OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide

Writing Your Program
OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide—424822-001
5-51
Editing a Root Object
Parameters for GPI_OM_REMOVE_ are:
object (input)
attribute-type (input)
value-position (input)
maximum-number (input)
total-number (output)
object specifies the identifier of the object whose attribute values you want to
remove.
attribute-type specifies the type of the attribute whose values you want to
remove.
value-position specifies the position within the attribute of the first value you
want to remove. The value of this parameter must not be greater than that of the last
value in the attribute before the procedure call.
maximum-number specifies the maximum number of attribute values to be removed.
If the maximum-number you specify exceeds the number of values in the attribute
starting at value-position, the value at value-position and all successive
values are removed.
total-number returns the number of values in the attribute before the current
operation. If the procedure call is unsuccessful, the parameter is unchanged.
Determining the Number of Values Present in a Multivalued Attribute
To determine the total number of values present in an attribute without removing any,
specify 0 as the value of maximum-number. The total number is returned through
total-number.
Removing a Value of a Single-Valued Attribute
To remove the value of a single-valued attribute, specify 0 for value-position and
1 for maximum-number.
Removing an Object
You can use the GPI_OM_REMOVE_ procedure to remove an attribute that represents
an object. This does the same as removing the object itself with the
GPI_OM_DELETE_ procedure.