CEMT INQUIRE MQCONN

Retrieve information about the connection between CICS® and WebSphere® MQ.

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

Description

The INQUIRE MQCONN command returns information about the attributes of the currently installed MQCONN resource definition, which defines the connection to WebSphere MQ, and about the status of 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 inquire on the INITQNAME attribute of the MQCONN resource definition, which specifies the name of the initiation queue. Use the INQUIRE MQINI command to inquire on the initiation queue name.

The resource signature

You can use this command to display the resource signature fields. You can use these fields to manage resources by capturing details of when the resource was defined, installed, and last changed. For more information, see Auditing resources. The resource signature fields are CHANGEAGENT, CHANGEAGREL, CHANGETIME, CHANGEUSRID, DEFINESOURCE, DEFINETIME, INSTALLAGENT, INSTALLTIME, and INSTALLUSRID. See Summary of the resource signature field values for detailed information about the content of the resource signature fields.

Input

Press the Clear key to clear the screen, and type CEMT INQUIRE MQCONN (or suitable abbreviations for the keywords). The resulting display lists the status. You can tab to the highlighted or blank fields and overtype them with the required values.

CEMT INQUIRE MQCONN

Read syntax diagramSkip visual syntax diagramCEMT INQUIRE MQCONN CONNECTEDNOTCONNECTEDCONNECTINGDISCONNINGRESYNCNORESYNCGROUPRESYNCMQNAME( value)MQQMGR( value)MQRELEASE( value)TASKS( value)TRIGMONTASKS( value)INSTALLTIME( date time)INSTALLUSRID( value)CREATESPICSDAPIGRPLISTDEFINESOURCE( value)DEFINETIME( date time)CHANGETIME( date time)CHANGEUSRID( value)CREATESPICSDAPICSDBATCHDREPAPICHANGEAGREL( value)

Displayed fields

CHANGEAGENT(value)
Displays a value that identifies the agent that made the last change to the resource definition. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:
CREATESPI
The resource definition was last changed by an EXEC CICS CREATE command.
CSDAPI
The resource definition was last changed by a CEDA transaction or the programmable interface to DFHEDAP.
CSDBATCH
The resource definition was last changed by a DFHCSDUP job.
DREPAPI
The resource definition was last changed by a CICSPlex SM BAS API command.
CHANGEAGREL(value)
Displays the 4-digit number of the CICS release that was running when the resource definition was last changed.
CHANGETIME(date time)
Displays the date and time when the resource definition was last changed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
CHANGEUSRID(value)
Displays the 8-character user ID that ran the change agent.
CONNECTST(value)
Displays the status of the CICS-MQ connection. The possible values are as follows:
CONNECTED
CICS is connected to WebSphere MQ.
NOTCONNECTED
CICS is not connected to WebSphere MQ.
CONNECTING
CICS is currently attempting to connect to WebSphere MQ.
DISCONNING
CICS is currently disconnecting from WebSphere MQ.
DEFINESOURCE(value)
Displays the source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT option. For details, see Summary of the resource signature field values.
DEFINETIME(date time)
Displays the date and time when the resource was created. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
INSTALLAGENT(value)
Displays a value that identifies the agent that installed the resource. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:
CREATESPI
The resource was installed by an EXEC CICS CREATE command.
CSDAPI
The resource was installed by a CEDA transaction or the programmable interface to DFHEDAP.
GRPLIST
The resource was installed by GRPLIST INSTALL.
INSTALLTIME(date time)
Displays the date and time when the resource was installed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
INSTALLUSRID(value)
Displays the 8-character user ID that installed the resource.
MQNAME(value)
Displays the 1- to 4-character name of the WebSphere MQ queue manager or queue-sharing group that you specified in the MQCONN resource definition (or by using a SET MQCONN command) for the CICS region.
MQQMGR(value)
Displays the name of the WebSphere MQ queue manager to which CICS is connected or to which CICS is waiting to connect.
  • If CICS is connected to WebSphere MQ, this field shows the name of the queue manager to which CICS is connected. If you specified a queue-sharing group in the MQCONN resource definition for the CICS region, the queue manager shown here is the one that was chosen from the group.
  • If CICS is not connected to WebSphere MQ, this field usually contains blanks. However, if you specified a queue-sharing group in the MQCONN resource definition for the CICS region, and CICS is waiting to reconnect to a specific queue manager in the queue-sharing group because it is holding outstanding units of work for that queue manager, the name of the specific queue manager is shown, and the status of the connection is shown as CONNECTING. For this situation to arise, the RESYNCMEMBER attribute in the MQCONN resource definition must specify resynchronization.
MQRELEASE(value)
If CICS is connected to WebSphere MQ, this field displays the release number of WebSphere MQ; for example, 0600. When CICS is not connected to WebSphere MQ, the field is blank.
RESYNCMEMBER(value)
This option applies only if you have specified a queue-sharing group for the CICS-MQ connection. RESYNCHMEMBER displays 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.
NOTAPPLIC
A queue-sharing group is not specified for the CICS-MQ connection.
TASKS(value)
Displays the current number of tasks that are using the CICS-MQ connection, including trigger monitor tasks.
TRIGMONTASKS(value)
Displays the current number of trigger monitor tasks that are using the CICS-MQ connection.