Preparing to customize your IBM MQ for z/OS queue managers

Use this topic when customizing your queue managers with details of installable features, national language features, and information about testing, and setting up security.

Preparing for customization

The Program Directory for WebSphere® MQ for z/OS® lists the contents of the IBM® MQ installation tape, the program and service level information for IBM MQ, and describes how to install IBM MQ for z/OS using the System Modification Program Extended (SMP/E). For download links for the Program Directories, see IBM MQ for z/OS Program Directory PDF files.

When you have installed IBM MQ, you must carry out a number of tasks before you can make it available to users. See the following sections for a description of these tasks:

If you are migrating from a previous version of IBM MQ for z/OS, you do not need to perform most of the customization tasks. See Migrating and upgrading IBM MQ for more information about the tasks you must perform.

Installable features of IBM MQ for z/OS
IBM MQ for z/OS comprises the following features:
Base
This is required; it comprises all the main functions, including
  • Administration and utilities
  • Support for CICS®, IMS, and batch type applications using the IBM MQ Application Programming Interface, or C++
  • Distributed queuing facility (supporting both TCP/IP and APPC communications)
National language features
These contain error messages and panels in all the supported national languages. Each language has a language letter associated with it. The languages and letters are:
C
Simplified Chinese
E
U.S. English (mixed case)
F
French
K
Japanese
U
U.S. English (uppercase)

You must install the US English (mixed case) option. You can also install one or more other languages. (The installation process for other languages requires US English (mixed case) to be installed, even if you are not going to use US English (mixed case).)

IBM MQ for z/OS Unix System Services Components
This feature is optional. Select this feature if you want to build and run Java applications that use the Java Message Service (JMS) to connect to IBM MQ for z/OS or if you want to build and run HTTP applications which use HTTP to connect to IBM MQ for z/OS.
Libraries that exist after installation
IBM MQ is supplied with a number of separate load libraries. Table 1 shows the libraries that might exist after you have installed IBM MQ.
Table 1. IBM MQ libraries that exist after installation
Name Description
thlqual.SCSQANLC Contains the load modules for the Simplified Chinese version of IBM MQ.
thlqual.SCSQANLE Contains the load modules for the U.S. English (mixed case) version of IBM MQ.
thlqual.SCSQANLF Contains the load modules for the French version of IBM MQ.
thlqual.SCSQANLK Contains the load modules for the Japanese version of IBM MQ.
thlqual.SCSQANLU Contains the load modules for the U.S. English (uppercase) version of IBM MQ.
thlqual.SCSQASMS Contains source for assembler sample programs.
thlqual.SCSQAUTH The main repository for all IBM MQ product load modules; it also contains the default parameter module, CSQZPARM. This library must be APF-authorized and in PDS-E format.
thlqual.SCSQCICS Contains extra load modules that must be included in the CICS DFHRPL concatenation. This library must be APF-authorized and in PDS-E format.
thlqual.SCSQCLST Contains CLISTs used by the sample programs.
thlqual.SCSQCOBC Contains COBOL copybooks, including copybooks required for the sample programs.
thlqual.SCSQCOBS Contains source for COBOL sample programs.
thlqual.SCSQCPPS Contains source for C++ sample programs.
thlqual.SCSQC37S Contains source for C sample programs.
thlqual.SCSQC370 Contains C headers, including headers required for the sample programs.
thlqual.SCSQDEFS Contains side definitions for C++ and the Db2® DBRMs for shared queuing.
thlqual.SCSQEXEC Contains REXX executable files to be included in the SYSEXEC or SYSPROC concatenation if you are using the IBM MQ operations and control panels.
thlqual.SCSQHPPS Contains header files for C++.
thlqual.SCSQINST Contains JCL for installation jobs.
thlqual.SCSQLINK Early code library. Contains the load modules that are loaded at system initial program load (IPL). The library must be APF-authorized.
thlqual.SCSQLOAD Load library. Contains load modules for non-APF code, user exits, utilities, samples, installation verification programs, and adapter stubs. The library does not need to be APF-authorized and does not need to be in the link list. This library must be in PDS-E format.
thlqual.SCSQMACS Contains Assembler macros including: sample macros, product macros, and system parameter macros.
thlqual.SCSQMAPS Contains CICS mapsets used by sample programs.
thlqual.SCSQMSGC Contains ISPF messages to be included in the ISPMLIB concatenation if you are using the Simplified Chinese language feature for the IBM MQ operations and control panels.
thlqual.SCSQMSGE Contains ISPF messages to be included in the ISPMLIB concatenation if you are using the U.S. English (mixed case) language feature for the IBM MQ operations and control panels.
thlqual.SCSQMSGF Contains ISPF messages to be included in the ISPMLIB concatenation if you are using the French language feature for the IBM MQ operations and control panels.
thlqual.SCSQMSGK Contains ISPF messages to be included in the ISPMLIB concatenation if you are using the Japanese language feature for the IBM MQ operations and control panels.
thlqual.SCSQMSGU Contains ISPF messages to be included in the ISPMLIB concatenation if you are using the U.S. English (uppercase) language feature for the IBM MQ operations and control panels.
thlqual.SCSQMVR1 Contains the load modules for distributed queuing. This library must be APF-authorized and in PDS-E format.
thlqual.SCSQPLIC Contains PL/I include files.
thlqual.SCSQPLIS Contains source for PL/I sample programs.
thlqual.SCSQPNLA Contains IPCS panels, for the dump formatter, to be included in the ISPPLIB concatenation. Also contains panels for IBM MQ sample programs.
thlqual.SCSQPNLC Contains ISPF panels to be included in the ISPPLIB concatenation if you are using the Simplified Chinese language feature for the IBM MQ operations and control panels.
thlqual.SCSQPNLE Contains ISPF panels to be included in the ISPPLIB concatenation if you are using the U.S. English (mixed case) language feature for the IBM MQ operations and control panels.
thlqual.SCSQPNLF Contains ISPF panels to be included in the ISPPLIB concatenation if you are using the French language feature for the IBM MQ operations and control panels.
thlqual.SCSQPNLK Contains ISPF panels to be included in the ISPPLIB concatenation if you are using the Japanese language feature for the IBM MQ operations and control panels.
thlqual.SCSQPNLU Contains ISPF panels to be included in the ISPPLIB concatenation if you are using the U.S. English (uppercase) language feature for the IBM MQ operations and control panels.
thlqual.SCSQPROC Contains sample JCL and default system initialization data sets.
thlqual.SCSQSNLC Contains the load modules for the Simplified Chinese versions of the IBM MQ modules that are required for special purpose function (for example the early code).
thlqual.SCSQSNLE Contains the load modules for the U.S. English (mixed case) versions of the IBM MQ modules that are required for special purpose function (for example the early code).
thlqual.SCSQSNLF Contains the load modules for the French versions of the IBM MQ modules that are required for special purpose function (for example the early code).
thlqual.SCSQSNLK Contains the load modules for the Japanese versions of the IBM MQ modules that are required for special purpose function (for example the early code).
thlqual.SCSQSNLU Contains the load modules for the U.S. English (uppercase) versions of the IBM MQ modules that are required for special purpose function (for example the early code).
thlqual.SCSQTBLC Contains ISPF tables to be included in the ISPTLIB concatenation if you are using the Simplified Chinese language feature for the IBM MQ operations and control panels.
thlqual.SCSQTBLE Contains ISPF tables to be included in the ISPTLIB concatenation if you are using the U.S. English (mixed case) language feature for the IBM MQ operations and control panels.
thlqual.SCSQTBLF Contains ISPF tables to be included in the ISPTLIB concatenation if you are using the French language feature for the IBM MQ operations and control panels.
thlqual.SCSQTBLK Contains ISPF tables to be included in the ISPTLIB concatenation if you are using the Japanese language feature for the IBM MQ operations and control panels.
thlqual.SCSQTBLU Contains ISPF tables to be included in the ISPTLIB concatenation if you are using the U.S. English (uppercase) language feature for the IBM MQ operations and control panels.
Note: Do not modify or customize any of these libraries. If you want to make changes, copy the libraries and make your changes to the copies.