Administering the CICS-WebSphere MQ bridge
To start the bridge, run the CICS®-WebSphere® MQ bridge monitor transaction. The default name of the transaction is CKBR, but you can define your own alternative transaction.
About this task
It is recommended that you use a CICS-WebSphere MQ monitor to control the CICS-WebSphere MQ bridge. An MQMONITOR resource allows the bridge to automatically restart when the connection to the WebSphere MQ manager is established. For setup instructions, see Setting up a MQMONITOR resource for the CICS-WebSphere MQ bridge.
When you run CKBR, you can specify six optional parameters:
- Q=qqq
- qqq is the name of the WebSphere MQ request queue for the CICS-WebSphere MQ bridge. If you have defined your own request queue, you must specify it here. Remember that names of objects in WebSphere MQ are case-sensitive. If you do not specify a queue name, CKBR uses the default request queue SYSTEM.CICS.BRIDGE.QUEUE.
- AUTH=LOCAL|IDENTIFY|VERIFY_UOW|VERIFY_ALL
- Specifies the level of authentication to use. The default is LOCAL. Note that with LOCAL, CICS programs run by the bridge task are started with the user ID under which the bridge monitor was started, which might affect your choice of method to start the bridge monitor. With the other levels of authentication, CICS programs run with the user ID extracted from the request message. See Security for the CICS-WebSphere MQ bridge for more information about the levels of authentication.
- WAIT=nnn
- nnn is the number of seconds that you want the bridge task to wait for subsequent requests before timing out when processing a unit of work that runs many user programs. The default wait time is unlimited. You are recommended to specify a wait time, because if you do not specify a wait time, the bridge might inhibit shutdown for CICS or the queue manager.
- MSG=CSMT|LOG|BOTH
- Determines whether messages generated by the CICS-WebSphere MQ bridge are sent to the CICS job log, the CICS master terminal, or both. The default is BOTH.
- PASSTKTA=applid
- applid specifies the application ID to be used for validating the PassTicket. The default is the CICS region application ID. See the WebSphere MQ z/OS System Setup Guide for information about PassTickets.
- ROUTEMEM=Y|N
- Determines whether mark expired messages are to be routed to the DLQ. If you do not specify the parameter the default is N, no routing.