MQRC_* values" /> Feedback (MQLONG)
Home

 

Feedback (MQLONG)

This is used with a message of type MQMT_REPORT to indicate the nature of the report, and is only meaningful with that type of message. The field can contain one of the MQFB_* values, or one of the MQRC_* values. Feedback codes are grouped as follows:

MQFB_NONE

No feedback provided.

MQFB_SYSTEM_FIRST

Lowest value for system-generated feedback.

MQFB_SYSTEM_LAST

Highest value for system-generated feedback.

The range of system-generated feedback codes MQFB_SYSTEM_FIRST through MQFB_SYSTEM_LAST includes the general feedback codes listed below (MQFB_*), and also the reason codes (MQRC_*) that can occur when the message cannot be put on the destination queue.

MQFB_APPL_FIRST

Lowest value for application-generated feedback.

MQFB_APPL_LAST

Highest value for application-generated feedback.

Applications that generate report messages must not use feedback codes in the system range (other than MQFB_QUIT), unless they want to simulate report messages generated by the queue manager or message channel agent.

On the MQPUT or MQPUT1 calls, the value specified must either be MQFB_NONE, or be within the system range or application range. This is checked whatever the value of MsgType.

General feedback codes:

MQFB_COA

Confirmation of arrival on the destination queue (see MQRO_COA).

MQFB_COD

Confirmation of delivery to the receiving application (see MQRO_COD).

MQFB_EXPIRATION

Message was discarded because it had not been removed from the destination queue before its expiry time had elapsed.

MQFB_PAN

Positive action notification (see MQRO_PAN).

MQFB_NAN

Negative action notification (see MQRO_NAN).

MQFB_QUIT

End application.

This can be used by a workload scheduling program to control the number of instances of an application program that are running. Sending an MQMT_REPORT message with this feedback code to an instance of the application program indicates to that instance that it should stop processing. However, adherence to this convention is a matter for the application; it is not enforced by the queue manager.

IMS-bridge feedback codes: When the IMS bridge receives a nonzero IMS-OTMA sense code, the IMS bridge converts the sense code from hexadecimal to decimal, adds the value MQFB_IMS_ERROR (300), and places the result in the Feedback field of the reply message. This results in the feedback code having a value in the range MQFB_IMS_FIRST (301) through MQFB_IMS_LAST (399) when an IMS-OTMA error has occurred.

The following feedback codes can be generated by the IMS bridge:

MQFB_DATA_LENGTH_ZERO

A segment length was zero in the application data of the message.

MQFB_DATA_LENGTH_NEGATIVE

A segment length was negative in the application data of the message.

MQFB_DATA_LENGTH_TOO_BIG

A segment length was too big in the application data of the message.

MQFB_BUFFER_OVERFLOW

The value of one of the length fields would cause the data to overflow the message buffer.

MQFB_LENGTH_OFF_BY_ONE

The value of one of the length fields was one byte too short.

MQFB_IIH_ERROR

The Format field in MQMD specifies MQFMT_IMS, but the message does not begin with a valid MQIIH structure.

MQFB_NOT_AUTHORIZED_FOR_IMS

The user ID contained in the message descriptor MQMD, or the password contained in the Authenticator field in the MQIIH structure, failed the validation performed by the IMS bridge. As a result the message was not passed to IMS.

MQFB_IMS_ERROR

An unexpected error was returned by IMS. Consult the WebSphere MQ error log on the system on which the IMS bridge resides for more information about the error.

MQFB_IMS_FIRST

IMS-generated feedback codes occupy the range MQFB_IMS_FIRST (300) through MQFB_IMS_LAST (399). The IMS-OTMA sense code itself is Feedback minus MQFB_IMS_ERROR.

MQFB_IMS_LAST

Highest value for IMS-generated feedback.

CICS-bridge feedback codes: The following feedback codes can be generated by the CICS bridge:

MQFB_CICS_APPL_ABENDED

The application program specified in the message abended. This feedback code occurs only in the Reason field of the MQDLH structure.

MQFB_CICS_APPL_NOT_STARTED

The EXEC CICS LINK for the application program specified in the message failed. This feedback code occurs only in the Reason field of the MQDLH structure.

MQFB_CICS_BRIDGE_FAILURE

CICS bridge terminated abnormally without completing normal error processing.

MQFB_CICS_CCSID_ERROR

Character set identifier not valid.

MQFB_CICS_CIH_ERROR

CICS information header structure missing or not valid.

MQFB_CICS_COMMAREA_ERROR

Length of CICS commarea not valid.

MQFB_CICS_CORREL_ID_ERROR

Correlation identifier not valid.

MQFB_CICS_DLQ_ERROR

The CICS bridge task was unable to copy a reply to this request to the dead-letter queue. The request was backed out.

MQFB_CICS_ENCODING_ERROR

Encoding not valid.

MQFB_CICS_INTERNAL_ERROR

CICS bridge encountered an unexpected error.

This feedback code occurs only in the Reason field of the MQDLH structure.

MQFB_CICS_NOT_AUTHORIZED

User identifier not authorized or password not valid.

This feedback code occurs only in the Reason field of the MQDLH structure.

MQFB_CICS_UOW_BACKED_OUT

The unit of work was backed out, for one of the following reasons:

  • A failure was detected while processing another request within the same unit of work.

  • A CICS abend occurred while the unit of work was in progress.

MQFB_CICS_UOW_ERROR

Unit-of-work control field UOWControl not valid.

Trace-route message feedback codes:

MQFB_ACTIVITY

Used in conjunction with the MQFMT_EMBEDDED_PCF format to allow the option of user data following activity reports.

MQFB_MAX_ACTIVITIES

Returned when the trace-route message is discarded because the number of activities the message has been involved in exceeds the maximum activities limit.

MQFB_NOT_FORWARDED

Returned when the trace-route message is discarded because it is about to be sent to a remote queue manager that does not support trace-route messages.

MQFB_NOT_DELIVERED

Returned when the trace-route message is discarded because it is about to be put on a local queue.

MQFB_UNSUPPORTED_FORWARDING

Returned when the trace-route message is discarded because a value in the forwarding parameter is unrecognized, and is in the rejected bit mask.

MQFB_UNSUPPORTED_DELIVERY

Returned when the trace-route message is discarded because a value in the delivery parameter is unrecognized, and is in the rejected bit mask.

MQ reason codes: For exception report messages, Feedback contains an MQ reason code. Among possible reason codes are:

MQRC_PUT_INHIBITED

(2051, X'803') Put calls inhibited for the queue.

MQRC_Q_FULL

(2053, X'805') Queue already contains maximum number of messages.

MQRC_NOT_AUTHORIZED

(2035, X'7F3') Not authorized for access.

MQRC_Q_SPACE_NOT_AVAILABLE

(2056, X'808') No space available on disk for queue.

MQRC_PERSISTENT_NOT_ALLOWED

(2048, X'800') Queue does not support persistent messages.

MQRC_MSG_TOO_BIG_FOR_Q_MGR

(2031, X'7EF') Message length greater than maximum for queue manager.

MQRC_MSG_TOO_BIG_FOR_Q

(2030, X'7EE') Message length greater than maximum for queue.

For a full list of reason codes, see:

.

This is an output field for the MQGET call, and an input field for MQPUT and MQPUT1 calls. The initial value of this field is MQFB_NONE.



 

Home