PI66737: THIS APAR FIXES VARIOUS PROBLEMS OF DBSP IMS HALDB TOOLKIT.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• This APAR fixes various problems of DBSP IMS HALDB Toolkit.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IBM IMS Database Solution Pack      *
  *                 V2.1 IMS HALDB Toolkit                       *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR fixes various problems of     *
  *                      DBSP IMS HALDB Toolkit.                 *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR fixes the following problems:
   1. When running COPYDBRC with DFDSS(Y), an incorrect RENUNC
      statement can be generated.
   2. When running MAINTAIN with ONLINE(Y) and NOOSAM8G(Y) for a
      HALDB registered as OSAM8G in the RECON data sets, the
      database access can be failed after MAINTAIN.
   3. When running the split unload file utility (IHCUSPLT) with
      multiple input files, each partition unload file can
      contain multiple trailer records.
   4. When running ISPF MAINTAIN with PARTSIZE >= 4096 for a
      HALDB using VSAM, and total amount of data exceeds 4 giga
      bytes, reload can be failed.
   5. When running ISPF CONVERT with PARTSIZE >= 4096 for a
      non-HALDB using VSAM, INIT.DB can be failed.
   6. When IHCUAPI INIT call is issued, partition selection API
      fails with RC=16, RSN=513.
   7. When IHCRRC00 is used instead of DFSRRC00, loading logical
      children fails with ABENDS806.
   8. When running MAINTAIN or CONVERT with HP Load utility and
      a partition selection exit other than IHCPSEL0 is used,
      HP Load can be failed with U3770.
   9. When IMS Library Integrity Utilities load module library is
      included in the STEPLIB of CONVERT or MAINTAIN job,
      temporary log data sets are unnecessarily registered in the
      RECON data sets.
  

Problem conclusion

• Code has been changed to fix the issues described in this APAR.
  
  ========================
  = 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-01)
  ---------------------------------------------------------------
  
  Chapter 13. Partition selection API
   The description about Invoking the partition selection API has
   been changed as follows:
  
    Invoking the partition selection API
  
    The following definition specifications are required to
    invoke the partition selection API:
     - Define HANDLE as a 4-byte binary field
     - Define PARTNAME as an 8-byte character field
     - Define PARTNUM as a 2-byte binary field
     - Define RETCODE as a 4-byte binary field
     - Define RSNCODE as a 4-byte binary field
  | The application must be linked as AMODE 31.
  
  Chapter 15. Loading logical children (PROCOPT=L)
   The description about JCL has been updated as follows:
  
    IMS HALDB Toolkit improves this situation by allowing these
    load segments with the following restrictions:
      - The logical child segment must contain the LPCK in the IO
        area.
      - The application will receive a BB status code.
        The segments (1 child and dependents) are inserted later.
      - JCL is structured as follows:
          - Step 1 is the load program. File DFSURWF1 is used to
            store the delayed segments.
  |       - Step 2 is prefix update. This step inserts all delayed
  |         segments. All WF1 data sets created by step 1 must be
  |         included in the DFSURWF3 file.
      - You must change your JCL as follows:
  |       - Use IHCWRC00 instead of DFSRRC00 to accommodate
  |         steps 1 and 2
          - Include the SIHCLOAD target load library in the
            STEPLIB
  

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:

  UI40343

Modules/Macros

• HAHP210J IHCM99   IHCUAPI  IHCULEV0 IHCUUOW0
  IHCWCPY0 IHCWDBL0 IHCWDSN0 IHCWIXR2 IHCWLOD2 IHCWMIAU IHCWMI00
  IHCWPROJ IHCWPRUP IHCWRC00 IHCWSEL4 IHCWSPLT IHCWTDB1 IHCWWANA
  IHCYCCDF IHCYDBD0 IHCYDBD4 IHCYDBRI IHCYDBR0 IHCYLGDB IHCYLIU0
  IHCYSVLS
  

Fix information

• Fixed component name

  IM DB SOLUTION

• Fixed component ID

  5655S7700

Applicable component levels

• R210 PSY UI40343

     UP16/08/27 P F608

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.