APAR status
Closed as new function.
Error description
1. Forward fit of APAR PK11925 and requested from FITS MR090605171 - TRIMAR LRECL enhancement is needed for FABCUR6. . 2. Forward fit of APAR PK14651. FABCUR6 / FABCUR7 enhancement to support an empty AREA when AREA_INFORMATION_RECORD=NO option is specified.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All DEDB Unload/Reload users of High * * Performance Fast Path Utilities FP Basic * * Tools Version 2 Release 2 (FMID: H31A220). * **************************************************************** * PROBLEM DESCRIPTION: Forward Fit APAR of FPB V1R2 PK11925 * * and PK14651: * * 1. FPB DEDB Unload (FABCUR1) already * * supports Trimar LRECL for unloaded * * segment records file but FABCUR6 * * doesn't do yet. Same Trimar LRECL * * enhancement is needed for FABCUR6. * * This is FITS MR090605171 requirement. * * * * 2. FABCUR6 / FABCUR7 enhancement to * * support an empty AREA when * * AREA_INFORMATION_RECORD=NO option is * * specified. * **************************************************************** * RECOMMENDATION: * **************************************************************** Forward Fit APAR of FPB V1R2 PK11925 and PK14651: 1. This enhancement generates the unloaded segment file of the Trimar's format with the same LRECL value as OEM tools. This enhancement is for Fits MR090605171. 2. FABCUR6 / FABCUR7 enhancement to support an empty AREA when AREA_INFORMATION_RECORD=NO option is specified.
Problem conclusion
Temporary fix
Comments
This enhancement solves Fits MR090605171. 1.This APAR introduces a new LRECL control statement and SEGTFMT parameter in FABCUR6 UR6CTL DD statement. The combination of FORMAT=TFMT and LRECL=SEGTFMT indicates that FABCUR6 generates the unloaded segment file of the Trimar's format with the same LRECL value as OEM tools. LRECL= SEGTFMT Generates the unloaded segment file of the TFMT format that applies the minimum LRECL value based on the maximum number of segment levels defined in DBD. This parameter becomes effective by specifying together FORMAT=TFMT control statement. The module FABC6GCD has been modified to add LRECL= control statement in SYSIN DD statement. The module FABC6INI has been modified to determine LRECL. The module FABC6PUT has been modified to check the length of unloaded file record and the length of opened LRECL value. The module FABC6MGT has been modified to add new message table. The module FABCUR6X has been reassembled. The macro FABC6BLK has been modified to introduce the flag for LRECL= control statement. The macro UR67DCCI has been modified to introduce the new OPEN LRECL field for LRECL=SEGTFMT. 2. Since FABCUR1 with AREC=N option on APAR PK14830 generates a new special record for an empty AREA, FABCUR7 (DEDB Unloaded Segment Data Set Retrieve utility) and FABCUR6 (DEDB Reload Segment Data Set Create utility) support this one. FABCUR7 ignores the special record that is found in input unloaded segment file when AREA_INFORMATION_RECORD=NO option is specified on UR7CTL DD statement. FABCUR6 as well as FABCUR1 (Unload) generates the special record for an empty AREA in the segment records file on condition that AREA_INFORMATION_RECORD=NO, FORMAT=TFMT, LRECL=SEGTFMT, and EMPTY=YES options are specified in UR6CTL DD statement. This modification of FABCUR6 means that handling of EMPTY=YES, which was modified on APAR PK12862, has been changed further. The module FABC6EOF has been modified to generate the special record for an empty AREA in the segment records file. The module FABC6INI has been modified to accept EMPTY=YES option to generate the special record when AREA_INFORMATION_RECORD= NO, FORMAT=TFMT, and LRECL=SEGTFMT options are specified. The module FABC7GET has been modified to ignore the special record when AREA_INFORMATION_RECORD=NO option specified. The module FABC7MGT has been modified to introduce a new error message FABC3962E. The module FABCSREC introduced by the APAR PK14830 is called from FABCUR6 to scan OCT table, and generate the special record for an empty area. ======================== = DOCUMENTATION CHANGE = ======================== The IMS High Performance Fast Path Utilities for z/OS User's Guide Volume 2: Fast Path Basic Tools Version 2 Release 2 (SC18-9238-01) should be changed as follows: Part 4. DEDB Unload/Reload Utilities Chapter 16. DEDB Reload Segment Data Set Create Utility - FABCUR6 FABCUR6 INPUT Control Statements *The following description should be changed as follows, AREA_INFORMATION_RECORD control statement The optional AREA_INFORMATION_RECORD statement specifies whether the area information record will be generated for areas. The AREA_INFORMATION_RECORD statement contains the following: +-----------------------------------------+ | AREA_INFORMATION_RECORD={YES|NO} | | --- | +-----------------------------------------+ AREA_INFORMATION_RECORD= The optional AREA_INFORMATION_RECORD statement specifies whether the area information record will be generated for areas. YES Indicates that area information records will be generated NO Indicates that no area information records will be generated for areas. | EMPTY=YES keyword parameter of the USERCTL control statement | will be ignored except when AREA_INFORMATION_RECORD=NO, | FORMAT=TFMT, and LRECL=SEGTFMT control statements are | specified. An abbreviation AIR is used for AREA_INFORMATION_RECORD. *A new LRECL Control Statement should be added as follows: +--------------------------------------+ | LRECL=SEGTFMT | +--------------------------------------+ LRECL= The LRECL statement is composed of: SEGTFMT LRECL is determined based on the maximum length of segments and the maximum number of segment levels defined in DBD by specifying together FORMAT=TFMT control statement. Appendix N. FPB - Messages and Codes FABC messages *New message descriptions should be added as follows: --------------------------------------------------------------- FABC0658E - INVALID LRECL= CONTROL CARD - SYNTAX ERROR DETECTED Explanation: Self-explanatory. System Action: Program FABCUR6 discards the control statement, sets an internal flag, and continues processing. Programmer Response: Correct the control statement, and rerun the job. ---------------------------------------------------------------- FABC0659E - INVALID LRECL= CONTROL CARD - "LRECL=" PREVIOUSLY SPECIFIED Explanation: The LRECL= control card has been already specified. System Action: Program FABCUR6 discards the control statement, sets an internal flag, and continues processing. Programmer Response: Correct the control statement, and rerun the job. ---------------------------------------------------------------- FABC0660W - BLKSIZE FOR DDNAME ddname IS OVERRIDDEN BY SYSTEM DETERMINED VALUE - SPECIFIED BLKSIZE TOO SMALL OR TOO LARGE - BLKSIZE SPECIFIED: mmmmm - BLKSIZE OVERRIDDEN: nnnnn FABC0660W - LRECL FOR DDNAME ddname IS OVERRIDDEN BY SYSTEM DETERMINED VALUE - SPECIFIED LRECL TOO SMALL OR TOO LARGE - LRECL SPECIFIED: mmmmm - LRECL OVERRIDDEN: nnnnn Explanation: This message is issued when BLKSIZE/LRECL is specified in JCL but its value is either smaller than the minimum or larger than the maximum tolerance level. System Action: Program FABCUR6 continues processing. Programmer Response: None. ---------------------------------------------------------------- FABC3962E - SPECIAL RECORD FOUND WHEN AREA_INFORMATION_RECORD= YES WAS SPECIFIED Explanation: FABCUR7 found the special record in unloaded segment file when AREA_INFORMATION_RECORD=YES was specified. System Action: FABCUR7 abends with user code of 3962. Programmer Response: Specify correct unloaded file or specify AREA_INFORMATION_RECORD=NO control statement, and rerun the job.
APAR Information
APAR number
PK15840
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
2005-11-28
Closed date
2005-12-08
Last modified date
2006-01-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK09898
Modules/Macros
FABALINK FABCSREC FABCUR6X FABC6BLK FABC6EOF FABC6GCD FABC6INI FABC6MGT FABC6PUT FABC7GET FABC7MGT H31A220J UR67DCCI
| SC18923801 |
Fix information
Fixed component name
IMS HP FP UTILI
Fixed component ID
5655K9400
Applicable component levels
R220 PSY UK09898
UP05/12/09 P F512
[{"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:
04 January 2006