Task 10: Set up the Coupling Facility
- Repeat this task for each queue-sharing group.
- You might need to perform this task when migrating from a previous version.For details, see 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, see Set up a new queue-sharing group.
You need to 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.
All the structures for the queue-sharing group start with the name of the queue-sharing group. You must have:
- An administrative structure called qsg-nameCSQ_ADMIN. This structure is used by WebSphere MQ itself and does not contain any user data.
- 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.
When you have defined your structures successfully, activate the CFRM policy that is being used. To do this, issue the following z/OS command: