APAR status
Closed as new function.
Error description
This APAR enhances the Fast Path Advanced Tool UNLOAD function to be able to analyze the UOW in error found during unload. This is based off of FITS MR0917075426 requirement.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of High Performance Fast Path * * Utilities Fast Path Advanced Tool Version 3 * * Release 2 (FMID: H31A320). * **************************************************************** * PROBLEM DESCRIPTION: Fast Path Advanced Tool UNLOAD function * * to be able to analyze the UOW in error * * found during unload. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** FPA Unload function supports for a new keyword option PTRCHK=DETAIL. This new option PTRCHK=DETAIL can analyze the UOW in error found during unload process, and provide the pointer error information to the Unloaded report. In addition, when CISNAP=YES is specified, Pointer Chain Reconstruction report and CI Map/CI Dump report are generated at the same time. This is based off of FITS MR0917075027 and MR0917075426 requirements.
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== The IMS High Performance Fast Path Utilities for z/OS User's Guide Volume 1: Fast Path Advanced Tool Version 3 Release 2 (SC18-9869-03) should be changed as follows: ---------------------------------------------------------------- Chapter 2. Fast Path Advanced Tool Job control language (JCL) DD statements Table 1. DD statements for program HFPMAIN0 | | | | | | | A | D | E | | | | | U | R | C | N | M | X | | | | | N | E | H | A | A | T | R | | | | L | L | A | L | C | R | E | | | | O | O | N | Y | P | A | O | | | | A | A | G | Z | R | C | R | | | | D | D | E | E | T | T | G --------+---+----+---+---+---+---+---+---+---+--- | HFPASNAP| O | PS | N | O | O | O | O | - | - | O HFPASNAP DD Table 30. HFPASNAP DD statements | |UNLOAD|RELOAD|CHANGE|ANALYZE|DMACPRT|EXTRACT|REORG ----+---+------+------+------+-------+-------+-------+------ | PS | N | O | O | O | O | O | O | O | An optional DD statement for the UNLOAD, RELOAD, CHANGE, ANALYZE, and REORG commands. This statement defines the output data set for the CI Map/CI Dump report and the Pointer Chain Reconstruction report. ---------------------------------------------------------------- Chapter 3. Fast Path Advanced Tool command Commands, subcommands, and keywords Table 40. HFPSYSIN commands, subcommands, and keywords Command | Keywords | UNLOAD | CISNAP ---------------------------------------------------------------- Chapter 5. Unloading a DEDB Job control language (JCL) DD statements Table 43. DD statements for the UNLOAD command DDNAME | Use | Format | dynalloc | Necessity ---------+-----+---------+----------+----------- | HFPASNAP | O |LRECL=133| N | O | HFPASNAP DD | This statement defines the output data set for the CI Map/ | CI Dump report and the Pointer Chain Reconstruction report. | This is effective when the PTRCHK=DETAIL, and CISNAP=YES are | specified. For details, see "HFPASNAP DD statement" on page | 40. Input for Unload HFPSYSIN UNLOAD command keywords Figure 21. UNLOAD command keywords | CISNAP | CISNAP | An optional keyword to specify to request the CI Map/CI Dump | report and the Pointer Chain Reconstruction report when the | unloaded area is analyzed concurrently. For information about | coding this parameter, see "CISNAP" on page 217. Output for Unload This section describes the output for unloading a DEDB, which can be one of the following types: - An output data set for all of the database segment records produced for one or more of the areas defined in the output DMB - The Processing Messages report in HFPPRINT - Reports in HFPRPTS - Processed segments statistics records in HFPTOTAL - Image copy data set - Reports produced by IMS High Performance Image Copy | - CI Map/CI Dump report and Pointer Chain Reconstruction | report in HFPASNAP | HFPASNAP | This section describes the HFPASNAP data set, which is used | by the Unload process when PTRCHK=DETAIL and CISNAP=YES are | specified. | Function | This statement defines an output data set that contains the | following reports: | - CI Map/CI Dump report | - Pointer Chain Reconstruction report | Format | This data set contains 133-byte, fixed-length records. It is | recommended that you code your DD statement as follows: | //HFPASNAP DD SYSOUT=A | For more information about HFPASNAP, see Appendix B, | "Sample reports," on page 291. ---------------------------------------------------------------- Appendix A. Command reference CISNAP CISNAP is an optional keyword for the following commands: - ANALYZE - CHANGE - GLOBAL - RELOAD - REORG | - UNLOAD PTRCHK parameter | DETAIL | Print pointer error information in the Unloaded report when | the child or twin segments of any segment has a pointer | error. | Processing resumes with the next valid segment in the | hierarchical chain. UNLOAD Related keywords: | CISNAP Syntax: +-------------------------------------------------+ |>>-- UNLOAD ---------------------------------><- | | | | | | | +- CIANP=---+- NO --+----+ | | | | +- YES -+ | | | | | | | +- PTRCHK=--+- ABEND --+-+ | | +- BYPASS -+ | | | +- DETAIL -+ | +-------------------------------------------------+ ---------------------------------------------------------------- Appendix B. Sample reports In the Unload process, the following reports are generated: | - Reports related to the Analyze process when PTRCHK=DETAIL | is specified. (If pointer error detected) Unloaded report | POINTER ERROR DETAILS | If PTRCHK=DETAIL specifies and the UNLOAD process detects any | pointer errors, the same messages as Resolve Pointers report | are issued. For information about each message, see "Resolve | Pointers report messages" on page 422. ---------------------------------------------------------------- Appendix F. Site default options support Keywords that can be registered as site defaults UNLOAD | AREA_INFORMATION_RECORD, CISNAP, COMPRESS, FORMAT, ICACHE, ICINCOMP, ICNOTIFY, ICOUT, ITASKCTL, KEYCHGCHK, KEYSEQCHK, LRECL, PAD, PTRCHK, SORT, SSP ---------------------------------------------------------------- Appendix H. Messages and codes Messages The following message should be added as follows: ---------------------------------------------------------------- HFPF0012I POINTER ERROR INFORMATION IS NOT PROVIDED BECAUSE THE INPUT DATA SET IS AN IMAGE COPY. - AREA NO: nnnn, AREANAME: areaname Explanation: When an image copy data set is provided as an input data set, PTRCHK=DETAIL option is treated as PTRCHK=BYPASS. Therefore, the pointer error information is not provided. System action: Processing continues. Programmer response: None. ---------------------------------------------------------------- HFPJ0014W POINTER ERROR INFORMATION IS NOT PROVIDED. REASON: xxx - AREA NO: nnnn, AREANAME: areaname Explanation: The pointer error information is not provided because of one of the following reasons: - STORAGE ALLOCATION FAILED FOR THE UOW TABLE - DYNAMIC ALLOCATION FAILED FOR THE REPORT DATA SET - OPEN FAILED FOR THE REPORT DATA SET System action: The return code is set to 4 and processing continues. Programmer response: Correct any errors, and rerun the job. ---------------------------------------------------------------- HFPJ0015W CI MAP/CI DUMP REPORT FOR SDEP IS NOT PROVIDED. REASON: xxx - AREA NO: nnnn, AREANAME: areaname Explanation: The CI map/CI dump report for SDEP is not provided because of one of the following reasons: - DYNAMIC ALLOCATION FAILED FOR THE REPORT DATA SET - OPEN FAILED FOR THE REPORT DATA SET System action: The return code is set to 4 and processing continues. Programmer response: Correct any errors, and rerun the job. ----------------------------------------------------------------
APAR Information
APAR number
PK65351
Reported component name
IMS HP FP UTILI
Reported component ID
5655K9400
Reported release
320
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2008-04-30
Closed date
2008-05-30
Last modified date
2008-06-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK36917
Modules/Macros
HFPAMAN0 HFPA1IN0 HFPA1P10 HFPA1TR0 HFPA4SI0 HFPA4000 HFPCCDT0 HFPCDEF0 HFPFACC0 HFPFADS0 HFPFANA0 HFPFATI0 HFPFMAN0 HFPJAIO0 HFPJMAN0 HFPJMPT0 HFPJSDL0 HFPJUOW0 HFPLANA0 HFPLCC10 HFPLCC30 HFPLRPT0 HFPMDCB0 HFPTADS0 HFPUROB0 HFPVINI0 HFPWMTF0 HFPWMTJ0 HFPZACC HFPZACT HFPZATT HFPZCCT HFPZDCB HFPZROB HFPZTTT
| SC18986903 |
Fix information
Fixed component name
IMS HP FP UTILI
Fixed component ID
5655K9400
Applicable component levels
R320 PSY UK36917
UP08/05/31 P F805
[{"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":"3.2.0","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 June 2008