APAR status
Closed as new function.
Error description
Support LRECL keyword for USR data set and 2-digits area number for the data set mask in Unload processing. This is a result of FITS REQ MR0728063231 and MR0728065036.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of High Performance Fast Path * * Reorganization Tool Version 2 Release 2. * * (FMID: H31A220) * **************************************************************** * PROBLEM DESCRIPTION: This APAR provides solutions for the * * following requirements for HPFP Reorg * * Tool (requirement number: MR0728063231) * * 1. Support LRECL keyword for USR * * data set. * * 2. 2-digits area number for the data * * set mask in Unload processing. * * 3. It may happen HPFP Reorganization * * determines the incorrect LRECL value in * * case of the follows; * * - FORMAT=TFMT * * - Changed DBD definition in NEWACB is * * specified. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** 1. Users have to specify the LRECL values for the unloaded segment data records file by the JCL DD when they want to change the system determined LRECL value. 2. HPFP Reorg supports only 3 and 5 digits area number (&AREA# and &AREA5#) for the data set mask. The mask variable &AREA5# is generalized to &AREAn# (n = 1 to 5) to generate n-digit relative area number. 3. It may happen HPFP Reorganization determines the incorrect LRECL value in case of the follows; - FORMAT=TFMT - Changed DBD definition in NEWACB is specified. This potential defect was found during improving 1 and 2 items.
Problem conclusion
Temporary fix
Comments
1-1. Support LRECL keyword parameter for UNLOAD command to specify DCB LRECL value through the command instead of specifying it in the JCL DD statement. The specification of the LRECL keyword parameter format is completely same as of FPB V2R2 FABCUR1 (DEDB Unload) except default value. See "DOCUMENTATION CHANGE" below for the detail specification of the new LRECL keyword. 1-2. The message HFPF0003W is enhanced to describe more detail information when LRECL or BLKSIZE is overridden by the system determined value. 2-1. The mask variable &AREA5# is generalized to &AREAn# (n = 1 to 5) to generate n-digit relative area number for the following keyword to generate data set name. - DSNAME - IDSNMASK - LIKE - ODSNMASK 2-2. When mask variable &AREAn# is used for an area which relative area number is greater than n-digit, for example, &AREA2# is used for an area which relative area number is greater or equal to 100, the mask variable is not converted to the relative area number and HFPU0099E will be expected. 3. During enhancing LRECL keyword and &AREAn# mask, one internal defect was detected that following modules call HFPTFRM0 with providing CCTIDDT instead of CCTODDT to convert USR record format from DBT to TFMT: HFPJINI0 HFPJOMN0 HFPJSDP0 HFPJUSR0 These modules has been corrected, too. ======================== = DOCUMENTATION CHANGE = ======================== IMS High Performance Fast Path Utilities for z/OS, V2R2, Vol.1 High Performance Fast Path Reorganization Tool, User's Guide (SC18-7615-02) should be changed as follows: Replace &AREA5# mask to &AREAn# mask in A.17 DSNAME, A.31 IDSNMASK, A.40 LIKE and A.46 ODSNMASK as follows: Before: &AREA5# Five-digit relative area number After: &AREAn# N-digit relative area number n is from 1 to 5. When mask variable &AREAn# is used for an area which relative area number is greater than n-digit, for example, &AREA2# is used for an area which relative area number is greater or equal to 100, the mask variable is not converted to the relative area number and HFPU0099E will be expected. Add the new keyword LRECL at the UNLOAD command in the table 33 of 3.1 Commands, subcommands, and keywords | UNLOAD | FILECTL | AREA_INFORMATION_RECORD | | | | : | | | | KEYSEQCHK | | | | | LRECL | | | | OAREA | | | | : | Add an entry for the new keyword LRECL in the table 35 of 3.2 Keywords. | | LRECL | specify how to determine the LRECL of | | | an unloaded segment records file when | | | it is not specified in the DD control | | | statement explicitly. | Add the new keyword LRECL in 5.3.1.1 UNLOAD command keywords. | | | KEYSEQCHK | | | LRECL | | OAREA | | | LRECL An optional keyword to specify how to determine the LRECL of an unloaded segment records file when it is not specified in the DD control statement explicitly. For information about coding this parameter, see "LRECL" in topic A.4x. ---------------------- Add the following new keyword LRECL in A.0 Appendix A. Command reference, next to A.40 LIKE. A.4x LRECL Use this keyword to specify how to determine the LRECL of an unloaded segment records file when it is not specified in the DD control statement explicitly. LRECL is an optional keyword for the UNLOAD command. Related keywords: FORMAT Format ___________________________________________ | | | LRECL=parameter | | | |___________________________________________| parameter Specify one of the following parameters; SEGMENT LRECL is determined based on the maximum length of segments defined in DBD, This is the default. SEGTFMT LRECL is determined based on the basis of maximum length of segments and the maximum number of levels in DBD by specifying LRECL=SEGTFMT together with the FORMAT=TFMT keyword parameter. Restriction: Even though LRECL=SEGTFMT is specified, the number 3 is used as the maximum number of levels when the SDEP=PHYSICAL option is specified and the maximum number of segment levels is less than 3. BLOCK LRECL is determined as BLKSIZE - 4. nnnnn Value of LRECL. The value can be up to 32760. When the value is not appropriate, system determined appropriate minimum value is overridden. LRECL is determined based on the following rules. 1. The value of LRECL in JCL DD when it is specified. If the value is not appropriate, valid one is determined and applied. 2. The parameter of the LRECL keyword. 3. The parameter of the LRECL keyword in site default. 4. When DISP=NEW and no LRECL is specified, LRECL=SEGMENT is used. Default: SEGMENT Add the new keyword LRECL in the related keywords of A.79 UNLOAD Add the new keyword LRECL in F.3 Keywords that can be registered as site defaults in a site default table. UNLOAD AREA_INFORMATION_RECORD, COMPRESS, FORMAT, ICACHE, KEYCHGCHK | KEYSEQCHK, LRECL, PAD, PTRCHK, SDEP, SSP Add a new message HFPC0016I in G.3.2 HFPC messages. HFPC0016E LRECL=SEGTFMT NEEDS FORMAT=TFMT. Explanation: Program HFPMAIN0 found that LRECL=SEGTFMT was specified in HFPSYSIN or site default. However, FORMAT keyword is not TFMT. System Action: If a keyword other than SCAN=NO is specified, the return code is set to 8. Or if SCAN=NO is specified, the job ends with an abend code of U3003. Programmer Response: If you want to process LRECL=SEGTFMT, specify the correct FORMAT keyword. Message text of the HFPF0003W in G.3.4.3 HFPF0003W changed as follows: Before: HFPF0003W BLKSIZE FOR DDNAME: ddname IS OVERRIDDEN BY SYSTEM DETERMINED VALUE. Explanation: The block size for the USR file that was specified in ddname was incorrect. Program HFPMAIN0 overrides the block size with the system value. After: HFPF0003W {LRECL|BLKSIZE} FOR DDNAME: ddname IS OVERRIDDEN BY SYSTEM DETERMINED VALUE. - SPECIFIED {LRECL|BLKSIZE} TOO SMALL OR TOO LARGE - {LRECL|BLKSIZE} SPECIFIED: nnnnn - {LRECL|BLKSIZE} OVERRIDDEN: nnnnn Explanation: The LRECL or BLKSIZE for the USR file that was specified in ddname was incorrect. Program HFPMAIN0 overrides the LRECL or BLKSIZE with the system value.
APAR Information
APAR number
PK30851
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-09-01
Closed date
2006-10-05
Last modified date
2006-11-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK18585
Modules/Macros
HFPCCCT0 HFPCCDT0 HFPCDEF0 HFPCINI0 HFPFTTI0 HFPFUSR0 HFPJINI0 HFPJOMN0 HFPJSDP0 HFPJUSR0 HFPLCCI0 HFPLCCT0 HFPLCC10 HFPLCC20 HFPLCC30 HFPLCC40 HFPLLCT0 HFPLLST0 HFPLNST0 HFPLOFT0 HFPLOPT0 HFPLRPT0 HFPLRST0 HFPLTST0 HFPLXST0 HFPTFRM0 HFPUGOP0 HFPUMASK HFPUMSK0 HFPUROB0 HFPWMTC0 HFPWMTF0 HFPZCCT HFPZFCT HFPZFTT HFPZROB
| SC18761502 |
Fix information
Fixed component name
IMS HP FP UTILI
Fixed component ID
5655K9400
Applicable component levels
R220 PSY UK18585
UP06/10/07 P F610
[{"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 November 2006