APAR status
Closed as new function.
Error description
With this APAR, the Elapsed Time consumed by Online Pointer Checker (OPC) will be reduced. This enhancement is being implemented as a result of RFE requirement 32580.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of HPFPU Fast Path Advanced Tool * * and Fast Path Online Tools in Fast Path * * Solution Pack Version 1 Release 3 * * (FMID: HAHQ130). * **************************************************************** * PROBLEM DESCRIPTION: GA PTF of IMS FP Solution Pack Version * * 1 Release 3. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR addresses the following enhancements: 1. OPC performance improvement Elapsed time and CPU time of OPC with FULLSTEP=YES is reduced by processing multiple areas concurrently, and eliminating I/Os for intermediate data sets. Also, OPC reports the pointer errors in the new Online Pointer Scan report instead of FPX0061E messages. 2. Add a new keyword RAP_LONGSYN_PCT This keyword specifies a threshold setting for the percentage of RAPs that have a long synonym chain among all the RAPs that are used. RAP_LONGSYN_PCT is an optional keyword for the THRESHOLD subcommand, and can be used with the TUNE command. The format is as follows: RAP_LONGSYN_PCT=(threshold,lower_bound) threshold Specify the threshold value in the range of 0 - 100 for the percentage of RAPs that have a long synonym chain. lower_bound Specify the lower bound in the range of 1 - 99. FPA regards any RAP that has the number of synonyms equal to or greater than the lower bound as a RAP with a long synonym chain. 3. Forward fit of APAR PM96394 Add a new parameter (IMSID=) on to EXEC statement in HFPMAIN0 to pass an information of IMSID to randomizer. If IMSID parameter is specified, HFPMAIN0 makes the buffers for temporary ESCD and SCD. Register 11 contains the address of temporary ESCD when HFPMAIN0 issues a call to a randomizing module. HFPMAIN0 sets only the field ESCDSCD that contains the address of SCD into temporary ESCD. HFPMAIN0 also sets only the field SSCDIMID that contains IMS subsystem ID into temporary SCD. Other fields of temporary ESCD and temporary SCD cannot be referred. Also, this APAR addresses the following problem: 4. Forward fit of APAR PM97923 When the average length of a segment is extremely closed to the maximum length, and when SEGLDIST=YES is specified, FPA Analyze or FPO Online Pointer Checker abends with S0C4 in module HFPA5SR0. The cause of the abend is to calculate the range that contains more than 90% of segment occurrences incorrectly. The FPA Analyze and the FPO Online Pointer Checker are modified to calculate the range that contains more than 90% of segment occurrences correctly. This APAR addresses the following enhancement: 5. Forward fit of APAR PM94821 Adds a new parameter for the OLRECL keyword of IMS Fast Path Online Tools (FPO). When this parameter is specified, FPO determines the LRECL value of FPXOFILE based on the following factors: The maximum segment length defined in the DBD. The SEG keyword on the OUTPUT statement, the FIELDS keyword on the OUTPUT statement, or both.
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== The IMS Fast Path Solution Pack for z/OS Version 1 Release 3 IMS High Performance Fast Path Utilities User's Guide (SC19-4010-00). > Part 2. IMS Fast Path Advanced Tool >> Chapter 2. Overview of IMS Fast Path Advanced Tool >>> Restriction of FPA The description has been added as follows: (Revision bar shows the part of change) ... When a randomizer is invoked by IMS, register 10 contains the addresses of the EPST, and register 11 contains the addresses of the ESCD. Some user-written or user-customized randomizers are designed to use these addresses to gain access to IMS control blocks other than those passed as part of the published interface. To show that the call is not being issued in an IMS online environment, when one of the IMS Fast Path Advanced Tool functions issues a call to a randomizing module, register 10 is set to -1 and register 11 is set to 0. | However, if the IMSID parameter is specified on the EXEC | statement, FPA generates the buffers for temporary ESCD and | SCD. Register 11 contains the address of the temporary ESCD | when FPA issues a call to a randomizing module. FPA sets only | the ESCDSCD field, which contains the address of SCD, in the | temporary ESCD. Also, FPA sets only the SSCDIMID field, which | contains the IMS subsystem ID, in the temporary SCD. Other | fields of temporary ESCD and temporary SCD cannot be referred | to. > Part 2. IMS Fast Path Advanced Tool >> Chapter 4. Unloading a DEDB offline with FPA >>> Running the Unload function >> Chapter 5. Reloading a DEDB offline with FPA >>> Running the Reload function >> Chapter 6. Changing a DEDB offline with FPA >>> Running the Change function >> Chapter 8. Analyzing a DEDB offline with FPA >>> Running the Analyze function >> Chapter 9. Tuning a DEDB offline with FPA >>> Running the Tune function >> Chapter 12. Building secondary index databases for a DEDB offline with FPA >>> Running the Build Index function New EXEC parameter, IMSID, has been added as follows: (Revision bar shows the part of change) Procedure 1. Estimate the region size required to run the function. 2. Specify the EXEC statement in the following format: //cmd_name EXEC PGM=HFPMAIN0,REGION=rrrrM, | // PARM='DBRCGRP=dbrcgrp,GSGNAME=gsgname,IMSPLEX=imsplex, | // IMSID=imsid' _____________ _____________________________________________ | Parameter | Description | |_____________|_____________________________________________| | ... | ... | |_____________|_____________________________________________| | | IMSID= |IMSID is an optional 1- to 8-character | | | |parameter that specifies the IMS subsystem | | | |identification name. If specified, FPA | | | |generates the buffers for temporary ESCD and | | | |SCD. Register 11 contains the address of the | | | |temporary ESCD when FPA issues a call to a | | | |randomizing module. FPA sets only the ESCDSCD| | | |field, which contains the address of SCD, in | | | |the temporary ESCD. Also, FPA sets only the | | | |SSCDIMID field, which contains the IMS | | | |subsystem ID, in the temporary SCD. Other | | | |fields of temporary ESCD and temporary SCD | | | |cannot be referred to. | | |_____________|_____________________________________________| > Part 2. IMS Fast Path Advanced Tool >> Chapter 14. Command reference for FPA >>> FPA keywords >>>> RAP_LONGSYN_PCT The description of the value of RAP_LONGSYN_PCT is changed as follows: (Revision bar shows the part of change) ... threshold Specify the threshold value in the range of 0 - 100 for the percentage of RAPs that have a long synonym chain. lower_bound | Specify the lower bound in the range of 1 - 99. FPA regards any RAP that has the number of synonyms equal to or greater than the lower bound as a RAP with a long synonym chain. ... ... Because the resulted value exceeds the value that you specified with the threshold parameter, which is 10, FPA issues a warning message. | FPA calculates the percentage of RAPs using the Synonym Chain | Analysis table. Therefore, if the value of SYNTBL keyword | specified in HFPAPARM DD or the default value of SYNTBL is | less than or equal to the value of SYN_NUM_LOWER_BOUND that is | specified by RAP_LONGSYN_PCT keyword, The FPA replaces the | value of SYNTBL keyword by the value of SYN_NUM_LOWER_BOUND | plus 1. >> Chapter 15 Sample Reports of FPA >>> Sensor Data Statistics report Sub header of "SENSOR DATA STATISTICS REPORT" has been changed from "SYNONYM CHAIN LENGTH STATISTICS" to "RANDOMIZING STATISTICS" for Figure 214,216,218,220,222,308. > Part 4. IMS Fast Path Online Tools >> Chapter 32. FPO reports stored in IMS Tools KB >>> FPXSPRT DD data set Sub header of "SENSOR DATA STATISTICS REPORT" has been changed from "SYNONYM CHAIN LENGTH STATISTICS" to "RANDOMIZING STATISTICS" for Figure 310,312,314,316,363,365,367,369,371. > Part 7. Troubleshooting >> Chapter 54. Messages and codes of IMS HP Fast Path Utilities >>> Messages >>>> HFPA messages The new message, HFPA0032I has been added as follows: HFPA0032I SYNTBL=14 IN HFPAPARM DD IS CHANGED TO 16, WHICH IS THE LOWER_BOUND VALUE OF RAP_LONGSYN_PCT PLUS 1. Explanation: When the value of SYNTBL in HFPAPARM DD or the default value of SYNTBL is less than or equal to the value of LOWER_BOUND that is specified by RAP_LONGSYN_PCT keyword, The FPA replaces the value of SYNTBL keyword by the value of LOWER_BOUND plus 1. System action: The value of SYNTBL keyword is replaced by the value of LOWER_BOUND plus 1 that is specified by RAP_LONGSYN_PCT keyword, and Processing continues. User response: None. This message is informational. The IMS Fast Path Solution Pack, Database Sensor User's Guide (SC19-3283-00). > Part 3. Using FP Stand-alone Database Sensor >> Chapter 14. Output from FP Stand-alone DB Sensor 89 >>> Sensor Data Statistics report from FP Stand-alone Database Sensor Sub header of "SENSOR DATA STATISTICS REPORT" has been changed from "SYNONYM CHAIN LENGTH STATISTICS" to "RANDOMIZING STATISTICS" for Figure 29,31,33,35,37. >>Chapter 16. Printing sensor data by using the FP DB Sensor Printing utility >>Sensor Data Statistics report from the FP DB Sensor Printing utility Sub header of "PRINTING UTILITY - SENSOR DATA STATISTICS REPORT" has been changed from "SYNONYM CHAIN LENGTH STATISTICS" to "RANDOMIZING STATISTICS" for Figure 47,49,51,53,55.
APAR Information
APAR number
PI05155
Reported component name
IMS FP SOLUTION
Reported component ID
5655W1400
Reported release
130
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2013-10-30
Closed date
2013-11-21
Last modified date
2013-11-24
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI12771
Modules/Macros
FPXADRVB FPXADRVC FPXADRVD FPXAERR0 FPXAERR1 FPXAEST0 FPXAFIN0 FPXAICEB FPXAICEC FPXAICED FPXAICM0 FPXALI ***This field was truncated. To obtain the full apar record, please contact your local support center.***
| SC19401000 | SC19328300 |
Fix information
Fixed component name
IMS FP SOLUTION
Fixed component ID
5655W1400
Applicable component levels
[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"130","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCV35A","label":"IMS Fast Path Solution Pack"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"130","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
24 November 2013