OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual

Procedure Calls
OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual—522223-001
4-23
GPI_OM_CREATE_
root-object input
INT(32):value
specifies the object identifier of the root object with which the new object is to be
associated. The specified root object must already exist. If the object you are
creating is not a root object, you must specify a value for this parameter. If you are
creating a root object, this parameter is ignored.
session input
INT:value
specifies the session identifier of the session in which the object is being created. If
the object you are creating is a root object, you must specify a value for this
parameter. If you are creating an object that is not a root object, this parameter is
ignored.
class-obj-id input (optional)
STRING .EXT:ref:*
is the ASN.1 object identifier that identifies the class of the object to be created.
This parameter is ignored if the value of the class parameter is not ZGPI-CLASS-
UNSPECIFIED.
class-obj-id-len input (optional)
INT:value
specifies the length in octets of the object identifier specified by class-obj-id.
Considerations
•
You refer to the object by its object identifier in all other procedure calls that operate
on the object.
•
You can examine, modify, transfer out, and copy the new object. Until you transfer
the object to the output queue of the GPI service, your client application is
responsible for the object.
•
The attributes of the new object and their initial values are specified for each class
of object in its definition. For a description of object classes, see Section 3, Object
Classes and Attribute Types. For the DDL definitions of objects and their attributes,
see Appendix A, DDL Definitions.
Some required attributes do not have initial values defined. You must insert values
for these attributes before transferring the object out to the GPI service output
queue.
If you specify that you want to initialize the new object, all optional attributes that
have initial values defined will be inserted in the object.