A fix is available
APAR status
Closed as program error.
Error description
The Post-reorganization utility issues MSGHPSG0100E erroneously. HPSG0100E GETMAIN ERROR (RC=04) IN MODULE HPSPTM3E
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IMS Database Reorganization * * Expert for z/OS Version 4 Release 1 * * (FMID=H25N410) * **************************************************************** * PROBLEM DESCRIPTION: This APAR fixes the following problems: * * 1. ABENDU0100 is issued erroneously * * with MSGHPSG0100E in the Post-reorg * * utility. * * HPSG0100E GETMAIN ERROR (RC=04) IN * * MODULE HPSPTM3E * * * * 2. ABENDS0C4-10 in the HPSPMAIN module * * (CSECT:HPSGRD00+X'0734') when the * * Post-reorg utility starts before * * completion of the previous smart-reorg * * utility or the IPR DB scan utility job. * * * * 3. If NAMESWAP=YES is coded in HPSIN * * data set for the Pre-reorganization * * utility and SPACEALLOC=YES is coded in * * the HPSIN data set for the Smart Reorg * * utility, each old temporary data set * * (*.T) should be deleted during the * * shadow allocation process. * * * * 4. The result data sets should be * * initialized by the Pre-reorganization * * utility. * * * * 5. After issuing MSGHPSG0323E (MODULE * * IS NOT AUTHORIZED), MSGHPSG0023E shows * * no reason code. * * * * 6. Extra page headers are printed in * * the DBRC notification command stream * * report. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** After applying this APAR, the followings are modified. 1. If the Post-reorganization utility job starts before completion of the previous Smart Reorg utility job or the IPR DB Scan utility job, the new HPSG0032E message is issued and its process end with RC=08 without restoring the authorization flags. HPSG0032E PREVIOUS REORG|SCAN PROCESS NOT COMPLETED. DBD=dbd_name 2. The Post-reorganization checks whether the content of each Result data set is consistent with the HPSGCTL data set. If an inconsistency is found, the HPSG0025E message is issued. HPSG0025E THE RESULT DATA SET FOR dbdname IS INCORRECT. DSN=dataset_name
Problem conclusion
======================== = DOCUMENTATION CHANGE = ======================== The IBM IMS Database Reorganization Expert for z/OS User's Guide Version 4 Release 1 Suffix 2 (SC19-1137-02) --------------------------------------------------------------- X.X Using the Pre-reorganization utility and Post-reorganization utility X.X.X Recovering from Post-reorganization utility errors ( A new line has been added to Table 69.) Table 69. Post-reorganization utility error types and actions |- Error type | One or more Smart Reorg utility jobs or IPR DB Scan utility | jobs have not completed yet. (HPSG0032E) |- Post-reorganization utility action | Issues error messages and stops processing. Does not | restore the authorization flags. |- User action | Rerun this job after the completion of the Smart Reorg | utility or IPR DB Scan utility job. --------------------------------------------------------------- 8.2.3.3 HPSG message (The following messages have been changed:) | HPSG0024E THE SPECIFIED HPSGCTL DATA SET IS INCORRECT | Explanation: The content of the data set that is specified on the HPSGCTL DD statement is incorrect. | System action: The Smart Reorg utility, IPR DB Scan utility, or the Post-reorganization utility ends with a return code of 8. | User response: Make sure if the Pre-reorganization utility | completed successfully, and specify the correct data set is | specified on the HPSGCTL DD statement. --------------------------------------------------------------- HPSG0025E THE RESULT DATA SET FOR dbdname IS INCORRECT. DSN=dataset_name | Explanation: If the HPSG0122E message issued, the result data | set for the indicated database is not found. Otherwise, the | result data set is found, however, there is an inconsistency | between the HPSTCTL data set and the result data set. System action: The Post-reorganization utility ends with | a return code of 8 without restoring the authorization flags. | User response: Rerun all the jobs including Pre-reorganization | utility, Smart Reorg utility, IPR DB Scan utility, and | Post-reorganization utility jobs. --------------------------------------------------------------- (The following new messages have been added.) | HPSG0032E PREVIOUS REORG|SCAN PROCESS NOT COMPLETED. | DBD=dbd_name | | Explanation: The Smart Reorg utility job or the IPR DB Scan | utility job that was run before this Post-reorganization | utility job has not completed yet for the indicated DBD. | System action: The Post-reorganization utility ends with | a return code of 8 without restoring the authorization flags. | User response: Rerun this job after the completion of | the Smart Reorg utility or IPR DB Scan utility job. --------------------------------------------------------------- ====================== END of Doc-Change ======================
Temporary fix
Comments
APAR Information
APAR number
PM85664
Reported component name
IMS DB REORG EX
Reported component ID
5655F7400
Reported release
410
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2013-03-26
Closed date
2013-04-09
Last modified date
2013-05-06
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK93233
Modules/Macros
HPSGGRG0 HPSGMSGT HPSGRA50 HPSGRS00 HPSPMAIN HPSPRM00 HPSPRM20 HPSPTM20 HPSPTM30
SC19113702 |
Fix information
Fixed component name
IMS DB REORG EX
Fixed component ID
5655F7400
Applicable component levels
R410 PSY UK93233
UP13/04/13 P F304
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.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSVL5Q","label":"IMS Database Reorganization Expert for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1.0","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
06 January 2023