CEMT SET MQCONN

Change information about the attributes of the connection between CICS® and WebSphere® MQ, and start or stop the connection.

In the CICS Explorer, the Websphere MQ Connections operations view provides a functional equivalent to this command.

Use the SET MQCONN command to change attributes of the currently installed MQCONN resource definition, which defines the connection to WebSphere MQ, and starts and stops the connection.

Because only one MQCONN resource definition can be installed at a time, the name of the MQCONN resource definition is not required on input.

This command does not set the INITQNAME attribute of the MQCONN resource definition, which specifies the name of the initiation queue. If you want to change the MQINI resource definition, you must reinstall the MQCONN resource definition with an appropriate MQINI attribute.

Syntax

Press the Clear key to clear the screen. You can start this transaction in two ways:
  • Type CEMT SET MQCONN (or suitable abbreviations for the keywords). The resulting display lists the status, similar to that obtained by using the CEMT INQUIRE MQCONN command. You can tab to the highlighted or blank fields and overtype them with the required values.
  • Type CEMT SET MQCONN (or suitable abbreviations for the keywords), followed by one or more attribute settings that you want to change.

Typing ? at the beginning of either the first or second line gives a syntax prompt.

SET MQCONN

Read syntax diagramSkip visual syntax diagramCEMT SET MQCONNCONNECTEDNOTCONNECTEDFORCENOTCONMQNAME( value)RESYNCNORESYNCGROUPRESYNC

Conditions: NOTAUTH, NOTFND

Options

CONNECTST(value)
Starts or stops the connection between CICS and WebSphere MQ. The possible values are as follows:
CONNECTED
Starts the CICS-WebSphere MQ connection. If the requested queue manager is active, control returns to the application when CICS and WebSphere MQ are connected. If the requested queue manager is not active, CICS connects to WebSphere MQ as soon as the requested queue manager becomes active.
NOTCONNECTED
Stops the CICS-WebSphere MQ connection. Existing transactions are allowed to finish before the connection is stopped. The request is asynchronous in nature; that is, control is returned to the application before the request is complete.
FORCENOTCON
Stops the CICS-WebSphere MQ connection. Any CICS transactions currently using WebSphere MQ are abnormally stopped, and the connection to WebSphere MQ is stopped. The request is synchronous in nature; that is, control is not returned to the application until the connection is stopped.
MQNAME(value)
Specifies the 1 - 4 character name of a WebSphere MQ queue manager or queue-sharing group to which CICS is to connect. CICS attempts to connect to the queue manager or to any active member of the queue-sharing group. You can change MQNAME only when CICS is not connected to WebSphere MQ.

When you specify MQNAME, the queue manager name or queue-sharing group that you specified in the MQNAME attribute of the installed MQCONN resource definition is replaced with the name that you specified on this command. If you want to revert to the original queue manager or queue-sharing group, you must set MQNAME again.

RESYNCMEMBER(value)
This option applies only if you have specified a queue-sharing group for the CICS-WebSphere MQ connection. It specifies the strategy that CICS adopts if outstanding units of work are being held for the last queue manager to which CICS was connected from the queue-sharing group. Units of work that are shunted indoubt are not included in this process, because CICS itself cannot resolve those units of work at this time. Resynchronization for those UOWs occurs when CICS has resynchronized with its remote coordinator. The possible values are as follows:
RESYNC
CICS connects to the same queue manager.
NORESYNC
CICS makes one attempt to connect to the same queue manager. If that attempt fails, CICS connects to any member of the queue-sharing group and issues a warning about the outstanding units of work.
GROUPRESYNC
CICS connects to any member of the queue-sharing group. The queue manager is chosen by WebSphere MQ and it asks CICS to resolve indoubt units of work on behalf of all eligible queue managers in the queue-sharing group. This function is called group unit of recovery. The GROUPRESYNC option can be used only you are when running a release of WebSphere MQ that supports group unit of recovery for CICS and when the GROUPUR attribute has been enabled in the WebSphere MQ queue managers.

When an attempt is made to connect CICS to WebSphere MQ by using an EXEC CICS SET MQCONN CONNECTED command and RESYNCMEMBER(GROUPRESYNC) is set but WebSphere MQ does not support group unit of recovery, or group unit of recovery is not enabled, then WebSphere MQ rejects the connection attempt. The connection attempt results in the SET command failing with INVREQ and RESP2=9 (connection error).

Do not change the settings for RESYNCMEMBER when units of work are outstanding in WebSphere MQ because the units of work cannot then be resolved. A unit of work held in CICS is identified with a resource manager qualifier. When RESYNCMEMBER(GROUPRESYNC) is used, the qualifier is the name of the queue-sharing group, otherwise the qualifier used is the name of the individual queue manager.