APAR status
Closed as new function.
Error description
Roll-up of FPO V21 maintenance. APAR'S included are PK06923, PK08791,PK09594,PK12366,PK11464,PK16613,PK16856 and PK11395. This is a forward fit of APAR PK16857.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All Online Tools users of High Performance * * Fast Path Utilities FP Online Tools * * Version 2 Release 2 (FMID: H31A220). * **************************************************************** * PROBLEM DESCRIPTION: 1. DBFUHDS0 (within DFSSQPP macro) * * gets ABENDS0C4 during HSRE running. * * 2. OPC reports FABA0330E and FABA0329E. * * Upon rerun the error messages no * * longer occur. * * 3. SDEP pointer errors are being * * detected by the OPC, but not by * * FABADA3 when TYPRUN=RPT or * * TYPRUN=PTRALL are specified. * * 4. OPC gets FPX0061E and FPX0080E * * messages with RC=04 when running * * with High Performance Image Copy * * (HPIC). * * 5. OPC reports an error when data block * * ID in IOVF SPACE MAP differs from * * the one in IOVF DATA CI. It is a * * possibility that IMS/ESA V3 FP REORG * * UTILITY was used against this area. * * 6. OPC generates DA3S records with * * incorrect record length. * * 7. OPC supports a new HPIC compression * * routine FABJCMP4. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** There are the following 6 problems and 1 requirement. 1. DBFUHDS0 (within DFSSQPP macro) gets ABENDS0C4 during HSRE running, after /DBR command is issued and then Online Data Extract utility abends ABENDU3500. Because MSG DFS3065 is issued and DMACCAWE is set to x'40000000' during /DBR command processing, but lacks logic to handle DMACCAWE flag for deferred global stop. This is an Forward Fit of APAR PK06923 of FP Online Tools V2R1. 2. OPC reports FABA0330E and FABA0329E, however, the error AREA messages no longer occur if rerun OPC. It is because that SDCH CALL TYPE-1 does not work as we expected. The call in IMS does not force IMS to discard the CI RBA, it just causes IMS to write that RBA. OPC only issued TYPE-1 call when the requested read RBA is bigger than the last hardened CI RBA, so it might cause some SDEP segments not be hardened. This is an Forward Fit of APAR PK08791 of FP Online Tools V2R1. 3. SDEP pointer errors are being detected by OPC, but OPC does not generate any error information for FABADA3 when TYPRUN=RPT or TYPRUN=PTRALL are specified, therefore FABADA3 ends normally. This is an Forward Fit of APAR PK09594 and PK13266 of FP Online Tools V2R1. 4. OPC gets FPX0061E and FPX0080E messages with RC=04 when running with High Performance Image Copy (HPIC). Running without the Image Copy is successful. This is an Forward Fit of APAR PK11395 of FP Online Tools V2R1. 5. OPC checks the CI Allocation status between a pair of IOVF SPACE MAP elements and IOVF DATA CIs. OPC detects the differences of the CI Allocation status, then OPC issues an error message FPX0061E, but that difference is possible when the IOVF SPACE MAP element status is set to Free by IMS/ESA V3 FP REORG UTILITY. This is an Forward Fit of APAR PK11464 of FP Online Tools V2R1. 6. OPC generates DA3S records that are 4 bytes shorter than FPB DEDB Pointer Checker. This is because the FPB DEDB Pointer Checker was enhanced to add 4 bytes of DA3S record to produce the report for "LARGEST DATABASE RECORDS" by PQ58683, but OPC was not affected the enhancement. Therefore, when FABADA3 tried to move DA3S record that is created by OPC, and is near the page boundary, the ABEND0C4 occurs. This is an Forward Fit of APAR PK11613 of FP Online Tools V2R1. 7. OPC supports a new HPIC compression routine FABJCMP4 introduced with HPIC V3R1 PK14105. This is an Forward Fit of APAR PK16856 of FP Online Tools V2R1.
Problem conclusion
Temporary fix
Comments
This APAR solves the following 6 problems and provides 1 enhancement. 1. Current FPO components immediately issue U3500 ABEND when FP utility DL/I call got non blank status code. To handle DMACCAWE flag for deferred global stop, Online Tools components must issue DISC call before U3500 ABEND. OPC and ODE issue DISC call unconditionally before U3500 ABEND by calling a new module FPXAB35x (x is IMS version), when ASMTDLI call error. OAE does not issue DISC call at present before U3500 ABEND because of OAE's RESTART consideration. 2. The macro FPXESDR0 has been modified to issue SDCH CALL TYPE-1 to harden SDEP CI when the requested read RBA is below LE. to the next buffer set. 3. OPC was modified to issue message FPX0061E, generates a CI snap and SDEP pointer record (4,P) including erroneous pointer value, and sets RC=4 when OPC detects incorrect SDEP pointer value. As the result, Pointer Checker FABADA3 verifies these records including the erroneous 4,P records and issue "FABA0329E" message. And message FPX0061E's wording is added as following. FPX0061E -> Severe Error: FPX0061E Segment has incorrect SPTF pointer value. FPX0061E Source SC aa Name xxxxxxxx RBA bbbbbbbb FPX0061E Pointer value: ccccccccdddddddd 4. OPC processes the 120 CIs as a process unit including the IOVF space map and the data CIs. OPC getmains IOVF buffers for the 120 CIs and reuses it. OPC destroyed a continuum region that is being used by the another task. 5. OPC was modified to issue from an error message FPX0061E to an information message FPX0124I when OPC detects the differences between Free IOVF SPACE MAP element and IOVF DATA CI. And a message FPX0124I is added as following. FPX0124I -> Information only: FPX0124I CI Allocation information was discrepant between IOVF CI and IOVF Space Map. FPX0124I RBA of IOVF Space Map CI: xxxxxxxx FPX0124I RBA of target IOVF CI: xxxxxxxx FPX0124I Space Map Element Offset: xxxxxxxx FPX0124I Space Map Element: xxxxxxxx FPX0124I CI Prefix : xxxxxxxxxxxxxxxx 6. OPC was modified to generate DA3S records that have correct length. 7. Since HPIC supports a new compression routine FABJCMP4, which is effective in especially SDEP portion, OPC also supports a compression routine of IC= keyword in SYSIN DD statement. Because of having destroyed a previous buffer while processing of 1st CI when specified the request of a compressed IC with HPIC, OPC got FPX0061E message in RAP portion of the AREA. ======================== = DOCUMENTATION CHANGE = ======================== The IMS High Performance Fast Path Utilities for z/OS User's Guide Volume 3: Fast Path Online Tools Version 2 Release 2(SC18-9239-01) should be changed as follows: Appendixes. Messages: The FPX0061E and FPX0124I message should be added as follows: --------------------------------------------------------------- FPX0061E (One of the texts listed in Explanation) Explanation: (One message text should be added.) Segment has incorrect SPCF or SPTF pointer value. (One message should be added for additional information.) Pointer value --------------------------------------------------------------- FPX0124I (One of the texts listed in Explanation) Explanation: A discrepancy was encountered during pointer checking. This message contains one of the following texts describing the discrepancy encountered: . CI Allocation information was discrepant between IOVF CI and IOVF Space Map element. These messages might be accompanied by additional data to help identify the discrepancy: . RBA of CI: . CI Prefix Data: . Target Element Offset: . Target Element: System Action: Processing continues. User Response: This is an information message. Consult your database administrator to correct the problems with the database if it need. Issuing Module: FPXAERR1 --------------------------------------------------------------- "Part 1. Online Pointer Checker Chapter 3. Using Online Pointer Checker" should be changed as follows: --------------------------------------------------------------- INPUT DASYSIN data set The comprtn description of IC keyword of DASYSIN DD should be changed as follows: "comprtn" specifies the name of the compression routines | that are supported by High Performance Image Copy. To specify the comprtn, High Performance Image Copy is required. ---------------------------------------------------------------
APAR Information
APAR number
PK17686
Reported component name
IMS HP FP UTILI
Reported component ID
5655K9400
Reported release
220
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2006-01-10
Closed date
2006-01-16
Last modified date
2006-02-02
APAR is sysrouted FROM one or more of the following:
PK16857
APAR is sysrouted TO one or more of the following:
UK10837
Modules/Macros
FPXAB350 FPXAB357 FPXAB358 FPXAB359 FPXADBR0 FPXADBT0 FPXAERR0 FPXAERR1 FPXAICW0 FPXAMDAR FPXAPER0 FPXARIV0 FPXARIV7 FPXARIV8 FPXARIV9 FPXARPT0 FPXARPT7 FPXARPT8 FPXARPT9 FPXASDP0 FPXAVSD0 FPXAVSM0 FPXBLOD0 FPXBMBLK FPXBMBL0 FPXBMOP0 FPXBMOP7 FPXBMOP8 FPXBMOP9 FPXBR2C0 FPXBR2C7 FPXBR2C8 FPXBR2C9 FPXBULK0 FPXBULK7 FPXBULK8 FPXBULK9 FPXBW1C0 FPXBW1C7 FPXBW1C8 FPXBW1C9 FPXCMBLK FPXESDR0 FPXESDR7 FPXESDR8 FPXESDR9 FPXEXPN0 FPXEXPN7 FPXEXPN8 FPXEXPN9 FPXGSEG0 FPXGSEG7 FPXGSEG8 FPXGSEG9 FPXLOCER FPXLOCET FPXMBLK FPXMBLK0 FPXMSG00 FPXOPEN1 FPXPANA0 FPXRSDP0 FPXRSDP7 FPXRSDP8 FPXRSDP9 FPXRUOW0 FPXRUOW7 FPXRUOW8 FPXRUOW9 FPXULCK0 FPXULCK7 FPXULCK8 FPXULCK9 FPXUMOP0 FPXUMOP7 FPXUMOP8 FPXUMOP9 FPXUTPA7 H31A220J
| SC18923901 |
Fix information
Fixed component name
IMS HP FP UTILI
Fixed component ID
5655K9400
Applicable component levels
R220 PSY UK10837
UP06/01/17 P F601
[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89D","label":"IMS HP Fast Path Utilities"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"220","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 February 2006