OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual

Procedure Calls

OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual—522223-001

4-20

GPI_OM_COPY_

This procedure creates a new object that is an exact but independent copy of a specified

object. The new object includes all subobjects of the object you are copying.

status returned value

INT:value

indicates the outcome of the call. A value of OM-RC-SUCCESS indicates a

successful call. For additional values of status, see Appendix B, Return Codes

original input

INT(32):value

specifies the object identifier of the object to be copied.

copy output

INT(32) .EXT:ref:1

is the object identifier of the newly copied object. If the procedure is not successful,

this parameter is unchanged.

copy-root-object input

INT(32):value

specifies the object identifier of the root object with which the copied object is to be

associated. The specified root object must already exist. You must specify this

parameter if the object you are copying is not a root object. If the object you are

copying is a root object, this parameter is ignored.

copy-session input

INT:value

specifies the session identifier of the session with which the copied root object is to

be associated. The session must already be established. If the original object to be

copied is a root object, you must specify a value for this parameter. If the object you

are copying is not a root object, this parameter is ignored.

status := GPI_OM_COPY_ ( original ! I

, copy ! O

, [ copy-root-object ] ! I

, [ copy-session ] ) ; ! I