A fix is available
APAR status
Closed as program error.
Error description
The following matrix indicates what HPIC V3R1 APARs are being forward-fit to HPIC V4R1: . PK01382 - IF NON-RECOVERABLE DB IS SPECIFIED AS THE INPUT DB FOR CIC, HPIC ABENDS WITH U3933 (ABENDU3933). PK05607 - HPIC ABENDS S0C1, WHEN HDPC=O (OR BOTH OF HDPC=Y AND VIC=Y) ARE SPECIFIED IN ICEIN, AND HPIC PROCESSES INDEX DB NOT FORMATTED. PK08786 - HPIC ABENDS WITH S0C4 WHEN HPIC IS UNABLE TO OPEN INPUT DB AND HDPC=Y IS SPECIFIED. PK10314 - THIS APAR INCLUDES FORWARD-FITS FROM HPIC V3R1. PK13450 - HPIC FAILS WITH IEC141I 13-20 WHEN RECFM=U FOR A DATASET THAT IS PRE-ALLOCATED PK13486 - HPIC REGARDS NULL KEY OF FIRST HIDAM INDEX AS ERROR, WHEN VIC=Y,HDPC=Y OR HPIC=O IS SPECIFIED PK14099 - HPIC ABEDNDS WITH S0C4 WHEN HPIC USES INCORRECT REGISTER FOR IMS INTERFACE
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All IMS High Performance Image Copy for z/OS * * Version 4 Release 1 users ( FMID=H1J0410 ) * **************************************************************** * PROBLEM DESCRIPTION: This APAR includes following APARs of * * HPIC V3R2: * * PK01382 , PK05607 , PK08786 , PK10314 * * PK13450 , PK13486 , PK14099 * **************************************************************** * RECOMMENDATION: * **************************************************************** This APAR includes following APAR fixes from IMS High Performance Image Copy for z/OS version 3 release 2: PK01382 fixes following problem: - HPIC Concurrent Image Copy function terminates with ABEND U3933 ( ABENDU3933 ). Because HPIC Concurrent Image Copy function gets an error from DBRC when the input database is defined as NON-RECOVERABLE in DBRC. PK05607 fixes following problem: - HPIC Image Copy function terminates with ABEND S0C1 ( ABEND0C1 ) in the process for a primary index DB or a secondary index DB that is not formatted, when HDPC=O or both of HDPC=Y and VIC=Y keywords are specified in the ICEIN. HPIC tries to continue processing even though it fails in the OPEN process for unformatted DB. As a result, HPIC terminates with ABEND S0C1 ( ABEND0C1 ) in the GET process after the OPEN process. PK08786 fixes following problem: - HPIC Image Copy function terminates with ABEND S0C4 ( ABEND0C4 ) in the HPPC module FABPHSIX, when a severe error occurs in the open process of an input database data set. Because HPIC calls the termination process of HPPC without calling the initialization process of HPPC. PK10314 fixes following problems: - HPIC Recovery function terminates with ABEND U3916 ( ABENDU3916 ), 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 Recovery function terminates with ABEND U3916 ( ABENDU3916 ), when the CA data set and the 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 Recovery function terminate with ABEND U3916 ( ABENDU3916 ), 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. - HPIC Recovery function terminates with RC=16, when the CATDS option is used in DBRC and a CA data set is dynamically allocated and any of the LOG data sets are not used. Because HPIC dynamically allocates a data set for DFSULOG using DSN of the CA data set. PK13450 fixes following problem: - The HPIC Image Copy function terminates with RC=8 and the message IEC141I ( S013-20 ), when the image copy data set is allocated by JCL that is specified BLKSIZE smaller than LRECL of image copy data set calculated internally. Because the HPIC opened the image copy data set using BLKSIZE specified on JCL. PK13486 fixes following problem: - HPIC Image Copy function terminates with RC=16 and the message DFS330A ( MSGDFS330A ) for key sequence error of a primary index DB or a secondary index DB, when HDPC=O or both of HDPC=Y and VIC=Y keywords are specified in the ICEIN control statement and the first index key is null. When the first index key is null, HPIC mishandles regarding the null key as an error key. PK14099 fixes following problem: - HPIC Concurrent Image Copy function runs by the incorrect processing type, and terminates with ABEND S0C4 ( ABEND0C4 ) in the module FABJDMP8. Because HPIC CIC uses incorrect register for mapping internal control block.
Problem conclusion
FABJACQG has been modified to bypass the logic which checks DSN of output IC for the NON-RECOVERABLE DB of the HPIC Concurrent Image Copy process. FABJMAIN has been modified to request FABJRCH7, FABJRCH8, or FABJRCH9 in order to check the DB record in the DBRC RECON. FABJRPT0 has been modified following things: - The ICTYPE of ICERPRT DD is changed to 'N/A' from 'UIC' when HDPC=O is specified for the primary index or secondary index. - The ICERPRT DD for the NON-RECOVERABLE DB of the HPIC Concurrent Image Copy process is same contents as HPPC=O is specified for primary index or secondary index. FABJBLKD has been modified to add the new symbols for NON-RECOVERABLE DB. FABJRCHK has been modified to check the DB record in the DBRC RECON in order to get the information whether the input database is defined as NON-RECOVERABLE or not. FABJINT1 has been modified to set the flag for VIC process when the primary index or secondary index is processed. FABJDALC has been modified following things: -To use DISP=SHR parameter for dynamic allocation of a CA data set, a LOG data set, and an 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. -To initialize Text Units each time HPIC dynamically allocates a CA data set or a LOG data set when the CATDS option is used 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. FABJDOPN has been modified to use the system determined BLKSIZE, when BLKSIZE smaller than LRECL of image copy data set calculated internally is specified on JCL. FABJDMPN has been modified to set correct address of HPIC control block into register. FABJDPSN has been modified following things: - An output image copy data set is not created and information message FABJ0183I is issued when the HPIC Concurrent Image Copy function processes the NON-RECOVERABLE DB. - Information message FABJ0184I is issued when HDPC=O is specified for primary index or secondary index without providing the correct HDPC library in STEPLIB. - To bypass the process of reading a primary index DB or a secondary index DB that is not formatted and to issue the message DFS301A to report an error when HDPC=O or both of HDPC=Y and VIC=Y keywords are specified in the ICEIN. - Not to call the termination process of HPPC without calling the initialization process of HPPC when a severe error occurs in the open process of an input database data set. - To bypass the key sequence check of the first record in the index DB, when the virtual image copy process with pointer checking is applied for the index DB. The following modules have been reassembled. FABJCMDB FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALO FABJDBCM FABJDBC1 FABJDBDN FABJDBD7 FABJDBD8 FABJDBD9 FABJDBF0 FABJDBLK FABJDBR7 FABJDBR8 FABJDBR9 FABJDCTL FABJDEMP FABJDFCN FABJDFC7 FABJDFC8 FABJDFC9 FABJDMP0 FABJDMP7 FABJDMP8 FABJDMP9 FABJDPS7 FABJDPS8 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJFCAI FABJFCCM FABJFCCN FABJFCC7 FABJFCC8 FABJFCC9 FABJFCDN FABJFCD7 FABJFCD8 FABJFCD9 FABJGLRP FABJICDD FABJINT2 FABJIPRC FABJMAS1 FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9 FABJMRGE FABJNTFC FABJORCN FABJORC7 FABJORC8 FABJORC9 FABJPARM FABJPRM2 FABJRCH7 FABJRCH8 FABJRCH9 FABJRDB7 FABJRDB8 FABJRDB9 FABJRFCN FABJRFC7 FABJRFC8 FABJRFC9 FABJSAS2 FABJSTA FABJTERM FABJTOI FABJUIC1 FABJXCR FABJXHPC FABJXLIM ======================== = DOCUMENTATION CHANGE = ======================== IMS High Performance Image Copy for z/OS Version 4 Release 1 User's Guide SC18-9409-00 ( SC18940900 ) should be changed as fo 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.36 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.38 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 A.0Appendix A. Return Codes, Abend Codes, and Messages A.3 Messages The message FABJ0183I is added. | FABJ0183I CONCURRENT IMAGE COPY FOR A NON-RECOVERABLE DATASET | DOES NOT CREATE AN IMAGE COPY DATA SET | | Explanation: | HPIC concurrent image copy process is not created an output | image copy data set for NON-RECOVERABLE database. | System Action: None. | Programmer Response: None. The message FABJ0184I is added. | FABJ0184I HD POINTER CHECKER IS NOT PERFORMED, HOWEVER HDPC=O | IS REQUESTED. | | Explanation: | HDPC HASH CHECK is requested without creating an output image | copy for primary or secondary index database. But the HDPC | HASH CHECK is not done, because correct HDPC library is not | provided in STEPLIB. | System Action: | Program FABJMAIN continues processing without an HDPC HASH | check. The return code of the process is 04. | Programmer Response: | If you wish, provide correct HPPC library in the STEPLIB and | rerun the job.
Temporary fix
********* * HIPER * *********
Comments
APAR Information
APAR number
PK14295
Reported component name
IMS HP IMAGE CO
Reported component ID
5655K9600
Reported release
410
Status
CLOSED PER
PE
NoPE
HIPER
YesHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2005-10-28
Closed date
2005-11-11
Last modified date
2005-12-07
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK09056
Modules/Macros
FABJACQG FABJBLKD FABJCMDB FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDBCM FABJDBC1 FABJDBDN FABJDBD7 FABJDBD8 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRC FABJDBR7 FABJDBR8 FABJDBR9 FABJDCTL FABJDEMP FABJDFCN FABJDFC7 FABJDFC8 FABJDFC9 FABJDMPN FABJDMP0 FABJDMP7 FABJDMP8 FABJDMP9 FABJDOPN FABJDPSN FABJDPS7 FABJDPS8 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJFCAI FABJFCCM FABJFCCN FABJFCC7 FABJFCC8 FABJFCC9 FABJFCDN FABJFCD7 FABJFCD8 FABJFCD9 FABJGLRP FABJICDD FABJINT1 FABJINT2 FABJIPRC FABJMAIN FABJMAS1 FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9 FABJMRGE FABJNTFC FABJORCN FABJORC7 FABJORC8 FABJORC9 FABJPARM FABJPRM2 FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9 FABJRDB7 FABJRDB8 FABJRDB9 FABJRFCN FABJRFC7 FABJRFC8 FABJRFC9 FABJRPT0 FABJSAS2 FABJSTA FABJTERM FABJTGEN FABJTOI FABJUIC1 FABJXCR FABJXHPC FABJXLIM
| SC18940900 |
Fix information
Fixed component name
IMS HP IMAGE CO
Fixed component ID
5655K9600
Applicable component levels
R410 PSY UK09056
UP05/11/15 P F511 Ž
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.
[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"4.1.0","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
14 December 2020