WebSphere MQ connections - MQCON

The WebSphere MQ connection (MQCON) views display status information and statistics for the WebSphere MQ connection for a CICS region.

Supplied views

To access from the main menu, click:

CICS operations views > DB2, DBCTL and WebSphere MQ operations views > WebSphere MQ connections

Table 1. Views in the supplied WebSphere MQ connection (MQCON) view set
View Notes
WebSphere MQ connection

EYUSTARTMQCON.CONNECT

 Connect this CICS system to WebSphere MQ. If the requested Websphere MQ queue manager is not active, state will be set to connecting and the connection will complete when WebSphere MQ becomes active.
WebSphere MQ connection

EYUSTARTMQCON.DETAIL1

 Statistics for WebSphere MQ API calls, by individual command.
WebSphere MQ connection

EYUSTARTMQCON.DETAIL2

 Statistics for indoubt, unresolved, committed and backed out units of work.
WebSphere MQ connection

EYUSTARTMQCON.DETAIL3

 Statistics for all WebSphere MQ API calls made using the connection.
WebSphere MQ connection

EYUSTARTMQCON.DETAIL4

 Resource signature information about a selected MQ connection.
WebSphere MQ connection

EYUSTARTMQCON.DETAILED

 Overview information about the WebSphere MQ connection for the selected CICS region.
WebSphere MQ connection

EYUSTARTMQCON.DISCARD

 Removes this MQCONN. The MQCONN must be set to NOTCONNECTED before it can be discarded.
WebSphere MQ connection

EYUSTARTMQCON.DISCONNECT

 Disconnect this CICS system from WebSphere MQ. Use the BUSY parameter to determine whether to wait for disconnect to complete (WAIT), return control after initiating a quiesce (NOWAIT) or force purge transactions currently using WMQ (FORCE)
WebSphere MQ connection

EYUSTARTMQCON.SET

 Set attributes according to values specified in input fields
WebSphere MQ connection

EYUSTARTMQCON.TABULAR

 Tabular information about WebSphere MQ connections for CICS regions.

Actions

Table 2. Actions available for MQCON views
Action Description
CONNECT Connect this CICS system to WebSphere MQ. If the requested Websphere MQ queue manager is not active, state will be set to connecting and the connection will complete when WebSphere MQ becomes active.
DISCARD Removes this MQCONN. The MQCONN must be set to NOTCONNECTED before it can be discarded.
DISCONNECT Disconnect this CICS system from WebSphere MQ. Use the BUSY parameter to determine whether to wait for disconnect to complete (WAIT), return control after initiating a quiesce (NOWAIT) or force purge transactions currently using WMQ (FORCE)
SET Set attributes according to values specified in input fields

Fields

Table 3. Fields in MQCON views
Field Attribute name Description
BAS resource definition version BASDEFINEVER The BAS version number of this definition.
Last modification agent CHANGEAGENT The change agent identifier that made the last modification.
  • CSDAPI - The resource was last changed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
  • CSDBATCH - The resource was last changed by a DFHCSDUP job.
  • DREPAPI - The resource was last changed by a CICSPlex SM BAS API command.
  • DREPBATCH - The resource was last changed by a CICSPlex SM utility.
  • CREATESPI - The resource was last changed by an EXEC CICS CREATE command.
  • NOTAPPLIC - This is not applicable for this resource.
Last modification agent release CHANGEAGREL The CICS release level of the agent that made the last modification to the resource definition.
Last modification time CHANGETIME The local date and time when the definition was last changed.
Last modification user ID CHANGEUSRID The user ID that made the last modification to the resource definition.
Connection status CONNECTST CONNECTST returns the status of the CICS MQ connection. CVDA values are:
  • 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.
Source of the resource definition DEFINESOURCE The source of the definition, depending on which agent made the last change.
Creation time DEFINETIME The local date and time when the resource definition record was created on DFHCSD or EYUDREP.
Installation agent INSTALLAGENT The install agent identifier that made the installation.
  • CSDAPI - The resource was installed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
  • CREATESPI - The resource was installed by an EXEC CICS CREATE command.
  • GRPLIST - The resource was installed by GRPLIST INSTALL.
Installation time INSTALLTIME The local date and time when the definition was installed.
Installation user ID INSTALLUSRID The user ID that installed the resource definition.
GMT connection time MQGGMTCONN The GMT date and time when CICS connected to WebSphere MQ.
GMT disconnect time MQGGMTDISC The GMT date and time when CICS disconnected from WebSphere MQ.
Number of indoubt units of work MQGINDBTUOW The total number of UOWs that were indoubt at startup of the WebSphere MQ adapter.
Initiation queue name MQGINITQ The name of the default WebSphere MQ initiation queue.
Local connection time MQGLOCCONN The local date and time when CICS connected to WebSphere MQ.
Local disconnect time MQGLOCDISC The local date and time when CICS disconnected from WebSphere MQ.
Number of resolved backout units of work MQGRESBACUW The number of UOWs that were indoubt at startup of the WebSphere MQ adapter, and were resolved by a backout.
Number of resolved committed units of work MQGRESCOMUW The number of UOWs that were indoubt at startup of the WebSphere MQ adapter, and were resolved by a commit.
Number of two phase commit operations MQGT2PCOMM The total number of two phase commits for UOWs on the connection.
Number of WebSphere MQ API calls since WebSphere MQ connected MQGTAPI The total number of WebSphere MQ API calls that have been made since CICS connected to WebSphere MQ.
Number of WebSphere MQ API calls completed successfully MQGTAPIOK The total number of WebSphere MQ API calls that completed successfully.
Number of backout units of work MQGTBACKUOW The total number of UOWs on the connection which were resolved by a backout.
Number of MQBUFMH requests MQGTBUFMH The total number of times the MQBUFMH command was issued.
Number of internal WebSphere MQ calls MQGTCALL The total number of internal calls to WebSphere MQ on the connection.
Number of WebSphere MQ calls that needed I/O MQGTCALLIO The total number of WebSphere MQ API calls that required I/O to complete.
Number of WebSphere MQ calls that completed synchronously MQGTCALLSYNC The total number of WebSphere MQ API calls that completed synchronously.
Number of MQCB requests MQGTCB The total number of times the MQCB command was issued.
Number of MQCLOSE requests MQGTCLOSE The total number of times the MQCLOSE command was issued.
Number of committed units of work MQGTCOMMUOW The total number of UOWs on the connection which were resolved by a commit.
Number of messages consumed MQGTCONSUME The total number of messages passed to callback routines.
Number of MQCRTMH requests MQGTCRTMH The total number of times the MQCRTMH command was issued.
Number of MQCTL requests MQGTCTL The total number of times the MQCTL command was issued.
Number of MQDLTMH requests MQGTDLTMH The total number of times the MQDLTMH command was issued.
Number of MQDLTMP requests MQGTDLTMP The total number of times the MQDLTMP command was issued.
Number of WebSphere MQ API calls when WebSphere MQ was not connected MQGTFUTATT The total number of WebSphere MQ API calls that were made when the connection status was 'NOTCONNECTED' (that is, futile attempts). When CICS connects to WebSphere MQ, this number is reset to zero.
Number of MQGET requests MQGTGET The total number of times the MQGET command was issued.
Number of MQGET with wait requests MQGTGETWAIT The total number of times the MQGET command was issued with the MQGMO_WAIT option.
Number of MQINQ requests MQGTINQ The total number of times the MQINQ command was issued.
Number of MQINQMP requests MQGTINQMP The total number of times the MQINQMP command was issued.
Number of MQMHBUF requests MQGTMHBUF The total number of times the MQMHBUF command was issued.
Number of MQOPEN requests MQGTOPEN The total number of times the MQOPEN command was issued.
Number of MQPUT requests MQGTPUT The total number of times the MQPUT command was issued.
Number of MQPUT1 requests MQGTPUT1 The total number of times the MQPUT1 command was issued.
Number of MQSET requests MQGTSET The total number of times the MQSET command was issued.
Number of MQSETMP requests MQGTSETMP The total number of times the MQSETMP command was issued.
Number of single phase commit operations MQGTSPCOMM The total number of single phase commits for UOWs on the connection.
Number of MQSTAT requests MQGTSTAT The total number of times the MQSTAT command was issued.
Number of MQSUB requests MQGTSUB The total number of times the MQSUB command was issued.
Number of MQSUBRQ requests MQGTSUBRQ The total number of times the MQSUBRQ command was issued.
Number of WebSphere MQ calls that had a TCB switch MQGTSUBTASK The total number of WebSphere MQ API calls that involved a TCB switch.
Number of completed tasks MQGTTASKEND The total number of tasks on the connection.
Number of MQGET with wait requests that waited MQGTWAITMSG The total number of times the MQGET command was issued with the MQGMO_WAIT option, and the request waited.
Number of unresolved units of work MQGUNRESUOW The number of UOWs that were indoubt at startup of the WebSphere MQ adapter, and could not be resolved because the CICS system was subject to a cold start.
WebSphere MQ queue manager or QSG name MQNAME The name of the WebSphere MQ queue manager or queue sharing group.
Connected Queue Manager name MQQMGR The name of the connected WebSphere MQ queue manager.
WebSphere MQ Release MQRELEASE The release of the WebSphere MQ queue manager.
WebSphere MQ connection name NAME WebSphere MQ connection name
Resynchronization member RESYNCMEMBER This applies only if you are using group attach, and specifies the strategy that CICS adopts if outstanding units of work are being held for the last WebSphere MQ queue sharing group (QSG) member to which CICS was connected.

Units of work which are shunted indoubt are not included in this process, because CICS is unable to resolve those units of work at this time. Resynchronization for those UOWs will occur when CICS has resynchronized with its remote coordinator. CVDA values are:

  • RESYNC - CICS connects to the same WebSphere MQ QSG member.
  • NORESYNC - CICS makes one attempt to connect to the same WebSphere MQ QSG member, and if that attempt fails, CICS connects to any member of the WebSphere MQ QSG and issues a warning about the outstanding units of work.
  • GROUPRESYNC - CICS connects to any member of the queue-sharing group. The queue-manager will be chosen by WebSphere MQ and it will ask 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 (group UR). This option can only be used when running a release of WebSphere MQ that supports group UR for CICS and when group UR has been enabled in the queue managers.
  • NOTAPPLIC - Connection is not using group attach.
Number of current tasks TASKS The number of current tasks that have issued a WebSphere MQ call. This includes CICS MQMonitor tasks.
Number of current CICS MQMonitor tasks TRIGMONTASKS The number of CICS MQMonitor tasks currently using the CICS-MQ interface.