PI95128: GDG DATASET LIMIT IS 8 FOR THE BASE PARTITION, BUT THE LIMIT IS SET TO 20 FOR NEW PARTITIONS.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• 1. "IHC01000I GDGCRE(Y) set" is shown in MAINTAIN, but the
  parameter GDGCRE not found in HALDB Toolkit User's Guide.
  2. GDG dataset limit is 8 for the base partition, but the limit
  is set to 20 for new partitions.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IBM IMS Database Solution Pack V2.1 *
  *                 IMS HALDB Toolkit.                           *
  ****************************************************************
  * PROBLEM DESCRIPTION: 1. IHC01000I GDGCRE(Y) set is shown in  *
  *                         MAINTAIN, but the parameter GDGCRE   *
  *                         not found in HALDB Toolkit User's    *
  *                         Guide.                               *
  *                      2. GDG dataset limit is 8 for the base  *
  *                         partition, but the limit is set to   *
  *                         20 for new partitions.               *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  1. The GDGCRE parameter is internally used when ICTRLR(1) is
     specified. It cannot be specified in IHCSYSIN DD. The message
     is unwanted.
  2. GDGLIMIT=8 is specified in HPIC's site default table. The
     existing GDG base is defined by HPIC using GDGLIMIT=8.
     However, the new one is defined by HALDB Toolkit Maintain
     using GDGLIMIT=20. When a new GDG base is defined, the fixed
     value of 20 is used for the GDG dataset limit. The GDGLIMIT
     parameter cannot be specified as a Maintain command
     parameter.
  

Problem conclusion

• This APAR modifies the program so that IHC01000I GDGCRE(Y) set
  is not issued and the GDGLIMIT is added as a Maintain command
  parameter.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IBM IMS Database Solution Pack for z/OS Version 2 Release 1
  IMS High Availability Large Database Toolkit for z/OS User's
  Guide (SC19-4102-02)
  ----------------------------------------------------------------
  Chapter 3. Converting to HALDB using CONVERT
  CONVERT command parameters
   GDGLIMIT parameter has been added as follows:
  
    Parameter   Requirement   Description
    --------------------------------------------------------------
  | GDGLIMIT    Optional      Specifies the maximum number of GDG
  |                           (generation data group) data sets
  |                           that can be associated with the GDG.
  |                           This value is used only when the GDG
  |                           base does not exist and a GDG is
  |                           created during the job, IMS HALDB
  |                           Toolkit uses the value specified for
  |                           this parameter when a GDG is
  |                           requested for image copy data sets.
  |                           If you specify one of the following
  |                           parameters, the existence of a GDG
  |                           base is verified before the image
  |                           copy data set is allocated:
  |                           - ICTRLR(1) to request that image
  |                             copy data sets are GDGs
  |                           - &GDG is specified on the IC1DSN or
  |                             IC2DSN parameter to request that
  |                             image copy data sets are GDGs
  |                           If a GDG base does not exist, IMS
  |                           HALDB Toolkit automatically defines
  |                           one using the GDGLIMIT parameter
  |                           value to control the number of
  |                           generations to keep.
  |
  |                           Format: (1 - 255)
  |                           Default value: 20
  
   IC1DSN parameter has been updated as follows:
  
    &JOBNAME
     Name of this job.
      :
    &TIME2
     This variable is substituted as Thhmm.
  | &GDG
  |  The identifier for the GDG data set.
  |  If specified, &GDG must be the last value on the IC1DSN
  |  parameter.
    where:
    - yyyy is the 4-digit year
  
  Chapter 4. Maintaining HALDB using MAINTAIN
  MAINTAIN command parameters
   GDGLIMIT parameter has been added and IC1DSN parameter has been
   updated. These fixes are the same as CONVERT command
   parameters.
  
  Chapter 29. Messages and codes
  Batch messages
   The following new message has been added:
  | IHC01206I A GDG base entry is being created. NAME: GDG_base,
  |           LIMIT: nnn
  |
  | Explanation: The IDCAMS utility is creating a GDG base entry.
  | GDG_base shows the name of the GDG base entry data set, and
  | nnn shows the maximum number of data sets that can be
  | associated with the GDG.
  |
  | System action: None.
  |
  | User response: None. This message is informational.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UI55240

Modules/Macros

• IHCULEV0 IHCUTIC0 IHCWLIU0 IHCWRUPD IHCWTDBA
  IHCWTDBB IHCWTDBG IHCWTDB0 IHCWTDB1 IHCWTDB2 IHCWTDB3 IHCWTDB4
  IHCWTDB7 IHCWTDB8 IHCWTDRC IHCWTKOV IHCWUNL0 IHCXIDCA IHCYCCDF
  IHCYMSGT
  

Fix information

• Fixed component name

  IM DB SOLUTION

• Fixed component ID

  5655S7700

Applicable component levels

• R210 PSY UI55240

     UP18/04/18 P F804

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.