INQUIRE MQCONN

Description

The INQUIRE MQCONN command returns information about 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 retrieve 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 BUNDLE, 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.

Options

CHANGEAGENT(cvda)

Returns a CVDA value that identifies the agent that made the last change to the resource definition. 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(data-area)

Returns a 4-digit number of the CICS release that was running when the resource definition was last changed.

CHANGETIME(data-area)

Returns an ABSTIME value that represents the time stamp when the resource definition was last changed. For more information about the format of the ABSTIME value, see FORMATTIME.

CHANGEUSRID(data-area)

Returns the 8-character user ID that ran the change agent.

CONNECTST(cvda)

Returns the status of the CICS-MQ connection. CVDA 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(data-area)

Returns the 8-character source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT value. For more information, see Summary of the resource signature field values.

DEFINETIME(data-area)

Returns an ABSTIME value that represents the time stamp when the resource definition was created.

INSTALLAGENT(cvda)

Returns a CVDA value that identifies the agent that installed the resource. 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(data-area)

Returns an ABSTIME value that represents the time stamp when the resource was installed.

INSTALLUSRID(data-area)

Returns the 8-character user ID that installed the resource.

MQNAME(data-area)

Returns the 1 - 4 character name of the WebSphere MQ queue manager or queue-sharing group that you specified in the MQCONN resource definition (or using a SET MQCONN command) for the CICS region.

MQQMGR(data-area)

Returns the 1 - 4 character 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(data-area)

If CICS is connected to WebSphere MQ, this option returns the 4–digit release number of WebSphere MQ; for example, 0600. When CICS is not connected to WebSphere MQ, MQRELEASE returns blanks.

RESYNCMEMBER(cvda)

This option applies only if you have specified a queue-sharing group for the CICS-MQ connection. It shows 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. CVDA 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 message 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(data-area)

Returns the current number of tasks that are using the CICS-MQ connection, including trigger monitor tasks, as a fullword binary value.

TRIGMONTASKS(data-area)

Returns the current number of trigger monitor tasks that are using the CICS-MQ connection, as a fullword binary value.

Conditions

NOTFND

RESP2 values:

1

The MQCONN resource definition cannot be found.

NOTAUTH

RESP2 values:

100

Command authorization failure.