PI27633: PRECONDITIONING IN SUPPORT OF NEW FUNCTION

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• PRECONDITIONING IN SUPPORT OF NEW FUNCTION
  KEYWORDS: IMSV14TGT/K
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IBM IMS Database Solution Pack V2.1 *
  *                 IMS HALDB Toolkit                            *
  ****************************************************************
  * PROBLEM DESCRIPTION: Provide IMS V14 run-under support for   *
  *                      IMS Database Solution Pack V2.1 IMS     *
  *                      HALDB Toolkit                           *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR enables IMS HALDB Toolkit to run under IMS Version 14.
  The following APARs are also needed to enable all the functions
  of IMS HALDB Toolkit:
  - PI27636 IMS High Performance Unload V1R2 (FMID: H1IN120)
  - PI27637 IMS High Performance Load V2R1 (FMID: H1IM210)
  - PI27561 IMS High Performance Image Copy V4R2 (FMID: H1J0420)
  - PI27563 IMS High Performance Pointer Checker V3R1
            (FMID: HPC2310)
  - PI27566 IMS Library Integrity Utilities V2R1 (FMID: H27P210)
  The following APAR is also needed when you use ONLINE(Y) option
  for CONVERT and MAINTAIN functions:
  - PI27631 IMS Online Reorganization Facility V2R1
            (FMID: HAHP210)
  
  In addition, this APAR fixes the following problems:
  
   1. HALDB Toolkit does not support large format data sets.
   2. When ICNUM(2) is specified, the secondary image copy data
      set is not taken.
   3. HALDB Toolkit does not support RELOAD.OADSPR parameter.
   4. When using ISPF DBRC support functions, backing up DBRC
      DBD definitions, ABENDS0C4 can occur.
  

Problem conclusion

Temporary fix

Comments

• Code has been added to provide IMS V14 run-under support for IMS
  HALDB Toolkit.
  
  ==========================
  = DOCUMENTATION CHANGE 1 =
  ==========================
  IBM IMS Database Solution Pack for z/OS Version 2 Release 1
  Overview and Customization (SC19-4007-02)
  ----------------------------------------------------------------
  Chapter 1. IMS Database Solution Pack for z/OS overview
   Installation requirements
    Operational requirements
  
    IMS Database Solution Pack operates with the following IMS
    versions:
      IMS Version 11 Release 1 (5635-A02)
      IMS Version 12 Release 1 (5635-A03)
      IMS Database Value Unit Edition Version 12 Release 1
      (5655-DSQ) (with IMS Value Unit Edition PTF UK93908)
      IMS Version 13 Release 1 (5635-A04)
      IMS Database Value Unit Edition Version 13 Release 1
      (5655-DSM)MS Database PARTSIZE
  |   IMS Version 14 Release 1 (5635-A05)
  
  ==========================
  = DOCUMENTATION CHANGE 2 =
  ==========================
  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-00)
  ----------------------------------------------------------------
  Chapter 2. Simulating HALDB using ANALYZEPART
   ANALYZEPART command parameters
    Table 3. ANALYZEPART command parameters
  
    PARTSIZE
  
    Specifies the size of partitions to create.
  
    PARTSIZE cannot be used with PARTNUM or KEYS. The partition
  | size must be 1 - 8191.
  
    Specifying this parameter causes IMS HALDB Toolkit to find the
    high keys. The specifications are analyzed to determine whethe
    the requested partitioning is feasible.
    If either PARTNUM, PARTSIZE, or KEYS is not specified, the
    default setting PARTSIZE(2048) is used.
  
  
  Chapter 3. Converting to HALDB using CONVERT
   CONVERT command parameters
    Table 4. CONVERT command parameters
  
  | RELOAD.OADSPR
  |
  | Used for IMS High Performance Load processing.
  |
  | If the load is a standard HD Load, this parameter is
  | ignored.
  
  
  Chapter 4. Maintaining HALDB using MAINTAIN
   MAINTAIN command parameters
    Table 6. MAINTAIN command parameters
  
  | NOOSAM8G
  |
  | Specifies whether the maximum capacity of OSAM data sets is
  | changed from 8 gigabytes of data to 4 gigabytes of data.
  | You can specify NOOSAM8G(Y) for 8 gigabytes of data in OSAM
  | PHDAM or PHIDAM to change 4 gigabytes of data in OSAM PHDAM
  | or PHIDAM.
  | This option is valid only for a database that is registered
  | as OSAM8G in the RECON data sets.
  |
  | Specify Y or N. The default is N.
  |
  | When the NOOSAM8G(Y) is specified, PARTITION(*) is also
  | required.
  
    PARTSIZE
  
    Specifies the size of partitions to create.
  
    PARTSIZE cannot be used with PARTNUM or KEYS.
  | The partition size must be 1 - 4095 for a VSAM HALDB and
  | for a OSAM HALDB that are registered as NOOSAM8G in the
  | RECON data sets.
  | The partition size must be 1 - 8191 for a OSAM HALDB that is
  | registered as OSAM8G in the RECON data sets.
  
    Specifying this parameter causes IMS HALDB Toolkit to find the
    high keys. The specifications are analyzed to determine whethe
    the requested partitioning is feasible.
    If either PARTNUM, PARTSIZE, or KEYS is not specified, the
    default setting PARTSIZE(2048) is used.
  
  | RELOAD.OADSPR
  |
  | Used for IMS High Performance Load processing.
  |
  | If the load is a standard HD Load, this parameter is
  | ignored.
  
  
  Chapter 29. Messages and codes
  
  | IHC01183E  All partitions required for NOOSAM8G(Y)
  |
  | Explanation: NOOSAM8G keyword with CHANGE.DB command for a
  | DBRC is valid only for HALDB master databases, so all
  | partitions must be included in the MAINTAIN processing.
  |
  | System action: The process terminates.
  |
  | User response: Either remove the NOOSAM8G keyword from the
  | command or specify PARTITION(*).
  
  | IHC01184E NOOSAM8G(Y) cannot be specified for a database
  |           registered as NOOSAM8G in RECON
  |
  | Explanation: The NOOSAM8G keyword cannot be specified for
  | a database that is registered as NOOSAM8G in the RECON
  | data set.
  |
  | System action: The process terminates.
  |
  | User response: Remove the NOOSAM8G keyword from the command.
  
  | IHC01185E PARTSIZE must be less than 4096 for a database
  |           registered as NOOSAM8G in RECON
  |
  | Explanation: The PARTSIZE value must be less than 4096 for
  | a database that is registerd as NOOSAM8G in the RECON data
  | sets.
  |
  | System action: The process terminates.
  |
  | User response: Specify less than 4096 as the PARTSIZE value.
  
  | IHC01186E PARTSIZE must be less than 4096 when you specify
  |           NOOSAM8G(Y)
  |
  | Explanation: The PARTSIZE value must be less than 4096 when
  | you specify NOOSAM8G(Y).
  |
  | System action: The process terminates.
  |
  | User response: Either remove the NOOSAM8G keyword or specify
  | less than 4096 as the PARTSIZE value.
  

APAR Information

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

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

  UI24057

Modules/Macros

• HAHP210J IHCULEV0 IHCUTIC0 IHCWANA4 IHCWAN14
  IHCWDBRC IHCWDBRN IHCWDBR1 IHCWLIU0 IHCWLODR IHCWLOD0 IHCWLOD2
  IHCWREHP IHCWREIM IHCWREL0 IHCWRUPD IHCWTDBA IHCWTDBB IHCWTDBF
  IHCWTDBG IHCWTDB0 IHCWTDB1 IHCWTDB2 IHCWTDB3 IHCWTDB4 IHCWTDB5
  IHCWTDB6 IHCWTDB7 IHCWTDB8 IHCWTDB9 IHCWTDRC IHCWTKOV IHCWUNL0
  IHCWWANA IHCXALLO IHCXDCBG IHCXDSIN IHCXIDCA IHCXUPDT IHCYCB14
  IHCYCCDF IHCYDA14 IHCYDBRI IHCYDB11 IHCYDB12 IHCYDB13 IHCYDB14
  IHCYDMAC IHCYDM14 IHCYDX14 IHCYID14 IHCYMSGT IHCYOF14 IHCYPDEF
  IHCYRC11 IHCYRC12 IHCYRC13 IHCYRC14 IHCYRR14
  

Fix information

• Fixed component name

  IM DB SOLUTION

• Fixed component ID

  5655S7700

Applicable component levels

• R210 PSY UI24057

     UP14/12/20 P F412

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.