OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual

Procedure Calls
OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual—522223-001
4-41
GPI_OM_REMOVE_
To determine the total number of values in the attribute without removing any
values, specify 0 as the value of this parameter. The total number of values in the
attribute is returned in the total-number parameter.
total-number output
INT(32) .EXT:ref:1
is the total number of values in the attribute before the current remove operation. If
the procedure call is unsuccessful, the parameter is unchanged.
Considerations
•
You can also remove an attribute that is an object (in other words, a subobject) by
using the GPI_OM_DELETE_ procedure.
•
All objects have an attribute of type OM-T-CLASS that cannot be modified or
removed. The OM-T-CLASS attributes exists until its object is deleted or transferred
out to the GPI service output queue. You can remove all other attributes of an object
and their values, but the object remains accessible.