WebSphere MQ connection definitions - MQCONDEF

The WebSphere MQ Connection definition (MQCONDEF) views display information about connections between CICS and WebSphere MQ. An MQCONN resource definition defines the attributes of the connection between CICS and WebSphere MQ. A CICS region can have only one MQCONN resource definition. When you install an MQCONN resource definition that specifies the name of a default initiation queue, CICS also installs an implicit MQINI resource definition.

Supplied views

To access from the main menu, click:

Administration views > CICS resource definitions > WebSphere MQ connection definitions

Table 1. Views in the supplied WebSphere MQ Connection definitions (MQCONDEF) view set
View Notes
WebSphere MQ Connection definitions

EYUSTARTMQCONDEF.ADDTOGRP

 Add one or more WebSphere MQ Connection definitions to a resource group.
WebSphere MQ Connection definitions

EYUSTARTMQCONDEF.CREATE

 Create a WebSphere MQ Connection definition and add it to the data repository.
WebSphere MQ Connection definitions

EYUSTARTMQCONDEF.DETAILED

 Detailed information about a selected WebSphere MQ Connection definition.
WebSphere MQ Connection definitions

EYUSTARTMQCONDEF.INSTALL

 Install a WebSphere MQ Connection definition in an active system.
WebSphere MQ Connection definitions

EYUSTARTMQCONDEF.REMOVE

 Remove a WebSphere MQ Connection definition from the data repository.
WebSphere MQ Connection definitions

EYUSTARTMQCONDEF.TABULAR

 Tabular information about all WebSphere MQ Connection definitions for the current context.

Actions

Table 2. Actions available for MQCONDEF views
Action Description
ADDTOGRP Add one or more WebSphere MQ Connection definitions to a resource group.
CREATE Create a WebSphere MQ Connection definition and add it to the data repository.
CSDCOPY Copy a CICS CSD resource definition.
CSDINSTALL Install a CICS CSD resource definition into an active system.
INSTALL Install a WebSphere MQ Connection definition in an active system.
REMOVE Remove a WebSphere MQ Connection definition from the data repository.
UPDATE Update an WebSphere MQ Connection definition in the data repository.

Fields

Table 3. Fields in MQCONDEF views
Field Attribute name Description
Last modification agent CHANGEAGENT The change agent identifier that made the last modification.
  • DREPAPI - Resource was last changed by a CICSPlex SM API command.
Last modification agent release CHANGEAGREL The CICS release level of the agent that made the last modification.
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.
Time created CREATETIME The local date and time when the definition was created.
CSD group CSDGROUP The name of the CSD group for this CICS resource definition. This field is ignored for BAS definitions.
Version DEFVER The version number of the BAS resource definition, from 1 to 15. This field is ignored for CICS CSD resource definitions.
Description code page DESCCODEPAGE The code page of the description field. This field is ignored for CICS CSD resource definitions.
Description DESCRIPTION A description of the MQCONN definition.
MQ initiation queue name INITQNAME The 1-48 character name of the default initiation queue for this CICS-MQ connection.
MQ queue manager or QSG name MQNAME Specifies the 1-4 character name of either a single WebSphere MQ queue manager, or a queue-sharing group of WebSphere MQ queue managers.
Name NAME The 8-character name of the WebSphere MQ Connection resource.
Resynchronization Member RESYNCMEMBER This attribute applies only if you have used the MQNAME attribute to specify a WebSphere MQ queue-sharing group. 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.
  • YES
    • CICS connects to the same queue manager, waiting, if necessary, until the queue manager becomes active to resolve the indoubt units of work. This is the default.
  • NO
    • 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 the warning message DFHMQ2064 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.
User data area 1 USERDATA1 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 2 USERDATA2 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 3 USERDATA3 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.