Library: Interfaces, MQSeries access (OMMQI) Include: ommqi.xin

Declaration

  define external function mq-get-entire-return-status
            modifiable    mq-response-record    responses

Argument definitions

responses

is a shelf of mq-response-records in which a record will be inserted for each error that just occurred.

Use mq-get-entire-return-status to retrieve the IBM MQSeries error codes when the "MQI0001" external exception is received.

Requirements

You must include the following line at the beginning of your OmniMark program:

  include "ommqi.xin"

Usage Notes

When an OmniMark program receives the "MQI0001" external exception, that indicates that multiple IBM MQSeries error occurred during the ommqi function which was just called. mq-get-entire-return-status can be called to retrieve a shelf of response records returned by the IBM MQSeries client.

The responses shelf is cleared, and then one mq-response-record opaque is placed in the shelf for each error that occurred. The mq-get-response-record function can be used to get the CompCode and Response value from each mq-response-record.

The error codes are cleared upon the next ommqi call.

See OMMQI Error Handling for an example of how this function is used.

Related Syntax    mq-get-function-status

Related Concepts    ommqi Error Handling

Other Library Functions    mq-backout    mq-close    mq-commit    mq-connect    mq-connection    mq-connectx    mq-disconnect    mq-get    mq-get-entire-return-status    mq-get-function-status    mq-get-logging-level    mq-get-throw-on-warnings    mq-inquire    mq-inquire-names    mq-object    mq-open    mq-put    mq-put1message    mq-set    mq-set-logging-level    mq-set-throw-on-warnings

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACYLIBRARIES ] [ ERRORS ]