The CICS-WebSphere MQ API-crossing exit
CICS® provides an API-crossing exit for use with the CICS-WebSphere MQ adapter. You can use this exit to intercept WebSphere® MQ calls as they are being run, for monitoring, testing, maintenance, or security purposes. The exit runs in the CICS address space.
This section contains product-sensitive programming interface information.
- Operate additional security checks by examining the contents of each message before and after each MQI call
- Replace the queue name supplied in the message with another queue name
- Cancel the call and either issue a return code of 0 to simulate a successful call or another value to indicate that the call was not performed
- Monitor the use of MQI calls in an application
- Gather statistics
- Modify input parameters on specific calls
- Modify the results of specific calls
The CICS-WebSphere MQ API exit program is called CSQCAPX. CICS supplies a sample exit program, and a program definition for CSQCAPX in group DFHMQ. To use the exit, this program must be in the DFHRPL concatenation, it must be defined in the CICS system definition file (CSD), and it must be enabled. You can write your own exit program in place of the supplied sample, and you must call your program CSQCAPX as well.
When CSQCAPX is loaded, a confirmation message is written to the CICS-WebSphere MQ adapter control panel, CKQC, or the console. If it cannot be loaded, a diagnostic message is displayed, but otherwise the application program runs normally.