Set up the coupling facility

If we are using queue sharing groups, define the coupling facility structures used by the queue managers in the queue sharing group (QSG) in the coupling facility Resource Management (CFRM) policy data set, using IXCMIAPU.

• Repeat this task for each queue sharing group.
• We might need to perform this task when migrating from a previous version.
• Omit this task if we are not using queue sharing groups.

  If you later want to use queue sharing groups, perform this task at that time.

All the structures for the queue sharing group start with the name of the queue sharing group. Define the following structures:

• An administrative structure called qsg-name CSQ_ADMIN. This structure is used by IBM MQ itself and does not contain any user data.
• A system application structure called qsg-name CSQSYSAPPL. This structure is used by IBM MQ system queues to store state information.
• One or more structures used to hold messages for shared queues. These can have any name you choose up to 16 characters long.
  • The first four characters must be the queue sharing group name. (If the queue sharing group name is less than four characters long, it must be padded to four characters with @ symbols.)
  • The fifth character must be alphabetic and subsequent characters can be alphabetic or numeric. This part of the name (without the queue sharing group name) is what you specify for the CFSTRUCT name when you define a shared queue, or a CF structure object.

  We can use only alphabetic and numeric characters in the names of structures used to hold messages for shared queues, we cannot use any other characters (for example, the _ character, which is used in the name of the administrative structure).

Sample control statements for IXCMIAPU are in data set thlqual.SCSQPROC(CSQ4CFRM). Customize these and add them to your IXCMIAPU job for the coupling facility and run it.

SETXCF START,POLICY,TYPE=CFRM,POLNAME= policy-name

For information about planning CF structures and their sizes, see Defining coupling facility resources.

Related concepts

• Implement your ESM security controls