The supplied program definition for CSQCAPX specifies
STATUS(DISABLED),
The program is installed in a disabled state because using the exit
program can significantly reduce
WebSphere®
MQ
performance. You must enable the API-crossing exit before you can
use it.
About this task
You can activate the API-crossing exit temporarily using
the CICS-WebSphere MQ adapter control panels, the command line, or
a
CICS®
application program.
You can enable the API-crossing exit permanently by modifying your
CICS
resource definitions.
Procedure
- To activate the API-crossing exit temporarily using the
CICS-WebSphere MQ adapter control panels, follow these steps:
- Type
CKQC
and press Enter to
access the CICS-WebSphere MQ adapter control panels.
- Select
Connection
from the menu
bar.
- Select the
Modify
action from
the menu.
- In the
Modification Options
secondary
parameter window, select
Enable API Exit
and
press Enter to alter the status of the API-crossing exit to Enabled.
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
- To activate the API-crossing exit temporarily from the
CICS
command line, choose one of
these methods:
- Issue the command
CEMT S PROGRAM(CSQCAPX) ENABLED
from
the
CICS
master terminal.
- Issue the command
CKQC MODIFY N E
from
the command line. The option
E
enables the
connection. The option
N
relates to the connection
statistics and is required, but has no effect.
- To activate the API-crossing exit temporarily 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
E.
This example shows how to do this:
EXEC CICS LINK PROGRAM('DFHMQRS ')
INPUTMSG('CKQC MODIFY N E ')
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.
- To run with the API-crossing exit permanently enabled,
follow these steps:
- Copy the definition of CSQCAPX from the CICS-supplied
group DFHMQ to your own group.
- Alter the CSQCAPX definition by changing the status
from DISABLED to ENABLED, and install your new group.
- Ensure that your group is installed after DFHMQ in any
grouplist.