A fix is available
APAR status
Closed as program error.
Error description
The Full-Function DB Sensor gets ABENDS0C4 in BBESSHDA if all the following conditions are true: - HDAM - The number of root addressable area (RAA) blocks is defined as zero in the DBD. RMNAME=(rand,rap,0,bytes) may be coded in the DBD macro - SENSOR_HOME=YES is applied The failing instruction at the ABENDS0C4 is x'431F0000'.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: The Stand-alone and Integrated FF Database * * Sensor users who install the following * * product and packs: * * - IBM IMS Database Reorganization Expert for * * z/OS V4.1 (FMID=H25N410) * * - IBM IMS Database Solution Pack for * * V2.1 (FMID=HAHP210) or V2.2 (FMID=HAHP220) * * - IBM IMS Database Utility Solution for * * V1.1 (FMID=HDFA110) or V2.1 (FMID=HDFA210) * **************************************************************** * PROBLEM DESCRIPTION: The Full-Function DB Sensor (DB Sensor) * * gets ABENDS0C4 at BBESSHDA under all of * * the following conditions: * * * * - HDAM * * - The number of root addressable area * * (RAA) blocks is defined as zero in * * the DBD * * - SENSOR_HOME=YES is applied * * * * The failing instruction at the * * ABENDS0C4 is x'431F0000'. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** If you specify RMNAME=(rand,rap,0,bytes) or you omit the third operand of the RMNAME= parameter in the DBD macro, the number of root addressable area (RAA) blocks is defined as zero in the HDAM or PHDAM DBD. In this condition, the following errors can occur: - When the HDAM is proccessed and SENSOR_HOME=YES is specified, DB Sensor refers incorrect area and gets ABNEDS0C4 at BBESSHDA. The failing instruction at the ABENDS0C4 is x'431F0000'. - When the PHDAM is proccessed, DB Sensor issues the message BBE1402E and returns a return code 8. After applying the PTF for this APAR, DB Sensor does not get ABENDS0C4 or issue the message BBE1402E even if the number of RAA blocks is defined as zero in the HDAM or PHDAM DBD. In this case, the following data elements are not collected even when SENSOR_HOME=YES is specified: - DB_NUM_ROOT_NOHOME - DB_PCT_NUM_ROOT_NOHOME - DB_AVG_LEN_SYNONYM_CHAIN Also, DB Sensor gets ABEND0C9 at BBESWSTA during the error handling when HISAM or SHISAM is proccessed. The GR1 contains X'FFFFFFF6' at the ABENDS0C9. After applying the PTF for this APAR, DB Sensor does not get ABENDS0C9 at BBESWSTA.
Problem conclusion
The following modules have been modified to fix the problem: BBESCREB BBESWSTA ======================== = DOCUMENTATION CHANGE = ======================== The documentation is modified as follows: ============================================================== IMS Solution Packs Data Sensor V2R2, User's Guide (SC19328303) ============================================================== > Using FF Stand-alone Database Sensor >> FF Stand-alone DB Sensor JCL and control statements >>> GLOBAL command keywords for FF Stand-alone DB Sensor << The following description is added. >> Restrictions - If the key compression option of the Segment Edit/Compression exit routine is specified for the root segment, these data elements are not collected even when SENSOR_HOME=YES is specified. | - If you specify RMNAME=(rand,rap,0,bytes) or if you omit the | third operand of the RMNAME parameter in the DBD macro, | the number of root addressable area (RAA) blocks is defined | as zero in the HDAM or PHDAM DBD. In this case, these data | elements are not collected even when SENSOR_HOME=YES is | specified. ============================================================== IMS Database Reorgaization Expert V4R1, User's Guide (SC19113705) ============================================================== > Reorganizaing a database in one job step >> Smart Reorg control statements >>> Control statements for the Conditional Reorganization Support Service >>>> SENSOR_HOME control statement << The following description is added and the title is modified. >> |Restrictions - If the key compression option of the Segment Edit/Compression exit routine is specified for the root segment, these data elements are not collected even when SENSOR_HOME=YES is specified. | - If you specify RMNAME=(rand,rap,0,bytes) or if you omit the | third operand of the RMNAME parameter in the DBD macro, | the number of root addressable area (RAA) blocks is defined | as zero in the HDAM or PHDAM DBD. In this case, these data | elements are not collected even when SENSOR_HOME=YES is | specified. ============================================================== IMS High Performance Pointer Checker V3R1, User's Guide (SC19240104) ============================================================== > HD Pointer Checker utility >> Using the HD Pointer Checker processor >>> Input >>>> PROC statement << The following description is added and the title is modified. >> |Restrictions - If the key compression option of the Segment Edit/Compression exit routine is specified for the root segment, these data elements are not collected even when SENSOR_HOME=YES is specified. | - If you specify RMNAME=(rand,rap,0,bytes) or if you omit the | third operand of the RMNAME parameter in the DBD macro, | the number of root addressable area (RAA) blocks is defined | as zero in the HDAM or PHDAM DBD. In this case, these data | elements are not collected even when SENSOR_HOME=YES is | specified. ============================================================== IMS High Performance Image Copy V4R2, User's Guide (SC19275602) ============================================================== > Running IMS HP Image Copy >> Control statements and keywords >>> ICEIN control statement keywords >>>> SENSOR_HOME keyword << The following description is added. >> - If the key compression option of the Segment Edit/Compression exit routine is specified for the root segment, these data elements are not collected even when SENSOR_HOME=YES is specified. | - If you specify RMNAME=(rand,rap,0,bytes) or if you omit the | third operand of the RMNAME parameter in the DBD macro, | the number of root addressable area (RAA) blocks is defined | as zero in the HDAM or PHDAM DBD. In this case, these data | elements are not collected even when SENSOR_HOME=YES is | specified. - When SENSOR_HOME=Y, even if HOMECHK=N is specified, DB Sensor runs as if HOMECHK=(YES,-10,+10) is specified
Temporary fix
Comments
APAR Information
APAR number
PH02047
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
2018-08-22
Closed date
2018-08-29
Last modified date
2018-10-09
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI58157
Modules/Macros
BBESCREB BBESWSTA
Fix information
Fixed component name
IMS DB REORG EX
Fixed component ID
5655F7400
Applicable component levels
R410 PSY UI58157
UP18/08/31 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.
[{"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