A fix is available
APAR status
Closed as program error.
Error description
HPIC Recovery fails for dynamic allocation of a Change Accumulation data set, when the CATDS option is defined in DBRC and the CA data set has been allocated by another job, because HPIC allocates a CA data set with DISP=OLD when the CATDS option is defined in DBRC.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All IMS High Performance Image Copy for z/OS * * Version 3 Release 1 users ( FMID=H1J0310 ) * **************************************************************** * PROBLEM DESCRIPTION: This APAR fixes following problems: * * * * - HPIC V3.1 abends U3916 ( ABENDU3916 ) * * in recovery function when the * * CATDS(Y) option is defined in the * * DBRC and HPIC tries to dynamically * * allocate the CA data set or the LOG * * data set or the IC data set and any * * of them have already been allocated * * by another job. * * * * - HPIC V3.1 abends U3916 ( ABENDU3916 ) * * in recovery function when CA data set * * and LOG data set are not cataloged * * even if CATDS(Y). * * * * - HPIC V3.1 abends U3916 ( ABENDU3916 ) * * in recovery function when HPIC uses * * the value of the LOGUNIT keyword * * specified in the ICEIN and more than * * one LOG data sets for recovery. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR provides the fix for following problems: - HPIC V3.1 abends U3916 ( ABENDU3916 ) in recovery function when the CATDS(Y) option is defined in the DBRC and HPIC tries to dynamically allocate the CA data set or the LOG data set or the IC data set and any of them have already been allocated by another job. Because HPIC tries to allocate them with DISP=OLD. - HPIC V3.1 abends U3916 ( ABENDU3916 ) in recovery function when CA data set and LOG data set are not cataloged even if the CATDS(Y) option is defined in DBRC. Because HPIC tries to allocate these data sets only with the information of DSN registered in DBRC. - HPIC V3.1 abends U3916 ( ABENDU3916 ) in recovery function when multiple LOG data sets are used and the value of the LOGUNIT keyword specified in the ICEIN is applied. Because HPIC does not use the value of the LOGUNIT keyword except for the first LOG data set.
Problem conclusion
FABJDALC has been modified following items. -To use DISP=SHR parameter for dynamic allocation of a CA data set, LOG data set, and IC data set when the CATDS(Y) option is defined in DBRC -To try to dynamically allocate the CA and LOG data sets using UNIT and VOLSER information registered in DBRC after failing to allocate these data sets relying on the catalog even if the CATDS(Y) option defined in DBRC FABJDBRC has been modified to use the UNIT information of the first LOG data set as that of all the LOG data sets when multiple LOG data sets are used for recovery and the value of the LOGUNIT keyword specified in the ICEIN is applied. FABJDBR7, FABJDBR8, and FABJDBR9 have been reassembled. ======================== = DOCUMENTATION CHANGE = ======================== IMS High Performance Image Copy for z/OS Version 3 Release 1 User's Guide SC18-7617-00 ( SC18761700 ) should be changed as follows: 2.3.5.4 CAUNIT= The CAUNIT keyword specifies the name of the unit where the input change accumulation log data set resides. _______________________________________________________ | | | CAUNIT=unitname | |_______________________________________________________| where: unitname is the unit name of the log data set for dynamic allocation. The following table shows how the HPIC Database Recovery function handles the unit parameter for dynamic allocation. | _________________________________________________________ | | | DBRC Status is CATDS | DBRC Status Is| | | |_______________________________| NOCATDS | | | | input CA is | input CA is | | | | | cataloged | not cataloged | | | |_________|_______________|_______________|_______________| | |CAUNIT= |Ignore CAUNIT= |Use CAUNIT= | Use CAUNIT= | | | unitname|Use catalog | | | | | |information | | | | | | | | | | |_________|_______________|_______________|_______________| | |Omit |Use Catalog |Use unit name | Use unit name | | | CAUNIT= |information |in CA record | in CA record | | | | |in DBRC | in DBRC | | |_________|_______________|_______________|_______________| This keyword can be used in the following control statements: GLOBAL, RCV 2.3.5.33 ICUNIT= The ICUNIT keyword specifies the unit name where the image copy data set resides. _______________________________________________________ | | | ICUNIT=unitname | |_______________________________________________________| where: unitname is the unit name of the input image copy data set for dynamic allocation. The following table shows how the HPIC Database Recovery function and the Create Image Copy function handle the unit parameter for dynamic allocation. _______________________________________________________ | | DBRC Status is CATDS | DBRC Status Is| | |_____________________________| NOCATDS | | | input IC is | input IC is | | | | cataloged | not cataloged| | |_________|______________|______________|_______________| | |ICUNIT= |Ignore ICUNIT=| Use ICUNIT= | Use ICUNIT= | | unitname|Use catalog | | | | |information | | | | | | | | |_________|______________|______________|_______________| |Omit |Use Catalog |Use unit name | Use unit name | | ICUNIT= |information |in IC record | in IC record | | | |in DBRC | in DBRC | |_________|______________|______________|_______________| This keyword can be used in the following control statements: GLOBAL, CRC, RCV 2.3.5.35 LOGUNIT= The LOGUNIT keyword specifies the name of the unit where the input log data set resides. _______________________________________________________ | | | LOGUNIT=unitname | |_______________________________________________________| where: unitname is the unit name of the log data set for dynamic allocation. The following table shows how the HPIC Database Recovery function handles the unit parameter for dynamic allocation. | _________________________________________________________ | | | DBRC Status is CATDS | DBRC Status Is| | | |_______________________________| NOCATDS | | | | input LOG is | input LOG is | | | | | cataloged | not cataloged | | | |_________|_______________|_______________|_______________| | |LOGUNIT= |Ignore LOGUNIT=|Use LOGUNIT= | Use LOGUNIT= | | | unitname|Use catalog | | | | | |information | | | | | | | | | | |_________|_______________|_______________|_______________| | |Omit |Use Catalog |Use unit name | Use unit name | | | LOGUNIT=|information |in LOG record | in LOG record | | | | |in DBRC | in DBRC | | |_________|_______________|_______________|_______________| This keyword can be used in the following control statements: GLOBAL, RCV
Temporary fix
Comments
APAR Information
APAR number
PK04525
Reported component name
IMS HP IMAGE CO
Reported component ID
5655K9600
Reported release
310
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2005-04-20
Closed date
2005-04-28
Last modified date
2005-06-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK03037
Modules/Macros
FABJDALC FABJDBRC FABJDBR7 FABJDBR8 FABJDBR9
| SC18761700 |
Fix information
Fixed component name
IMS HP IMAGE CO
Fixed component ID
5655K9600
Applicable component levels
R310 PSY UK03037
UP05/05/03 P F505
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Line of Business":{"code":null,"label":null},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89E","label":"IMS HP Image Copy"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"310"}]
Document Information
Modified date:
14 December 2020