IBM Support

Updates to IMS Queue Control Facility User's Guide (SC19-4005-05)

Product Documentation


Abstract

Updates that apply to IMS Queue Control Facility User's Guide (SC19-4005-05)

Content

Update 1

Date of change: May 2019

Change description: Documentation changes for APAR PI87887.

Topics: Changes apply to multiple topics.

----------------------------------------------------------------------------------------------------

Topic: Configuring IMS Queue Control Facility > Setting up IMS Queue Control Facility > 2. Creating configuration members for message processing

The subsection titled "Allocating data sets for message processing" has been updated as follows.


Allocating data sets for message processing

image-20181126113638-1

Allocate three partitioned data sets for the following parameters:

  • Queue overflow protection data set - QSUN notification parameters
  • Commit data set - QSN committed message processing parameters
  • Uncommit data set - QSN uncommitted message processing parameters

You can customize sample JCL IQCSTRTJ in hlqual.SIQCSAMP to create these data sets and put the supplied sample members in the overflow protection data sets.

Member IQC#####, which is located in hlqual.SIQCSAMP, lists all samples, ordered by their functionality.

Specify DCB RECFM=FB and LRECL=80 (follow local standards).

Unless you specify otherwise, as described later in this section, the IMS Queue Control Facility assumes that there are separate data sets for each IMS on each MVS system.

If you allocate separate data sets for each IMS on each MVS system, the naming convention of these data sets is as follows:

Data set Naming convention Example
Queue overflow protection data set ovflhlq.mvsname.imsid.NOTPARMS IQC.MVS1.IMSA.NOTPARMS
Commit data set ovflhlq.mvsname.imsid.COMMIT IQC.MVS1.IMSA.COMMIT
Uncommit data set ovflhlq.mvsname.imsid.UNCOMMIT IQC.MVS1.IMSA.UNCOMMIT

Where,

  • ovflhlq can be up to 25 characters long. The default is IQC.
  • mvsname is the MVS system name.
  • imsid is the name of the IMS control region.

If your MVS system is named such that the name would cause an invalid data set name to be created, the following rules apply:

  • If the MVS system name is less than 8 characters, an S will be added to the beginning portion of the data set name that contains the MVS system name.

    For example, if your MVS system name is 123456, and your IMSID is IMSA, the commit data set must be named IQC.S123456.IMSA.COMMIT.

  • If the MVS system name is 8 characters, an S will be added to the beginning of the first 7 characters of the MVS system name and an additional qualifier, beginning with an S followed by the 8th character, will be created.

    For example, if your MVS system name is 7654321@ and your IMSID is IMSB, the commit data set must be named IQC.S7654321.S@.IMSB.UNCOMMIT.

You can also define these three data sets in a way that they are shared among 1) all IMS subsystems on a given MVS system, 2) one IMS subsystem on all MVS systems, or 3) all IMS subsystems on all MVS systems. In these cases, the following naming rules apply:

  • If you want the IMS Queue Control Facility to share the data sets among all IMS subsystems, omit imsid as the middle-level qualifiers of the data sets names.
  • If you want the IMS Queue Control Facility to share the data sets among all MVS systems, omit mvsname as the middle-level qualifiers of the data sets names.

To share these data sets among all IMS subsystems on a given MVS system, specify their names as follows:

  • ovflhlq.mvsname.NOTPARMS
  • ovflhlq.mvsname.COMMIT
  • ovflhlq.mvsname.UNCOMMIT

To share these data sets among a single IMS subsystem on all MVS systems, specify their names as follows:

  • ovflhlq.imsid.NOTPARMS
  • ovflhlq.imsid.COMMIT
  • ovflhlq.imsid.UNCOMMIT

To share these data sets among all IMS subsystems on all MVS systems, specify their names as follows:

  • ovflhlq.NOTPARMS
  • ovflhlq.COMMIT
  • ovflhlq.UNCOMMIT

To use these data sets, create and populate them with ovflhlq, as set in the REXX program for starting the TSO client (sample: hlq.SIQCCEXE(IQC31)), with or without mvsname and imsid as the middle-level qualifier, and suffix NOTPARMS, COMMIT, or UNCOMMIT.

If these data sets are to be shared among IMS subsystems or MVS systems, follow these additional steps:

  1. Start the TSO client. The IMS Queue Control Facility Main Menu panel is displayed.
  2. Select Preferences.
  3. Select option 1 (Change QCF session preferences).
  4. Select N for Include MVSNAME in DSNames, Include IMSID in DSNames, or both. The default is Y for either field.
image-20181126113652-2
----------------------------------------------------------------------------------------------------
Topic: Using IMS Queue Control Facility > Using the TSO client (ISPF user interface) > > IMS Queue Control Facility main menu panel

 

The figure titled "Update Defaults (IQCP34V) dialog box" (Figure 23 in PDF) has been replaced.

Figure 4. Update Defaults (IQCP34V) dialog box

image-20181126113638-1
______________________________________________________________________________
| IQCP34V                      Update Defaults                                |
| Command ===>                                             Scroll ===> PAGE   |
|                                                                             |
| Press END to save updates                                                   |
|                                           APAR . . : PI87887 2018/12/       |
|  QCF Product Default Preferences                                            |
|                                                                             |
| Edit QCF            Display GMT as      Include MVSID in    Include IMSID   |
| generated stmts     local time          DSNames             in DSNames      |
| Y  (Default = Y)    N  (Default = N)    Y  (Default = Y)    Y  (Default =   |
|                                                                Y)           |
|                                                                             |
| Maximum Number of messages to be added to the display at one time:          |
| 03000  (Numeric value 00005 to 99999, default is 03000)                     |
|                                                                             |
|  Permanent msg UNLOAD work data set high lvl qualifier or blank             |
|                                                                             |
|  Permanent SCRAPLOG work data set high level qualifier or blank             |
|                                                                             |
|                                                                             |
| Plex Names   PLEX1                                                          |
| ----------                                                                  |
|                                                                             |
_______________________________________________________________________________
image-20181126113652-2

Publication Number

SC19-4005-05

Copyright Date

2000, 2018

Original Publication Date

2014-12-02


Cross reference information
Product Component Platform Version Edition
IMS Tools IMS System Management for z/OS z/OS 1.1.0 SC19-4005-05
IMS Tools IMS Transaction Manager Solution Pack for z/OS z/OS 1.1.0 SC19-4005-05

Document information

More support for: IMS Tools

Component: IMS Queue Control Facility

Software version: 3.2.0

Operating system(s): z/OS

Software edition: SC19-4005-05

Reference #: 0883924

Modified date: 10 May 2019