OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual

Return Codes
OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual—522223-001
B-14
70 ZGPI-RC-CLASS-FATAL
including the installed software release IDs, and make sure the necessary SCF objects
are in the correct state. Reset your applications’ session environment and open a new
session.
70 ZGPI-RC-CLASS-FATAL
Cause. A failure occurred from which your program can recover only by reinitializing
the GPI environment. For example, the GPI cannot access its reserved extended
segment.
Effect. All GPI retained memory structures for all current sessions are lost.
Recovery. Although the call might not succeed, try calling GPI_STATUS_ to get more
information. Then call the GPI_INITIALIZE_ procedure. Keep a full record of the
other GPI_STATUS_ information. If the problem continues to occur, report it to your
Compaq representative.
80 ZGPI-RC-CLASS-INTERNAL
Cause. An internal error has occurred.
Effect. The GPI library might be unusable and total capability of the GPI lost.
Recovery. Although the call might not succeed, try calling GPI_STATUS_ to get more
information. Then try calling the GPI_INITIALIZE_ procedure. If the initialization
fails, report the problem to your Compaq representative.
Compaq Proprietary Codes
ZGPI-RC- codes are Compaq proprietary codes instead of X.400 API standard codes.
These codes are returned in the primary-code parameter of GPI_STATUS_ . (In the
following descriptions, codes that can also be returned in the status parameter of the
GPI_INITIALIZE_ and GPI_STATUS_ procedures are identified in the descriptions.)
Table B-5 summarizes the ZGPI-RC- codes you can receive when parameters are
invalid and explains what they mean. A more detailed description of each code follows
the table.
Note. For error classes 30 through 80, you can call GPI_STATUS_ to get more information.
You can also retry the operation. If the problem continues to occur, you can try to reinitialize
the GPI. You should also check the operational environment and make sure your software is
correctly installed with all elements from the same release.
Table B-5. ZGPI-RC- Codes for Parameter-Validation Errors
Constant (ZGPI-RC-) Value Meaning
MISSING-REQUIRED-PARAM 2000 Procedure call omitted a required parameter.
PARAMETER-OUT-OF-BOUND 2001 Parameter length or address is incorrect.
MISSING-OPTIONAL-PARAM 2002 Optional parameter (required because of
presence of another parameter) is missing.