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

Start of change

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.
End of change
----------------------------------------------------------------------------------------------------
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

Start of change
 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                                                          
 ----------                                                             
End of change

Publication Number

SC19-4005-05

Original Publication Date

02 December 2014

Document Location

Worldwide

[{"Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSAVJB","label":"IMS Queue Control Facility for z\/OS"},"ARM Category":[{"code":"a8m0z000000cvZTAAY","label":"IMS Queue Control Facility for z\/OS"}],"Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"3.2.0"},{"Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SS5ELV","label":"IBM IMS Transaction Manager Solution Pack for z\/OS"},"ARM Category":[{"code":"a8m0z000000cvZdAAI","label":"IMS Transaction Manager Solution Pack for z\/OS"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.1.0"}]

Document Information

Modified date:
15 November 2020

UID

ibm10883924