A fix is available
APAR status
Closed as new function.
Error description
This APAR enables the following functions of the Smart Reorg utility: 1. Using XTIOT for HALDB data set allocation 2. Requesting the update of the reorganization number of HALDB partitions in RECON if REORG NUMBER VERIFICATION=YES
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 provides the following * * enhancements of the smart reorg * * utility: * * * * 1. Using XTIOT for allocation of * * HALDB data sets * * 2. Requesting the update of the * * reorganization number of each HALDB * * partition in RECON * * * * And this APAR fixes the following * * problems:: * * - GETMAIN failure incorrectly: * * HPSG0100E GETMAIN ERROR (RC=04) * * IN MODULE HPSGRS10 * * - ABENDS0C4 at HPSGRS20+19A in * * the HPSGRMGR load module * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** 1. Using XTIOT for allocation of HALDB data sets to avoid an error of reaching the full of the TIOT space. If all of the following conditions are met, XTIOT (extended task input/output tables) used to allocate each HALDB data set dynamically - z/OS V1.12 or later - 'DBALLABOVE' is coded if DFSVSAMP DD is specified in JCL. - NON_VSAM_XTIOT option is coded in the DEVSUPxx member of PARMLIB if one or more OSAM data sets are included. - APAR PM75257 is applied for IMS High Performance Unload - APAR PM75254 is applied for IMS High Performance Load - APAR Pxxxxxx is applied for IMS High Performance Image Copy if HPIC=YES is specified. If the DFSVSAMP DD statement is not provided in JCL, it is allocated dynamically. If the other conditions are met, 'DBALLABOVE' is specified automatically. When XTIOT is used, MSGHPSG0105I is issued: HPSG0105I XTIOT IS USED FOR DATABASE DATA SETS 2. If 'REORG NUMBER VERIFICATION= YES' is defined in RECON, the Smart Reorg utility requests the update of the reorganization number of each HALDB partition to DBRC after issuing the NOTIFY.REORG command. IMS DBRC issues MSGDSP1108I; DSP1108I REORG# CHANGED FROM xxxxx TO yyyyy For DATABASE partname And this APAR fixes the following problems: - GETMAIN failure incorrectly HPSG0100E GETMAIN ERROR (RC=04) IN MODULE HPSGRS10 - ABENDS0C4 at HPSGRS20+19A in the HPSGRMGR load module.
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== The IBM IMS Database Reorganization Expert for z/OS User's Guide Version 4 Release 1 Suffix 3 (SC19-1137-03) should be changed as follows: --------------------------------------------------------------- > Reorganizing a database in one job step >> JCL requirements for Smart Reorg >>> DD statements >>>> DD names common to all processing options DFSVSAMP DD Describes the data set that contains the buffer pool information required by the IMS DL/I buffer handler. This data set, when not specified, is created dynamically by IMS Database Reorganization Expert. Therefore, normally, do not specify this data set. : : | For the 'DBALLABOVE' statement, see 'DYNALLOC control | statement'. --------------------------------------------------------------- > Reorganizing a database in one job step >> Smart Reorg JCL statements >>> Control statements for the Smart Reorg utility >>>> Control statements for the Smart Reorg Driver >>>>> DYNALLOC control statement : Notes: : |5. If all of the following conditions are met, XTIOT | (extended task input/output tables) is used to allocate | each HALDB data set dynamically: | - z/OS is V1.12 or later. | - NON_VSAM_XTIOT option is coded in the DEVSUPxx member of | PARMLIB if one or more OSAM data sets are included. | - 'DBALLABOVE' is specified in the DFSVSAMP data set. | If the DFSVSAMP data set is allocated dynamically, | 'DBALLABOVE' is coded in it automatically if the other | conditions are met. --------------------------------------------------------------- > Troubleshooting >> Messages and codes >>> Messages >>>> HPSG messages HPSG0102E DYNAMIC ALLOCATION FAILED FOR DDNAME= ddname RC=rc, RSN=rsn Explanation: An attempt of dynamic allocation for the data set that is identified by the DD name ddname failed. The values rc and rsn are the decimal return code and the hexadecimal reason code of the DYNALLOC macro. When RC=04 and RSN=1708, this message indicates that the data set does not exist. |When RC=04 and RSN=0238, this message indicates that the TIOT |space reached full. System Action: The Smart Reorg utility task or the subtask that issued the dynalloc request abends with a completion code of U0102, and the Smart Reorg utility job step ends with a return code of 16. User Response: Correct the error and rerun the job. If the error cannot be resolved, keep the dump produced at the time of error and contact IBM Software Support. Problem Determination: For the return code and the reason code from the DYNALLOC macro, refer to MVS Authorized Assembler Services Guide. -------------------------------------------------------------- | HPSG0105I XTIOT IS USED FOR DATABASE DATA SETS | | Explanation: XTIOT (extended task input/output tables) is | used to allocate each HALDB data set dynamically, | instead of TIOT. | System Action: The Smart Reorg utility continues processing. | User Response: none. -------------------------------------------------------------- | HPSG0115I DFSBRLSC FUNC=funcname RETURNED CONDITION CODE cc | | Explanation: IMS DBRC interface macro DFSBRLCS returns | hexadecimal condition code cc. Keyword funcname is one of | INIT0,INIT1,SIGNON,SIGNOFF,REORG or SETREORG. | System Action: The IPR Driver continues processing. | Programmer Response: If the condition code is not zero, | see DFSxxxx messages. --------------------------------------------------------------- | HPSG0118E LOAD FAILED FOR modname CC=xxxx, RSN=yy | | Explanation: A LOAD macro to load the indicated module | returns an error. | System Action: The Smart Reorg utility ends with a return | code of 8. | Programmer Response: Check the system completion code and | the error reason code. See the explanation of MVS system | completion code 806 to determine the meaning of the reason | code. Correct the error and rerun the job. --------------------------------------------------------------- | HPSG0453E REORG# UPDATE FAILED FOR PARTITION partition | | Explanation: An error occurred in updating the HALDB | partition reorganization number stored in the RECON data set. | System Action: The Smart Reorg utility ends with a return | code of 8. | Programmer Response: This is likely an internal system error. | Contact IBM Software Support. --------------------------------------------------------------- HPSG2211W THE ACCESS TO OUTPUT REPOSITORY WAS CANCELED. REASON: reason Explanation: The Smart Reorg utility canceled its access in the IMS Tools KB Output repository because its initialization process failed. The reason is one of the following: Reason Meaning ITKBLOAD DYNALLOC FAILUR Dynamic allocation for the library specified in the ITKBLOAD control statement failed. HKTXXLI LOAD FAILURE Loading of the HKTXXLI module failed. ITKBLOAD OPEN FAILURE Opening of the library specified in the ITKBLOAD control statement failed. ITKBLOAD NOT AUTHORIZED Library specified in the ITKBLOAD control statement is not APF-authorized. |ITKB KEY AREA GETMAIN ERR Obtaining of a key area failed. |LOG D/S DCB GETMAIN ERR Obtaining of DCB for a log data | set failed. System action: Processing continues, but no reports are stored in the IMS Tools KB Output repository. User response: If you want to store reports in the IMS Tools KB Output repository, specify the IMS Tools KB product load module library correctly. For more information, see "ITKBLOAD control statement". If the reason is "ITKBLOAD NOT AUTHORIZED", the library must be APF-authorized. ================= End of Documentation Change ==================
APAR Information
APAR number
PI11626
Reported component name
IMS DB REORG EX
Reported component ID
5655F7400
Reported release
410
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2014-02-12
Closed date
2014-03-13
Last modified date
2014-04-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI15968
Modules/Macros
HPSGBBLA HPSGBBLB HPSGBBLC HPSGBBLD HPSGBBL9 HPSGCM20 HPSGDI00 HPSGGIO0 HPSGGIT0 HPSGGRG0 HPSGGVM0 HPSGIDA0 HPSGIT10 HPSGIT20 HPSGLINK HPSGMPE0 HPSGMSGT HPSGRA00 HPSGRA40 HPSGRA50 HPSGRA70 HPSGRI00 HPSGRP00 HPSGRR00 HPSGRS00 HPSGRS10 HPSGRS20 HPSGRS40 HPSGRS6B HPSGRS6C HPSGRS6D HPSGTJ00 HPSGTM00 HPSGTU10 HPSGTU2A HPSGTU2B HPSGTU2C HPSGTU2D HPSGTU29 HPSGTU3A HPSGTU3B HPSGTU3C HPSGTU3D HPSGTU39 H25N410J
SC19113703 |
Fix information
Fixed component name
IMS DB REORG EX
Fixed component ID
5655F7400
Applicable component levels
R410 PSY UI15968
UP14/03/15 P F403
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