A fix is available
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 number
PH00721
Reported component name
IMS HA DB TOOLK
Reported component ID
5655DBU01
Reported release
110
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2018-07-19
Closed date
2018-08-09
Last modified date
2018-09-04
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
SC27903800 | SC27877900 | SC27900701 |
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.
[{"Line of Business":{"code":null,"label":null},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCBQAP","label":"IMS HALDB Toolkit"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.1.0"}]
Document Information
Modified date:
20 October 2020