Stopping a CICS-MQ connection

You can stop the CICS®-MQ connection in several ways. When you stop the connection, you can choose whether to carry out a quiesced shutdown or a forced shutdown.

About this task

A quiesced shutdown lets each CICS transaction end before the interface is closed. A forced shutdown abnormally ends CICS transactions connected to the queue manager. For an explanation of the actions that the CICS-MQ adapter takes for a quiesced shutdown and a forced shutdown, see What happens when the CICS-WebSphere MQ connection shuts down.

You must stop the connection before you install a changed MQCONN resource definition for the CICS region.

When you restart the connection after a forced shutdown, there might be indoubt units of work. For information about indoubt units of work, see Automatic reconnection and resynchronization. For instructions about resolving indoubt units of work manually if necessary, see What happens when the CICS-WebSphere MQ adapter restarts.

Procedure

You can use any of the following methods to stop a CICS-MQ connection:
  • Using the CICS-MQ adapter control panels

    You can run the CICS-MQ adapter control transaction, CKQC, and then use the CICS-MQ adapter control panel to stop the CICS-MQ connection.

  • Issuing CKQC STOP from the CICS command line

    You can stop the CICS-MQ connection by issuing the CKQC STOP command from a command line.

  • Using a CICS application program that issues EXEC CICS SET MQCONN

    You can stop the connection to WebSphere MQ by issuing an EXEC CICS SET MQCONN command in a CICS application program.

  • Using a CICS application program with Linking to DFHMQDSC

    You can stop a connection to WebSphere MQ by linking to the CICS-MQ adapter program DFHMQDSC (or CSQCDSC, which is a previous name for the program), from a CICS application program. Although this method of stopping the connection is maintained for compatibility, using the EXEC CICS SET MQCONN command is the preferred method of stopping the connection from a CICS application program.

  • Using the CICS CEMT transaction

    You can stop the connection to WebSphere MQ by issuing the SET MQCONN command in the CICS CEMT transaction.

  • Using the CICSPlex® SM web user interface

    You can stop the connection to WebSphere MQ from the WebSphere MQ Connection view in the CICSPlex SM web user interface (WUI).

  • Using the CICS Explorer®

    You can stop the CICS-MQ connection from the CICS Explorer. The CICS Explorer provides a functional equivalent to the CICSPlex SM web user interface and the CEMT transaction.

Results

If you are using MQ monitors, when the MQ connection is stopped, MQ monitors are stopped automatically.