A fix is available
APAR status
Closed as program error.
Error description
1. When running FPA ANALYZE with SEGLDIST=YES to a database that has fixed length segments and variable length segments, FPA ANALYZE generates the Segment Length Distribution report incorrectly, or causes a loop. 2. When running FPA ANALYZE with threshold values specified by THRESHOLD subcommand, and when a database exceeds the threshold values, FPA ANALYZE does not store the sensor data to the sensor data repository.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of HPFPU Fast Path Advanced * * Tools, HPFPU Fast Path Online Tools, and DB * * Sensor in Fast Path Solution Pack Version 1 * * Release 2 (FMID: HAHQ120). * **************************************************************** * PROBLEM DESCRIPTION: 1. Unable to finish JCL job when * * SEGLDIST=YES is specified. * * 2. Unable to save Sensor Data when * * exceptions occur with THRESHOLD * * keyword is specified * * 3. Garbage information is displayed at * * Secondary Index Analysis Report. * * 4. Standardize Sensor Report Subheader. * * 5. Abend occurs when DB has ROOT and * * SDEP segments only. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** 1. Unable to finish JCL job with SEGLDIST=YES on the DB which has FIX segment between segments. 2. Unable to save Sensor Data when exceptions occur with SENSOR_UOW=YES and THRESHOLD is specified due to exit condition. 3. Garbage information is displayed because the field length is wrong. 4. SENSOR Report subheader has been differernt from FF's subheader. Standardize subheader of SENSOR report for FF and FP. 5. ABEND occurs when SEGLDIST=YES and the DB has ROOT and SDEP segments only.
Problem conclusion
1. Modified to count up FIX segment between segments to get expected result. 2. Changed exit condition to store Sensor data even if exception occurs. 3. the field length is changed to correct length. 4. Standardize subheader of SENSOR report for FF and FP. 5. Modified to take the DB of ROOT and SDEP segments only correctly. ======================== = DOCUMENTATION CHANGE = ======================== The IMS Fast Path Solution Pack for z/OS Version 1 Release 2 IMS High Performance Fast Path Utilities User's Guide (SC19-3287-00). > Analyzing a DEDB offline with FPA >> DD statements for the Analyze process The contents of following table, HFPAPARM table, is changed: RBASEFS: This keyword is an optional keyword. If a RAP CI contains free space that is greater than or equal to the percentage specified, and the RAP CI also uses overflow CIs, a reorganization control statement is generated for the UOW, and the UOW is included in the UOW Exception report. The default is 100%. The maximum value is 99, and the minimum value is 0. RDOVFFS: This keyword is an optional keyword. If the DOVF part of a UOW contains free space that is greater than or equal to the percentage specified, and the UOW also uses IOVF CIs, a reorganization control statement is generated for the UOW and the UOW is included in the UOW Exception report. The default is 100% The maximum value is 99, and the minimum value is 0. UDOVFFS: This keyword is an optional keyword. If the DOVF UOW contains free space that is less than or equal to the percentage specified, the UOW is included in the UOW Exception report. The default is 0%. The maximum value is 99, and the minimum value is 0. > Analyzing a DEDB offline with FPA >> Running the Analyze function >>> Preprocess for the Analyze process: Initializing permanent >>> data set //-------------------------------------------------------------- //-- ALLOCATE AND INITIALIZE HISTORY DATA SET //-------------------------------------------------------------- //IDCAMS EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=A //SYSIN DD * DELETE ( HPFP.STAT.HIST ) NONVSAM DELETE ( HPFP.STAT.HIST2 ) NONVSAM SET MAXCC = 0 / //-------------------------------------------------------------- //-- ALLOCATE STATISTICS HISTORY DATA SET //-- ALLOCATE STATISTICS HISTORY2 DATA SET //-------------------------------------------------------------- //IEFBR14 EXEC PGM=IEFBR14 //DASDHIO DD DSN=HPFP.STAT.HIST,DISP=(NEW,CATLG,CATLG), // DCB=(DSORG=PS,RECFM=FB,LRECL=100,BLKSIZE=800), // UNIT=SYSDA,SPACE=(CYL,(2,2),RLSE) //DASDHIO2 DD DSN=HPFP.STAT.HIST2,DISP=(NEW,CATLG,CATLG), // DCB=(DSORG=PS,RECFM=FB,LRECL=200,BLKSIZE=1600), // UNIT=SYSDA,SPACE=(CYL,(4,4),RLSE) > Sample reports of FPA >> UOW Exception report The UOW Exception report contains the analysis information of the UOW that exceeds the reporting parameters at HFPAPARM. Entries on this report are generated when one of the reporting parameters is exceeded. These reporting parameters are controlled by the keyword that you specify on the HFPAPARM DD statement. > nn% free space in a RAP CI and overflow CIs are used. Use the RBASEFS keyword to specify this parameter. > nn% free space in DOVF and the UOW uses IOVF CIs. Use the RDOVFFS keyword to specify this parameter. < nn% free space in the DOVF part of a UOW. Use the UDOVFFS keyword to specify this parameter. The UOW Exception report can be used to: List detailed information about each UOW Identify which UOWs require reorganization Manage space utilization when the randomizer has been modified to group related data into contiguous UOWs List only those UOWs that violate the user-specified space utilization criteria This report is generated by the following commands and by the reporting parameters at HFPAPARM: ANALYZE with the REPORT subcommand and the PTRCHKLVL=FULL or the PTRCHKLVL=QUICK keyword CHANGE with the REPORT subcommand and the PTRCHKLVL=FULL or the PTRCHKLVL=QUICK keyword RELOAD with the REPORT subcommand and the PTRCHKLVL=FULL or the PTRCHKLVL=QUICK keyword REORG with the REPORT subcommand and the PTRCHKLVL=FULL or the PTRCHKLVL=QUICK keyword For information about the HFPAPARM DD statement, see the description about the DD statement in the following topics: "DD statements for the Analyze process" in topic 2.7.5 "DD statements for the Change process" in topic 2.5.5 "DD statements for the Reload process" in topic 2.4.5 "DD statements for the Reorg process" in topic 2.6.6 The following figure is an example of the UOW Exception report when PTRCHKLVL=FULL and the reporting parameters at HFPAPARM. > Sample reports of FPA >> Sensor Data Statistics report ============================================== SYNONYM CHAIN LENGTH STATISTICS ============================================== is changed to ============================================== RANDOMIZING STATISTICS ==============================================
Temporary fix
Comments
APAR Information
APAR number
PI06811
Reported component name
IMS FP SOLUTION
Reported component ID
5655W1400
Reported release
120
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2013-11-22
Closed date
2013-12-12
Last modified date
2014-01-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI13468
Modules/Macros
HFPA5H20 HFPA5PF0 HFPA5SR0 HFPLSIA0 HFPOSNR0 HFPSPRDF
Fix information
Fixed component name
IMS FP SOLUTION
Fixed component ID
5655W1400
Applicable component levels
R120 PSY UI13468
UP13/12/14 P F312
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":"SSCV35A","label":"IMS Fast Path Solution Pack"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.2.0"}]
Document Information
Modified date:
03 October 2020