APAR status
Closed as new function.
Error description
The FPA UNLOAD and CHANGE function are being enhanced to output sequence error segments in a dataset. This issue is implemented as a result of FITS requirements MR0917074429, MR091707399, and MR0418077239.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of Fast Path Advanced Tool * * Version 3 Release 2. (FMID: H31A320) * **************************************************************** * PROBLEM DESCRIPTION: The FPA UNLOAD and CHANGE function are * * being enhanced to output sequence * * error segments in a data set. * * (FITS requirement MR0917074429, * * MR091707399, and MR0418077239) * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** The UNLOAD and CHANGE function output sequence error segments into a data set when HFPSEQER DD statement is specified and either KEYSEQCHK=BYPASS or KEYSEQCHK=WARNING is specified.
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 added as follows: Chapter 2. Fast Path Advanced Tool Job control language (JCL) DD statements Table 1. DD statement for program HFPMAIN0 The following lines should be added as follows: DDNAME | USE | |Possibility |Necessity(R:Required, | | |of dynamic |O:Optional,-:N/A) |(I:Input,|Format|allocation +-+-+-+-+-+-+- |O:Output)| |(Y:Yes,N:No)|U|R|C|A|D|E|R | | | |N|E|H|N|M|X|E | | | |L|L|A|A|A|T|O | | | |O|O|N|L|C|R|R | | | |A|A|G|Y|P|A|G | | | |D|D|E|Z|R|C| | | | | | | |E|T|T| ----------+-------------------------------------------------- | HFPSEQER | O | PS | N |O|-|O|-|-|-|- Output This section describes the DD statements that are used to define output. HFPSEQER DD Table xx summarizes the characteristics of the HFPSEQER DD statements. Table xx. HFPSEQER DD statements |Possibility of |Necessity Format|dynamic allocation|(R:Required, | (Y:Yes,N:No) |O:Optional) | |-+-+-+-+-+-+- | |U|R|C|A|D|E|R | |N|E|H|N|M|X|E | |L|L|A|A|A|T|O | |O|O|N|L|C|R|R | |A|A|G|Y|P|A|G | |D|D|E|Z|R|C| | | | | |E|T|T| ------+------------------+--------------- PS | N |O|-|O|-|-|-|- ------+------------------+-+-+-+-+-+-+-- An optional DD statement for the UNLOAD and CHANGE commands. This statement defines the output data set that contains the sequence error segment data records for one or more areas. This statement defines an output data set for the sequence error segment data records that are produced for one or more of the areas defined in the "output" ACB library (NEWACB DD statement or IMSACB DD statement in Reorg mode). This data set is used when you specify KEYSEQCHK=BYPASS or KEYSEQCHK=WARNING. Chapter 5. Unloading a DEDB Job control language (JCL) DD statements Table 43. DD statement for the UNLOAD command The following lines should be added as follows: DDNAME | USE | |Possibility of |Necessity |(I:Input,|Format|dynamic allocation|(R:Required, |O:Output)| | (Y:Yes,N:No) |O:Optional) ---------+-------------------------------------------------- | HFPSEQER | O | PS | N | O Output This section describes the DD statements that are used to define output. HFPSEQER DD This statement defines the output data set that contains the sequence error segment data records for one or more areas. For details, see the description of "HFPSEQER DD statement" on page xx. Chapter 7. Changing a DEDB Job control language (JCL) DD statements Table 45. DD statement for the CHANGE command The following lines should be added as follows: DDNAME | USE | |Possibility of |Necessity |(I:Input,|Format|dynamic allocation|(R:Required, |O:Output)| | (Y:Yes,N:No) |O:Optional) ---------+-------------------------------------------------- | HFPSEQER | O | PS | N | O Output This section describes the DD statements that are used to define output. HFPSEQER DD This statement defines the output data set that contains the sequence error segment data records for one or more areas. For details, see the description of "HFPSEQER DD statement" on page xx. Appendix B. Sample reports Unloaded report SUMMARY OF KEY SEQUENCE ERRORS ERROR SEGMENTS WRITTEN TO HFPSEQER DATA SET The number of the segments that were written to HFPSEQER DATA SET in unloading process. This information is provided only when HFPSEQER DD statement is specified and either KEYSEQCHK=BYPASS or KEYSEQCHK=WARNING is specified. Appendix H. Message and Codes HFPF messages The explanation of message HFPF0003W is changed. Explanation: The LRECL or BLKSIZE for the USR file or the sequence error segment records file that was specified in ddname was incorrect. Program HFPMAIN0 overrides the LRECL or BLKSIZE with the system value. The new message HFPF0011I is added. HFPF0011I ONE OR MORE SEQUENCE ERROR SEGMENTS WERE WRITTEN TO DATA SET. - DDNAME: HFPSEQER, DSNAME: dsname Explanation: One or more sequence error segments were written to the data set dsname that was specified in the HFPSEQER DD statement. System action: Processing continues. Programmer response: None. Appendix x. Sequence error segment records file +-----------Product-Sensitive Programming Interface---------+ | | You can use the HFPZSER macro to map these records. Table xx shows the layout, which is a product-sensitive programming interface. Table xx. Sequence error segment records layout ---------------+----------+---------------------------------- Field name |Assembler |Description |definition| ---------------+----------+---------------------------------- | |"RDW"fields ---------------+----------+---------------------------------- SERRDW |H H |RDW"LL"field | |RDW"ZZ"field ---------------+----------+---------------------------------- SERDBD_NAME |CL8 |DBD name ---------------+----------+---------------------------------- SERAREA_NAME |CL8 |Area name ---------------+----------+---------------------------------- SERAREA_NUMBER2|XL2 |Area number ---------------+----------+---------------------------------- SERSEGNAME |CL8 |Segment name ---------------+----------+---------------------------------- SERSEGLEVEL |XL1 |Segment level ---------------+----------+---------------------------------- SERSEGCODE |XL1 |Segment code ---------------+----------+---------------------------------- SERSCSQ2 |XL1,XL3 |Seg-Code/Seg Seq. Field for | |Hierarchical Level 2 | |Direct Dependent segments (binary | |zeros for Root Segment) | | - First byte is seg-code of the | | segment in this Segment data | | record | | - Second-forth bytes are a | | sequential counter of the | | occurrence of this segment type | | within this database record ---------------+----------+---------------------------------- SERSCSQ3 |XL1,XL3 |Seg-Code/Seg Seq. Field for | |Hierarchical Level 3 | |Direct Dependent segments (binary | |zeros for Root Segment) ---------------+----------+---------------------------------- SERSCSQ4 |XL1,XL3 |Seg-Code/Seg Seq. Field for | |Hierarchical Level 4 | |Direct Dependent segments (binary | |zeros for Root Segment) ---------------+----------+---------------------------------- SERSCSQ5 |XL1,XL3 |Seg-Code/Seg Seq. Field for | |Hierarchical Level 5 | |Direct Dependent segments (binary | |zeros for Root Segment) ---------------+----------+---------------------------------- SERSCSQ6 |XL1,XL3 |Seg-Code/Seg Seq. Field for | |Hierarchical Level 6 | |Direct Dependent segments (binary | |zeros for Root Segment) ---------------+----------+---------------------------------- SERSCSQ7 |XL1,XL3 |Seg-Code/Seg Seq. Field for | |Hierarchical Level 7 | |Direct Dependent segments (binary | |zeros for Root Segment) ---------------+----------+---------------------------------- SERSCSQ8 |XL1,XL3 |Seg-Code/Seg Seq. Field for | |Hierarchical Level 8 | |Direct Dependent segments (binary | |zeros for Root Segment) ---------------+----------+---------------------------------- SERSCSQ9 |XL1,XL3 |Seg-Code/Seg Seq. Field for | |Hierarchical Level 9 | |Direct Dependent segments (binary | |zeros for Root Segment) ---------------+----------+---------------------------------- SERSCSQA |XL1,XL3 |Seg-Code/Seg Seq. Field for | |Hierarchical Level 10 | |Direct Dependent segments (binary | |zeros for Root Segment) ---------------+----------+---------------------------------- SERSCSQB |XL1,XL3 |Seg-Code/Seg Seq. Field for | |Hierarchical Level 11 | |Direct Dependent segments (binary | |zeros for Root Segment) ---------------+----------+---------------------------------- SERSCSQC |XL1,XL3 |Seg-Code/Seg Seq. Field for | |Hierarchical Level 12 | |Direct Dependent segments (binary | |zeros for Root Segment) ---------------+----------+---------------------------------- SERSCSQD |XL1,XL3 |Seg-Code/Seg Seq. Field for | |Hierarchical Level 13 | |Direct Dependent segments (binary | |zeros for Root Segment) ---------------+----------+---------------------------------- SERSCSQE |XL1,XL3 |Seg-Code/Seg Seq. Field for | |Hierarchical Level 14 | |Direct Dependent segments (binary | |zeros for Root Segment) ---------------+----------+---------------------------------- SERSCSQF |XL1,XL3 |Seg-Code/Seg Seq. Field for | |Hierarchical Level 15 | |Direct Dependent segments (binary | |zeros for Root Segment) ---------------+----------+---------------------------------- SERSEGPKEYL |XL2 |The length of SERSEGPKEYL ---------------+----------+---------------------------------- SERSEGPKEY |XLnnn |Parent's Concatenated Key ---------------+----------+---------------------------------- SERSEGDATA |XLnnn |Segment Data | |1st two bytes of SERSEGDATA is the | |length of the segment ---------------+----------+---------------------------------- | | +----End of Product-Sensitive Programming Interface---------+
APAR Information
APAR number
PK61987
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-02-29
Closed date
2008-03-17
Last modified date
2008-04-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK34631
Modules/Macros
HFPCCCT0 HFPFINI0 HFPFSER0 HFPFTRM0 HFPFTTI0 HFPJRAP0 HFPJUSR0 HFPLINF0 HFPLOPT0 HFPMDCB0 HFPTFLD0 HFPTKEY0 HFPTUCL0 HFPTWSE0 HFPULOCK HFPUMCT0 HFPUMVT0 HFPUROB0 HFPWMTF0 HFPYEBT0 HFPYECID HFPYEDB0 HFPYESR0 HFPYSER0 HFPZCCT HFPZDCB HFPZMCT HFPZMVT HFPZROB HFPZSER HFPZTTT HFPZTVT H31A320J
| SC18986903 |
Fix information
Fixed component name
IMS HP FP UTILI
Fixed component ID
5655K9400
Applicable component levels
R320 PSY UK34631
UP08/03/20 P F803
[{"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:
01 April 2008