The API-crossing exit

WebSphere MQ provides an API-crossing exit for use with the CICS adapter; it runs in the CICS address space. We can use this exit to intercept WebSphere MQ calls as they are being run, for monitoring, testing, maintenance, or security purposes.

The sample API-crossing exit is supplied in source form only. For more information about writing API-crossing exit programs, see the WebSphere MQ Application Programming Guide

Note:
Using the API-crossing exit degrades WebSphere MQ performance. You should plan your use of it carefully.

 

Defining the exit program

Before the API-crossing exit can be used, an exit program load module must be available when the CICS adapter connects to WebSphere MQ. The exit program is a CICS program that must be named CSQCAPX and reside in a library in the DFHRPL concatenation. CSQCAPX must be defined in the CICS system definition file (CSD) and must be enabled.

When CSQCAPX is loaded a confirmation message is written to the CICS adapter control panel, CKQC, or the console. If it cannot be loaded, a diagnostic message is displayed, but otherwise the application program runs normally.