Updates that apply to IMS Queue Control Facility User's Guide (SC19-4005-05)
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
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|
- 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:
To share these data sets among a single IMS subsystem on all MVS systems, specify their names as follows:
To share these data sets among all IMS subsystems on all MVS systems, specify their names as follows:
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:
- Start the TSO client. The IMS Queue Control Facility Main Menu panel is displayed.
- Select Preferences.
- Select option 1 (Change QCF session preferences).
- Select N for Include MVSNAME in DSNames, Include IMSID in DSNames, or both. The default is Y for either field.
The figure titled "Update Defaults (IQCP34V) dialog box" (Figure 23 in PDF) has been replaced.
Figure 4. Update Defaults (IQCP34V) dialog box
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 ----------
Original Publication Date
02 December 2014
15 November 2020