Disabling the CICS-MQ API-crossing exit

To improve IBM® MQ performance, disable the CICS®-MQ API-crossing exit when you no longer need it.

About this task

You can disable the API-crossing exit using the CICS-MQ adapter control panels, the command line, or a CICS application program.

Procedure

  1. To disable the API-crossing exit using the CICS-MQ adapter control panels, follow these steps:
    1. Type CKQC and press Enter to access the CICS-MQ adapter control panels.
    2. Select Connection from the menu bar.
    3. Select the Modify action from the menu.
    4. In the Modification Options secondary parameter window, select Disable API Exit and press Enter to alter the status of the API-crossing exit to Disabled.
    The screen shows this process:
    
        Connection        CKTI        Task
     +--------------------+--------------------------------------------------------
     | Select an action.  |CS Adapter Control -- Initial panel
     |                    |
     | 3 1. Start...      |sing Tab key. Then press Enter.
     |   2. Stop...       |
     |   3. Modify...     |  +--------------------------------+
     |   4. Display       |  |      Modification Options      |
     |                    |  |                                |
     +--------------------+  | Select modify option. Then     |
     | F1=Help F12=Cancel |  | press Enter.                   | 
     +--------------------+  |                                |
                             | 4 1. Reset statistics          | 
                             |   2. Enable API Exit           | 
                             |   3. Disable API Exit          | 
                             |--------------------------------+
                             | F1=Help  F12=Cancel            |
                             +--------------------------------+
     
     
     F1=Help  F3=Exit
    
  2. To disable the API-crossing exit from the CICS command line, choose one of these methods:
    • Issue the command CEMT S PROGRAM(CSQCAPX) DISABLED from the CICS main terminal.
    • Issue the command CKQC MODIFY N D from the command line. The option D disables the connection. The option N relates to the connection statistics and is required, but has no effect.
  3. To disable the API-crossing exit using a CICS application program, issue an EXEC CICS LINK command to link to the adapter reset program, DFHMQRS (or CSQCRST, which is retained for compatibility), and issue the CKQC MODIFY command with the option D.
    This example shows how to do this:
     EXEC CICS LINK PROGRAM('DFHMQRS ')
               INPUTMSG('CKQC MODIFY     N D ')
    
    The MODIFY command must be padded with 4 trailing spaces plus another space as a separator (see CKQC commands from CICS(r) application programs ). The option N relates to the connection statistics and is required, but has no effect.