Task 10: Set up the coupling facility

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

  • Repeat this task for each queue-sharing group.
  • You might need to perform this task when migrating from a previous version.
  • Omit this task if you 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.
    You can use only alphabetic and numeric characters in the names of structures used to hold messages for shared queues, you 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.

When you have defined your structures successfully, activate the CFRM policy that is being used. To do this, issue the following z/OS® command:

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

See the Defining coupling facility resources for information about planning CF structures and their sizes.