To Associate an MQ XA Resource with a CICS Region Startup File

If transactions invoke MQ APIs, an MQ XA resource definition must be associated with the region to enable CICS to connect to the required MQ queue manager to which the APIs will be targeted. An MQ XA resource definition can be associated with a region at either the SIT or region startup file level. When specified in both the SIT and region start-up file, the region startup file takes precedence. To associate an MQ XA resource definition with a region startup file:

  1. Open the region startup file using the Enterprise Server for .NET Administration UI's Region Startup File Editor
  2. Select the Region node in the Results pane.

    A properties window is now displayed to the right-hand side of the Results pane.

  3. Locate the MQ category in the properties window and enter the MQ XA resource definition name that you want associated with the region as the value of the MQ XA resource name property.
  4. Choose File > Save , or click the Save icon in the toolbar to save the file.

You must cold-start the region for the changes to take effect.