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.
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.