OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide

Recovering From Errors
OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide—424822-001
6-23
Common GPI Errors
GIP Not Started
ZGPI-RC-NO-GIPS
The returned value is 4012.
At least one GIP process must be running on the OSI/MHS subsystem for a
GPI_OPEN_ procedure call to succeed. When the client issues a GPI_OPEN_ call and
no GIP processes have yet been started, the GPI returns the error code 4012, ZGPI-RC-
NO-GIPS.
GPI Not Initialized
ZGPI-RC-USESEGMENT-ERROR
The returned value is 2504.
The GPI procedure calls are designed to use specific memory segments allocated to
them by a GPI_INITIALIZE_ call. When the client issues a GPI procedure call before
those memory segments have been allocated, that is, before the GPI_INITIALIZE_ call,
the GPI returns the error code 2504, ZGPI-RC-USESEGMENT-ERROR.
Session Not Opened
MH-RC-NO-SUCH-SESSION
The returned value is 115.
Several sessions can be open between the client and the GPI. The session parameter
of the GPI_OM_CREATE_ procedure call specifies one of those sessions. When the
client specifies a session that is not open OSI/MHS returns the error code 115,
MH-RC-NO-SUCH-SESSION. The secondary code contains the erroneous session ID.
Object Not Created
OM-RC-NO-SUCH-OBJECT
The returned value is 9.
An object must be created before any GPI object management procedures can be called
to act on that object. When a GPI_OM_*** procedure is called with an incorrect,
invalid, or nonexistent object’s identifier, OSI/MHS returns error code 9, OM-RC-NO-
SUCH-OBJECT.
Inserted Value Is Too Long
OM-RC-WRONG-VALUE-LENGTH
The returned value is 26.
Any value being inserted as an attribute of an object must match the length restrictions
on the syntax of the attribute. For example, a value for MH-T-COUNTRY-NAME must
be no longer than 3 characters. If the client attempts to issue GPI_OM_INSERT_ to
insert a value that does not match the length restrictions of the syntax of the attribute,