PH00721: WHEN IKJ56220I AND HPSR0003W ARE ISSUED, MAINTAIN ENDS WITH RC=0BUT LOSS OF DATA CAN OCCUR

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When the following messages are issued in a MAINTAIN job,
  MAINTAIN does not detect an error for unload and ends with
  RC=00.  In this case, loss of data can occur.
  - IKJ56220I FILE DFSUINPT NOT CONCATENATED. TOO MANY DATA SETS.
  - IKJ56220I MAXIMUM NUMBER OF DATA SET ALLOCATIONS ALLOWED BY
    YOUR SESSION HAS BEEN REACHED. YOU SHOULD FREE UNUSED DATA
    SETS
  - HPSR0003W LAST RECORD WAS NOT A TRAILER RECORD
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IBM IMS HALDB Toolkit V1.1.         *
  ****************************************************************
  * PROBLEM DESCRIPTION: When the following messages are issued  *
  *                      in MAINTAIN job, MAINTAIN cannot detect *
  *                      an error for unload and ends with       *
  *                      RC=00. In this case, loss of data can   *
  *                      occur.                                  *
  *                      - IKJ56220I FILE DFSUINPT NOT           *
  *                        CONCATENATED. TOO MANY DATA SETS.     *
  *                      - IKJ56220I MAXIMUM NUMBER OF DATA SET  *
  *                        ALLOCATIONS ALLOWED BY YOUR SESSION   *
  *                        HAS BEEN REACHED. YOU SHOULD FREE     *
  *                        UNUSED DATA SETS                      *
  *                      - HPSR0003W LAST RECORD WAS NOT A       *
  *                        TRAILER RECORD                        *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  When MAINTAIN unloads a database, more than one unload file is
  usually created initially. The size of each unload file cannot
  be specified in IHCSYSIN. MAINTAIN allocates the files
  automatically. MAINTAIN concatenates the unload files as
  DFSUINPT DD after the unload files are created.
  When the database was extremely large and many unload files were
  created, a dynalloc error occurred during the concatenation
  because the number of data sets reached the limit. Error trace
  was issued in TRACE DD, but MAINTAIN proceeded with the
  processes because the error check process was incorrect.
  

Problem conclusion

• This APAR modifies the program as follows.
  1. When a dynalloc error occurs during the concatination,
     MAINTAIN issues some error traces and ends with U0999
     immediately.
  2. New parameters UNLSPAC(nnnn) and UNLUNIT(nnnnnnnn) are added
     for MAINTAIN command parameters to specify a size/unit of
     each unload file.
  
  ========================
  = 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
   UNLSPAC and UNLUNIT parameters have been added as follows:
  
    Parameter   Requirement   Description
    --------------------------------------------------------------
  | UNLSPAC     Optional      Specifies a 4-digit numeric space
  |                           allocation value for temporary data
  |                           set allocations, for example, the
  |                           unload file. Specify a numeric value
  |                           for the number of cylinders to
  |                           allocate to each temporary data set.
  |                           If the number of cylinders to
  |                           allocate to each temporary data set
  |                           is omitted, IMS HALDB Toolkit
  |                           determines the optimal value.
  |                           The number of data sets that are
  |                           allocated is determined by IMS HALDB
  |                           Toolkit.
  |
  |                           Format: (1 - 3000)
  |                           Default value: None.
  |
  | UNLUNIT     Optional      Specifies any valid direct-access
  |                           8-character unit name for temporary
  |                           data set allocations, for example,
  |                           the unload file. These files are
  |                           temporary files that default to
  |                           SYSALLDA, unless otherwise
  |                           specified.
  |
  |                           Format: (unitname)
  |                           Default value: SYSALLDA
  
  Chapter 4. Maintaining HALDB using MAINTAIN
  MAINTAIN command parameters
   UNLSPAC and UNLUNIT parameters have been added. These fixes
   are the same as CONVERT command parameters.
  

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:

  UI57796

Modules/Macros

• IHCULEV0 IHCUTIC0 IHCWANA1 IHCWANA3 IHCWANA4 IHCWLIU0 IHCWRUPD
  IHCWTDB0 IHCWTDB1 IHCWTDB2 IHCWTDB3 IHCWTDB4 IHCWTDB7 IHCWTDB8
  IHCWTDBA IHCWTDBB IHCWTDBG IHCWTDRC IHCWTKOV IHCWUNL0 IHCWUNLF
  IHCXLGDS IHCYCCDF
  

Fix information

• Fixed component name

  IMS HA DB TOOLK

• Fixed component ID

  5655DBU01

Applicable component levels

• R110 PSY UI57796

     UP18/08/11 P F808

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.