PI99707: FORWARD-FIT OF DBSP V2.1 IMS HALDB TOOLKIT APAR PI95128

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Forward-fit of DBSP V2.1 IMS HALDB Toolkit APAR PI95128.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IBM IMS HALDB Toolkit V1.1.         *
  ****************************************************************
  * PROBLEM DESCRIPTION: Forward fit of DBSP V2.1 IMS HALDB      *
  *                      Toolkit APAR PI95128.                   *
  *                      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 2
  IMS High Availability Large Database Toolkit User's Guide
  (SC27-9038-00) and
  IBM IMS Database Utility Solution for z/OS Version 2 Release 1
  IMS High Availability Large Database Toolkit User's Guide
  (SC27-8779-00) and
  IBM IMS Database Utility Solution for z/OS Version 1 Release 1
  IMS High Availability Large Database Toolkit User's Guide
  (SC27-9007-01)
  ----------------------------------------------------------------
  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:

  UI57147

Modules/Macros

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

Fix information

• Fixed component name

  IMS HA DB TOOLK

• Fixed component ID

  5655DBU01

Applicable component levels

• R110 PSY UI57147

     UP18/07/11 P F807

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.