Administering the CICS-MQ bridge
To start the bridge, run the CICS®-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-MQ monitor to control the CICS-MQ bridge. An MQMONITOR resource allows the bridge to automatically restart when the connection to the IBM® MQ manager is established. For setup instructions, see Setting up an MQMONITOR resource for the CICS-MQ bridge. Note that the attributes needed by the CICS-MQ bridge must be specified in the MONDATA attribute of the MQMONITOR.
When you run CKBR, you can specify six optional parameters:
- Q=qqq
- qqq is the name of the IBM MQ request queue for the CICS-MQ bridge. If you have defined your own request queue, you must specify it here. Remember that names of objects in IBM 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 the bridge task is processing a unit of work that runs many user programs. This value must be in the range 0 through 999. If this parameter is not specified, the default is MQWI_UNLIMITED, which has a value of -1. You are recommended to specify a wait time, because if you do not specify a wait time, the bridge might inhibit the shutdown of CICS or the queue manager.
- MSG=CSMT|LOG|BOTH
- Determines whether messages generated by the CICS-MQ bridge are sent to the CICS job log, the CICS main 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 Setting up security on z/OS in IBM MQ product documentation 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.