OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual

Procedure Calls

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

4-6

GPI_CLOSE_

This procedure ends a GPI session between a client and the GPI service.

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

session input

INT:value

specifies the session identifier of the established GPI session to be ended.

Considerations

•

All objects that are reserved by a specific session are made unreserved when you

call GPI_CLOSE_ to end that session or if the session terminates abnormally.

•

The session identifier becomes invalid after a call to GPI_CLOSE_, even if errors

occur while the procedure is executing.

status := GPI_CLOSE_ ( session ) ; ! I