APAR status
Closed as new function.
Error description
Adjustments will be made to FABADA3 and FABADA5 DDNAMES to help customers avoid JCL errors during migration to FPB. FABADA3 changes (DD name needed / Current FPB DD name): DAR13S / DAR13SI DAR3CS / DAR3CSI DAR13R / DAR13O SORT13R / SORTR13 FABADA5 changes (DDNAME needed / Current FPB DDNAME): DAR12 / DAR12I DAR13R / DAR13I This is a forward fit APAR of FPB V1R2 APAR PK04275.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All DEDB Pointer checker users of High * * Performance Fast Path Utilities FP Basic * * Tools Version 2 Release 1 (FMID: H31A210). * **************************************************************** * PROBLEM DESCRIPTION: Forward Fit APAR of FPB V1R2 PK04275: * * 1) Pointer Checker FABADA3 provides an * * enhancement to support new DDs DAR13S, * * DAR3CS, DAR13R and SORT13R as a * * substitute for DAR13SI, DAR3CSI, DAR13O * * and SORTR13. * * * * 2) Pointer Checker FABADA5 provides an * * enhancement to support new DDs DAR12 * * and DAR13R as a substitute for DAR12I * * and DAR13I. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** Forward Fit APAR of FPB V1R2 PK04275: 1) Pointer Checker FABADA3 provides an enhancement to support new DDs DAR13S, DAR3CS, DAR13R and SORT13R as a substitute for DAR13SI, DAR3CSI, DAR13O and SORTR13. 2) Pointer Checker FABADA5 provides an enhancement to support new DDs DAR12 and DAR13R as a substitute for DAR12I and DAR13I.
Problem conclusion
Temporary fix
Comments
Pointer Checker FABADA3 accepts new DDs DAR13S, DAR3CS, DAR13R and SORT13R. Pointer Checker FABADA5 accepts new DDs DAR12 and DAR13R. The new DDs DAR13S, DAR3CS, DAR13R and SORT13R are used as alternative DDs to existent DDs DAR13SI, DAR3CSI, DAR13R and SORTR13 by FABADA3. The new DDs DAR12 and DAR13R are used as alternative DDs to existent DDs DAR12I and DAR13I by FABADA5. Users can specify alternative DDs respectively instead of existent DD statements. If both existent DD and alternative DD are specified in the JCL, FABADA3 and FABADA5 uses the existent DD. For example, if both DAR13SI DD and DAR13S DD are specified, FABADA3 uses DAR13SI DD and ignores DAR13S DD. FABADA3 module and macro change; The macro DA3INIA0 has been modified to support alternative DDs DAR13S and DAR3CS. The macro DA3INIB0 has been modified to support alternative DDs DAR13R and SORT13R. The macro DA3WRK10 has been modified to add DDname saveareas. Existent DDnames are defined in these savearea at first, but when alternative DDs are specified in the JCL, replace existent DDnames with alternative ones. The macro DA3MSGT0 has been modified as follows; 1) Define DDname field equation for FABA3550E and FABA3552E message so that DDnames can be changed. 2) Change FABA3545E messages Return code field Equation so that remove a trash. The macro DA3EOJR0 has been modified to set DDname to FABA0305I and FABA0315I message text from DDname saveareas. The macro DA3BTBL0 has been modified to set DDname to FABA3550E message text from DDname saveareas. The macro DA3MAIN0 has been modified to set DDname to FABA3552E message text from DDname saveareas. The macro DA3SORT0 has been modified to change SORTR13 DDname check process in order to support alternative DDs SORT13R. The module FABADA3 was reassembled. The message FABA3552E was no longer issued from the module FABADA3. FABADA5 module and macro change; The macro DA5INIT0 has been modified to support alternative DDs DAR12 and DAR13R. The macro DA5WRK10 has been modified to add DDname saveareas. Existent DDnames are defined in these savearea at first, but when alternative DDs are specified in the JCL, replace existent DDnames with alternative ones. The macro DA5MSGT0 has been modified as follows; 1) Define DDname field equation for FABA3561E and FABA0505W message so that DDnames can be changed. 2) Change FABA3545E messages Return code field Equation so that remove a trash. The macro DA5GDAR0 has been modified to set DDnames to FABA3560E message text from DDname saveareas. The macro DA5T1XP0 has been modified to set DDname to FABA0505W message text from DDname saveareas. The macro DA5MAIN0 has been modified to set DDname to FABA3561E message text from DDname saveareas. others; The macro FABDWTO has been modified to set message text to WTO message buffer correctly in order to remove a trash. The module FABAWTO was reassembled. ======================== = DOCUMENTATION CHANGE = ======================== Documentation Changes: The IMS High Performance Fast Path Utilities for z/OS User's Guide Volume 2: Fast Path Basic Tools Version 2 Release 1 (SC18-9238-00) should be changed as follows: Part 2. DEDB Pointer Checker Chapter 3. Using DEDB Pointer Checker utility Job Control Language FABADA3 JCL DAR13S, DAR3CS, DAR13R and SORT13R should be added to Table 7. FABADA3 DD statements. +---------------+---------------+--------------+--------------+ |DDNAME |Use |Format |Need | +---------------+---------------+--------------+--------------+ |DAR13S |Input | |Required | +---------------+---------------+--------------+--------------+ |DAR3CS |Input | |Required | +---------------+---------------+--------------+--------------+ |DAR13R |Output | |Optional | +---------------+---------------+--------------+--------------+ |SORT13R |Output |LRECL=80 |Optional | +---------------+---------------+--------------+--------------+ Next descriptions are added to the following DD statements explanations. DAR13SI DD If this DD statement is not specified in the JCL statement, the DAR13S DD statement is used as an alternative DD. DAR3CSI DD If this DD statement is not specified in the JCL statement, the DAR3CS DD statement is used as an alternative DD. DAR13O DD If this DD statement is not specified in the JCL statement, the DAR13R DD statement is used as an alternative DD. SORTR13 DD If this DD statement is not specified in the JCL statement, the SORT13R DD statement is used as an alternative DD. The following DD statements are added as new DD statements. DAR13S DD If DAR13SI DD is not specified in the JCL statement, this statement is used instead of the DAR13SI DD statement. DAR3CS DD If DAR3CSI DD is not specified in the JCL statement, this statement is used instead of the DAR3CSI DD statement. DAR13R DD If DAR13O DD is not specified in the JCL statement, this statement is used instead of the DAR13O DD statement. FABADA5 JCL DAR13I description is changed in Table 12. FABADA5 DD statements. +---------------+---------------+--------------+--------------+ |DDNAME |Use |Format |Need | +---------------+---------------+--------------+--------------+ |DAR13I |Input | |Required (*1) | +---------------+---------------+--------------+--------------+ DAR12 and DAR13R should be added to Table 12. FABADA5 DD statements. +---------------+---------------+--------------+--------------+ |DDNAME |Use |Format |Need | +---------------+---------------+--------------+--------------+ |DAR12 |Input | |Required | +---------------+---------------+--------------+--------------+ |DAR13R |Input | |Required (*1) | +---------------+---------------+--------------+--------------+ (*1) This data set is required when TYPRUN=RPT or MODEL is specified in FABADA1. Next descriptions are added to the following DD statements explanations. DAR12I DD If this DD statement is not specified in the JCL statement, the DAR12 DD statement is used as an alternative DD. DAR13I DD If this DD statement is not specified in the JCL statement, the DAR13R DD statement is used as an alternative DD. Note: This data set is required when TYPRUN=RPT or MODEL is specified in FABADA1. The following DD statement are added as a new DD statements DAR12 DD If DAR12I DD is not specified in the JCL statement, this statement is used instead of the DAR12I DD statement. DAR13 DD If DAR13I DD is not specified in the JCL statement, this statement is used instead of the DAR13I DD statement. Note: This data set is required when TYPRUN=RPT or MODEL is specified in FABADA1. Appendix N. FPB - Messages and codes FABA messages The FABA0315I, FABA3550E, FABA3561E, and FABA0505W messages descriptions are added as follows: --------------------------------------------------------------- FABA0315I SORT CONTROL CARDS WRITTEN TO DDNAME: ddname Explanation: This message is generated when program FABADA3 has generated and written the required sort control statements to the file associated with the ddname(SORTR13 or SORT13R) DD statement. System Action: FABADA3 continues processing. Programmer Response: None. --------------------------------------------------------------- FABA3550E INPUT DATA ("ddname1/ddname2") SEQUENCE ERROR - ddname1 CTR: zzz,zzz,zz9 ddname2 CTR: zzz,zzz,zz9 Explanation: The segment and pointer information records in the input files are not in the sequence required by program FABADA3. System Action: FABADA3 ends with an abend code of 3550. Programmer Response: Make sure that the files associated with the ddname1(DAR13SI or DAR13S) and ddname2(DAR3CSI or DAR3CS) DD statements are correctly specified, and that the ddname2(DAR3CSI or DAR3CS) file has been sorted. Correct any errors and rerun the job. --------------------------------------------------------------- FABA3561E INPUT FILES ("ddname1"/"ddname2") ARE EMPTY Explanation: No records were found in the input files associated with the ddname1(DAR12I or DAR12) and ddname2(DAR13I or DAR13R) DD statements. System Action: Program FABADA5 ends with an abend code of 3561. Programmer Response: Make sure that the files associated with the ddname1(DAR12I or DAR12) and ddname2(DAR13I or DAR13R) DD statements are correctly specified. Correct any errors, and rerun the job. --------------------------------------------------------------- FABA0505W DATA INDICATES "TYPRUN=RPT/MODEL" - FILE: ddname MISSING Explanation: Program FABADA5 expected a file associated with the ddname(DAR13I or DAR13R) DD statement but the file was not present. System Action: FABADA5 sets an end-of-job return code of 4, and continues processing. Programmer Response: Make sure that this situation is not an error condition. If it is an error condition, make sure that a ddname(DAR13I or DAR13R) DD statement is present and that it properly specifies the correct file. Rerun the job. --------------------------------------------------------------- The following Message is deleted from Appendix N. FPB - Messages and codes FABA3552E INPUT FILE ("DAR13SI"/"DAR3CSI") IS EMPTY
APAR Information
APAR number
PK10814
Reported component name
IMS HP FP UTILI
Reported component ID
5655K9400
Reported release
210
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2005-08-23
Closed date
2005-08-28
Last modified date
2005-09-02
APAR is sysrouted FROM one or more of the following:
PK04275
APAR is sysrouted TO one or more of the following:
UK06709
Modules/Macros
DA3BTBL0 DA3EOJR0 DA3INIA0 DA3INIB0 DA3MAIN0 DA3MSGT0 DA3SORT0 DA3WRK10 DA5GDAR0 DA5INIT0 DA5MAIN0 DA5MSGT0 DA5T1XP0 DA5WRKG0 FABADA3 FABADA5 FABAWTO FABDWTO
| SC18923800 |
Fix information
Fixed component name
IMS HP FP UTILI
Fixed component ID
5655K9400
Applicable component levels
R210 PSY UK06709
UP05/08/30 P F508
[{"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":"210","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 September 2005