Preparing to customize queue managers on z/OS

Preparing to customize queue managers on z/OS

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 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). The Program Directories for IBM MQ for z/OS can be downloaded from the IBM Publications Center (see IBM MQ Version 9.0 PDF documentation).
When we have installed IBM MQ, you must carry out a number of tasks before we can make it available to users. See the following sections for a description of these tasks:

Set up IBM MQ for z/OS
Testing a queue manager on z/OS
Set up security on z/OS

If you are migrating from a previous version of IBM MQ for z/OS, we do not need to perform most of the customization tasks. See Maintain and migrate 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. We 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.

IBM MQ for z/OS Unix System Services Web Components

This feature is optional.
Select this feature if you want to use the IBM MQ Console, or the REST API.

You must install the IBM MQ for z/OS Unix System Services Components feature, to install this feature.

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 we 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.

Parent topic: Configure queue managers on z/OS

Related concepts

Set up communications with other queue managers
Use IBM MQ with IMS
Use IBM MQ with CICS
Use OTMA exits in IMS

Related reference

Upgrading and applying service to Language Environment or z/OS Callable Services

Related information

IBM MQ for z/OS concepts
Administer IBM MQ for z/OS

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.