OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide

Recovering From Errors
OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide—424822-001
6-9
Information Buffer
Information Buffer
For certain errors, the GPI_STATUS_ procedure writes additional information to an
information buffer. You can dump the buffer as part of a diagnostic routine. Buffer data
can be used to isolate some client-related problems and to document internal problems
for analysis by a Compaq representative.
You initialize the buffer by providing the following (Figure 6-3):
•
info-buffer, a pointer to the buffer starting address
•
info-buffer-length, an input parameter that sets buffer length in octets
You provide info-buffer as part of the procedure declaration. info-buffer-
length is an input parameter to the procedure call.
Following the call to GPI_STATUS_ , any error information is placed in the buffer, and
the following parameters are returned:
•
actual-info-length, the number of octets of error information returned
•
total-info-length, the total number of octets of error information available
MH-RC-FAILED 30 Correct client problem
MH-RC-CLIENT 40 Correct client problem
MH-RC-BLOCKED-INT 50 Call GPI_CLOSE_, correct problem and call
GPI_OPEN_
MH-RC-BLOCKED 60 Correct problem and call GPI_OPEN_
MH-RC-FATAL 70 Correct problem and call GPI_INITIALIZE_
MH-RC-INTERNAL 80 Correct problem and call GPI_INITIALIZE_
Note. You must provide an info-buffer-length if you provide the info-buffer pointer.
The recommended value for info-buffer-length is ZGPI-MAX-STATUS-BUF-LEN (512
octets).
Table 6-1. GPI_STATUS_ Error Classes (page 2 of 2)
Error class Value Recovery