Customizing IBM MQ for z/OS

Use this topic as a step by step guide for customizing your IBM® MQ system.

This topic leads you through the various stages of customizing IBM MQ after you have successfully installed it. The installation process is described in the Program Directory, available to download from the IBM Publications Center.

Samples are supplied with IBM MQ to help you with your customization. The sample data set members have names beginning with the four characters CSQ4 and are in the library thlqual.SCSQPROC.

Before you perform the customization tasks described in this topic, there are a number of configuration options that you must consider because they affect the performance and resource requirements of IBM MQ for z/OS®. For example, you must decide which globalization libraries you want to use.

Configuration options

For more information about these options, see Planning on z/OS.

The description of each task in this section indicates whether:
  • The task is part of the process of customizing IBM MQ. That is, you perform the task once when you customize IBM MQ on the z/OS system. (In a parallel sysplex, you must perform the task for each z/OS system in the sysplex, and ensure that each z/OS system is set up identically.)
  • The task is part of adding a queue manager. That is, you perform the task once for each queue manager when you add that queue manager.
  • You need to perform the task when migrating. If you are migrating from a previous version of IBM MQ for z/OS, you might not need to perform all these tasks.
Review the tasks when you apply corrective maintenance to IBM MQ and when you install a new version or release of IBM MQ.

None of the tasks require you to perform an IPL of your z/OS system, if you use commands to change the various z/OS system parameters, and perform Task 12: Update SYS1.PARMLIB members as suggested.

To simplify operations and to aid with problem determination, ensure that all z/OS systems in a sysplex are set up identically, so that queue managers can be quickly created on any system in an emergency.

For ease of maintenance, consider defining aliases to refer to your IBM MQ libraries; for more information, see Using an alias to refer to an IBM MQ library.

Identify the national language support libraries

You need to specify the appropriate globalization libraries in the JCL that you want to use with IBM MQ (as described in the following sections). Each language is identified by a language letter:
C
Simplified Chinese
E
U.S. English (mixed case)
F
French
K
Japanese
U
U.S. English (uppercase)
Table 1. National language feature libraries
Description Japanese Simplified Chinese U.S. English (mixed case) U.S. English (uppercase) French
Load modules thlqual.SCSQANLK thlqual.SCSQANLC thlqual.SCSQANLE thlqual.SCSQANLU thlqual.SCSQANLF
ISPF messages thlqual.SCSQMSGK thlqual.SCSQMSGC thlqual.SCSQMSGE thlqual.SCSQMSGU thlqual.SCSQMSGF
ISPF panels thlqual.SCSQPNLK thlqual.SCSQPNLC thlqual.SCSQPNLE thlqual.SCSQPNLU thlqual.SCSQPNLF
Special purpose function (for example, early code) thlqual.SCSQSNLK thlqual.SCSQSNLC thlqual.SCSQSNLE thlqual.SCSQSNLU thlqual.SCSQSNLF
ISPF tables thlqual.SCSQTBLK thlqual.SCSQTBLC thlqual.SCSQTBLE thlqual.SCSQTBLU thlqual.SCSQTBLF

Customization summary

The following table lists all the steps required to customize IBM MQ for z/OS. It also indicates the following:
  • Whether the step has to be performed once only, or repeated for each queue manager.
  • Whether you need to repeat the step for each queue-sharing group, or omit the step if you are not using queue-sharing groups.
  • Whether the step is required if you are migrating from a previous version of IBM MQ. Some steps might be needed, depending on what you decide about data set and queue manager names; these steps are marked 'Review'.
Table 2. Customization summary
Task Required when migrating Repeat for each queue manager Queue-sharing groups
Task 1: Identify the z/OS system parameters Review - -
Task 2: APF authorize the IBM MQ load libraries Review - -
Task 3: Update the z/OS link list and LPA Review - -
Task 4: Update the z/OS program properties table - - -
Task 5: Define the IBM MQ subsystem to z/OS - X -
Task 6: Create procedures for the IBM MQ queue manager Review X -
Task 7: Create procedures for the channel initiator Review X -
Task 8: Define the IBM MQ subsystem to a z/OS WLM service class - X -
Task 9: Set up the Db2 environment Review - Omit if not used
Task 10: Set up the coupling facility Review - Repeat for each
Task 11: Implement your ESM security controls Review X X
Task 12: Update SYS1.PARMLIB members Review - -
Task 13: Customize the initialization input data sets X X -
Task 14: Create the bootstrap and log data sets - X -
Task 15: Define your page sets - X -
Task 16: Add the IBM MQ entries to the Db2 tables Review X Repeat for each
Task 17: Tailor your system parameter module X X -
Task 18: Tailor the channel initiator parameters X X -
Task 19: Set up Batch, TSO, and RRS adapters Review - -
Task 20: Set up the operations and control panels Review - -
Task 21: Include the IBM MQ dump formatting member X - -
Task 22: Suppress information messages - - -
Task 23: Create procedures for Advanced Message Security Review X -
Task 24: Set up the started task user Advanced Message Security Review X -
Task 25: Grant RACDCERT permissions to the security administrator for Advanced Message Security - - -
Task 26: Grant users resource permissions for IBM MQ Advanced Message Security - - -