With Release 10.2 and more current, Abend-AID for WebSphere MQ is provided as an option and is no longer a separate product. Abend-AID for WebSphere MQ assists WebSphere MQ application programmers by providing analysis for error conditions occurring in the batch environment, as well as for errors resulting from the WebSphere MQ IMS Adapter interface for z/OS-based applications. WebSphere MQ information is viewable in the Abend-AID for WebSphere MQ section of the Abend-AID report associated with the application.

WebSphere MQ provides information unavailable in standard WebSphere MQ diagnostic codes and messages including:

• Description of the last WebSphere MQ request
• Diagnostics for return and reason codes
• Corrective action necessary to resolve the problem
• Buffer for the current WebSphere MQ call (current record)
• Interpretation of pertinent WebSphere MQ control blocks.

In addition, for IMS applications using the WebSphere MQ IMS Adapter, Abend-AID provides the IMS connection information along with the information currently provided by Abend-AID in the IMS section of the report.

For WebSphere MQ system abends, Abend-AID provides enhanced diagnostics and programmer response.

WebSphere MQ is similar to Dv2 in that it does not normally abend when there is a problem. Instead, each WebSphere MQ API call has an associated return and reason code. While there are only a handful of return codes, there are hundreds of reason codes and many are confusing and difficult to correct. These are the WebSphere MQ equivalents of the Db2 negative SQL codes. Abend-AID provides full support for all of these codes.

Programmers can obtain reports automatically at application error-time or selectively during run-time through the Abend-AID SNAP-AID facility. See Using SNAP-AID for more information.

Abend-AID is automatically invoked when an abend occurs. However, when a non-zero WebSphere MQ return and/or reason code is encountered, an abend does not occur and program processing continues. To obtain complete WebSphere MQ information without terminating the program, use Abend-AID SNAP-AID. A simple call to the SNAPAID module in the application program is all that is needed to invoke this support.

For example, in COBOL: 

Many shops prefer to issue user abends when an error is detected. A call to ILBOABN0/CEE3ABD could be issued instead and WebSphere MQ information is still included in the associated Abend-AID report.

Abend-AID for WebSphere MQ information is provided for applications using WebSphere MQ regardless whether the fault is WebSphere MQ-related. If the WebSphere MQ environment is active at the time of the error, then the information is included in the associated Abend-AID report.

WebSphere MQ Application Information

For applications using WebSphere MQ in batch or using the WebSphere MQ IMS Adapter, the following information is provided in the WebSphere MQ Batch information section of the report.

• Analysis of the status returned for the last request issued to WebSphere MQ by the application
• Pertinent buffer and its contents
• Information about the WebSphere MQ operating environment under which the applications program was executing
• Message information
• Queue information about the queue referenced by the last WebSphere MQ request.

MQSeries Diagnostic Information

Buffer and Its Contents

MQSeries General Information

MQSeries Queue Definition

In addition to the information displayed in the WebSphere MQ Batch section of the report, the WebSphere MQ IMS section displays information for programs that access WebSphere MQ via the IMS Adapter feature. Use this information in conjunction with the IMS database information provided in the same Abend-AID report to resolve the fault. For IMS WebSphere MQ Adapter applications, Abend-AID displays:

• IMS-specific summary information for the application program.
• Information that describes the connection used by the program to issue requests to WebSphere MQ.
• Language Interface Token (LIT) definition information for the connection to WebSphere MQ from IMS.
• Analysis of LIT definition in the IMS control region and the IMS dependent region.

MQSeries – IMS Adapter Information