Task 14: Create the bootstrap and log data sets
Use the supplied program CSQJU003 to prepare the bootstrap data sets (BSDSs) and log data sets.
- Repeat this task for each IBM® MQ queue manager.
- You do not need to perform this task when migrating from a previous version.
The sample JCL and Access Method Services (AMS) control statements to run CSQJU003 to create a single or dual logging environment are held in thlqual.SCSQPROC(CSQ4BSDS). Customize and run this job to create your BSDSs and logs and to preformat the logs.
Important: You should use the newest version of CSQ4BSDS, or update your JCL manually to use RECORDS(850 60).
The started task procedure, CSQ4MSTR, described in Task 6: Create procedures for the IBM MQ queue manager, refers to BSDSs in statements of the form:
//BSDS1 DD DSN=++HLQ++.BSDS01,DISP=SHR
//BSDS2 DD DSN=++HLQ++.BSDS02,DISP=SHR
The log data sets are referred to by the BSDSs.
Note:
- The BLKSIZE must be specified on the SYSPRINT DD statement in the LOGDEF step. The BLKSIZE must be 629.
- To help identify bootstrap data sets and log data sets from different queue managers, include the subsystem name in the high level qualifier of these data sets.
- If you are using queue-sharing groups, you must define the bootstrap and log data sets with SHAREOPTIONS(2 3).
See Planning on z/OS® for information about planning bootstrap and log data sets and their sizes.
For IBM MQ 8.0, the 8 byte log RBA enhancement improves the availability of a queue manager, as described in Larger log Relative Byte Address. To enable 8 byte log RBA on a queue manager before the queue manager is first started, perform the following steps after creating your logging environment.
- Using IDCAMS
ALTER, rename the version 1 format BSDSs (created using the CSQJU003 program)
to something like
++HLQ++.V1.BSDS01
.Note: Ensure that you rename the data and index components as well as the VSAM cluster. - Allocate new BSDSs with the same attributes as the ones already defined. These will become the version 2 format BSDSs that will be used by the queue manager when it is started.
- Run the BSDS conversion utility (CSQJUCNV) to convert the version 1 format BSDSs to the new version 2 format BSDSs.
- Once the conversion completes successfully, delete the version 1 format BSDSs.
- In order to use 8 byte log RBA, ensure that Version 8.0 new functions are enabled with OPMODE as described in Task 17: Tailor your system parameter module.
Note: If the queue manager is in a queue-sharing group, all queue managers in the queue-sharing group must have been started with OPMODE(NEWFUNC,800) before 8 byte log RBA can be enabled.