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 System Modification Program Extended (SMP/E). Program Directories can be downloaded from the IBM Publications Center (see IBM MQ for z/OS Program Directory PDF files).

When you have installed IBM MQ, we 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:

If we 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)

      We 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 we 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 we want to build and run Java applications that use the Java Message Service (JMS) 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 we want to use the IBM MQ Console, or the REST API.

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

    IBM MQ for z/OS Managed File Transfer
    This feature is optional, and should only be installed if you have entitlement for IBM MQ Advanced for z/OS, IBM MQ for z/OS Value Unit Edition (VUE), or IBM MQ for z/OS Managed File Transfer.

    Select this feature if we want to use the Managed File Transfer capabilities of IBM MQ for z/OS.

    We 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 you have installed IBM MQ.

    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 we are using the IBM MQ operations and control panels.
    thlqual.SCSQFCMD Contains templates for jobs to create and run Managed File Transfer tasks.
    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. To make changes, copy the libraries and make your changes to the copies.

Parent topic: Configure queue managers on z/OS


Related concepts


Related reference


Related information