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
>>-CEMT SET MQCONN--+--------------+--+---------------+--------->
+-CONNECTED----+ '-MQNAME(value)-'
+-NOTCONNECTED-+
'-FORCENOTCON--'
>--+-------------+---------------------------------------------><
+-RESYNC------+
+-NORESYNC----+
'-GROUPRESYNC-'
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.