A fix is available
APAR status
Closed as new function.
Error description
HP Image Copy V4 R2 supports a new keyword FALLBACK. This enhancement is for FITS MR0216094120.
Local fix
N/A
Problem summary
**************************************************************** * USERS AFFECTED: All IMS High Performance Image Copy for z/OS * * Version 4 Release 2 users ( FMID=H1J0420 ) * **************************************************************** * PROBLEM DESCRIPTION: High Performance Image Copy provides a * * new keyword FALLBACK=. * * This enhancement is for FITS * * MR0216094120. * * * * This APAR also fixes the following * * problems: * * 1. IMS HP Image Copy prints the message * * FABJ3900E without the variable text * * data. * * * * 2. Image Copy function terminates with * * ABEND S30A ( ABEND30A ) when some * * error occurs before creating an * * image copy data set. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** High Performance Image Copy provides a new keyword FALLBACK=. This enhancement is for FITS MR0216094120. IMS HP Image Copy provides the new function FALLBACK that IMS HP Image Copy switches to the concurrent image copy process internally and creates image copy data set when IMS HP Image Copy can not get the read only exclusive authorization of the input database for the batch image copy process. FALLBACK process is effective when the requested function is Batch Image Copy with DBRC=Y. Restrictions of FALLBACK 1. The process is not switched to the concurrent image copy process internally when the input database has one of following conditions: - Database that is not registered in the DBRC RECON data sets - Non-Recoverable database - The data set organization is VSAM KSDS if using FASTIC=(,COPY) or FASTIC=(,FDUMP) processing of the Advance Image Copy Services - If using FASTIC=(,DUMP) processing of the Advance Image Copy Services, the data set organization is VSAM KSDS that does not satisfy both of the following conditions: - SMS-managed data set - BWO(TYPEIMS) parameter is not specified on AMS DEFINE or ALTER for the data set. 2. FALLBACK=Y is not effective when one of following keywords are specified: - DBRC=N - TOIAUTO=Y - TOIAUTO_Q=Y 3. FALLBACK=Y is not effective following conditions: - The data set organization is VSAM KSDS and process is running with CIC_KSDS=N and FASTIC=N. - The input database is index and BYPDBAUTH=Y is specified. 4. When the FALLBACK=Y is effective, following HD Pointer Checker options are ignored and corresponding reports are not generated: - HOMECHK keyword - Operands of HDPC keyword - DBDIST - DEPDIST - CHAINDIST - COMPFACT This APAR also fixes the following problems: 1. IMS HP Image Copy prints the message FABJ3900E without the variable text data. The cause of misjudge is that the message which has no variable text data has been printed before printing the current message that has some variable text data. In this conditions, IMS HP Image Copy misjudges as the current message has no variable text data. 2. Image Copy function terminates with ABEND S30A ( ABEND30A ) when some error occurs before creating an image copy data set. During the error termination process, IMS HP Image Copy mishandles the condition and tries to issue unnecessary FREEPOOL macro. So, the FREEPOOL macro fails with unexpected ABEND S30A. This APAR prevents IMS HP Image Copy from issuing unnecessary FREEPOOL macro.
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== IMS High Performance Image Copy for z/OS Version 4 Release 2 User's Guide SC19-2756-01 ( SC19275601 ) should be changed as follows: Part 3. Running IMS HP Image Copy Chapter 9. IMS HP Image Copy control statements and keywords ICEIN control statement keywords Summary of ICEIN control statement keywords Table 24. Summary of ICEIN keywords +----------+-------------------------------------------------+ |Keyword |Description +----------+-------------------------------------------------+ : +----------+-------------------------------------------------+ | |FALLBACK= |The FALLBACK keyword specifies to switch to the | | | |concurrent image copy process internally when IMS| | | |HP Image Copy can not get the read only exclusive| | | |authorization of the input database for the batch| | | |image copy process. | +----------+-------------------------------------------------+ : Relation of keywords to ICEIN control statements : Table 25. Relation of keywords to ICEIN control statements +----------+------+-----+---+----+---+---+-------+-------- |Keyword |GLOBAL|GROUP|IC |CIC |RCV|CRC|Site | | | | |AIC|ACIC| | |default| | | | | | | | |option | +----------+------+-----+---+----+---+---+-------+-------- : +----------+------+-----+---+----+---+---+-------+-------- | |FALLBACK= | O | - | - | - | - | - | O | +----------+------+-----+---+----+---+---+-------+-------- : |FALLBACK keyword | | The FALLBACK keyword specifies to switch to the concurrent | image copy process internally when IMS HP Image Copy can not | get the read only exclusive authorization of the input | database for the batch image copy process. This keyword is | effective for the Image Copy function when the requested | process is the batch image copy and the process runs with | DBRC=Y. | | Statements that support this keyword | GLOBAL statement | | Site default option | Supported | | Related keyword | BYPDBAUTH keyword | CIC_KSDS keyword | DBRC keyword | TOIAUTO keyword | TOIAUTO_Q keyword | | Related ICEIN statement | IC statement | AIC statement | GROUP statement with FUNC=IC or FUNC=AIC | | Format | ___________________________________________________ | | | | | FALLBACK=Y|N | | |___________________________________________________| | | Y | IMS HP Image Copy switches the process to the concurrent | image copy internally when IMS HP Image Copy can not | get the read only exclusive authorization of the input | database for the batch image copy process. | | N | FALLBACK process is inactive. | | Default value | FALLBACK=N | | Notes: | The process is not switched to the concurrent image copy | process internally when the input database has one of | following conditions: | - Database that is not registered in the DBRC RECON data | sets | - Non-Recoverable database | - The data set organization is VSAM KSDS if using | FASTIC=(,COPY) or FASTIC=(,FDUMP) processing of the | Advance Image Copy Services | - If using FASTIC=(,DUMP) processing of the Advance Image | Copy Services, the data set organization is VSAM KSDS that | does not satisfy both of the following conditions: | - SMS-managed data set | - BWO(TYPEIMS) parameter is not specified on AMS DEFINE or | ALTER for the data set. | | FALLBACK=Y is not effective when one of following keywords | are specified: | - DBRC=N | - TOIAUTO=Y | - TOIAUTO_Q=Y | | FALLBACK=Y is not effective following conditions: | - The data set organization is VSAM KSDS and process is | running with CIC_KSDS=N and FASTIC=N. | - The input database is index and BYPDBAUTH=Y is specified. | | When the FALLBACK=Y is effective, following HD Pointer | Checker options are ignored and corresponding reports are | not generated: | - HOMECHK keyword | - Operand of HDPC keyword | - DBDIST | - DEPDIST | - CHAINDIST | - COMPFACT | | Related reference: | "BYPDBAUTH keyword" | "CIC_KSDS keyword" | "DBRC keyword" | "TOIAUTO keyword" | "TOIAUTO_Q keyword" Part 6. Troubleshooting Chapter 20. Messages and codes Messages | FABJ0280I FALLBACK PROCESS IS ACTIVE. | | Explanation: FALLBACK process is effective. IMS HP Image Copy | switches the process to the concurrent image copy if IMS HP | image Copy can not get the read only exclusive authorization | of the database. When the process is switched, the message | FABJ0281I is reported. | | System action: IMS HP Image Copy continues processing. | | User response: None. | FABJ0281I BATCH IMAGE COPY PROCESS AUTOMATICALLY SWITCH TO | CONCURRENT IMAGE COPY PROCESS | DBD/AREA=dbdname|partname|areaname | | Explanation: IMS HP Image Copy switches the process for the | dbdname|partname|area to the concurrent image copy. | | System action: IMS HP Image Copy continues processing. | | User response: None. | FABJ0282E BOTH BATCH IMAGE COPY PROCESS AND CONCURRENT IMAGE | COPY PROCESS FAILED FOR DBD=dbdname|partname | DDN/AREA=ddname|areaname | | Explanation: Neither batch image copy process nor concurrent | image copy process for dbdname/partname/area is done even | FALLBACK process is active. | | System action: IMS HP Image Copy continues the process for | next database. The JOB step return code of IMS HP image Copy | is RC=08. | | User response: Refer to the corresponding message that is | FABJ0183I, FABJ4232E, FABJ4243E, or FABJ0235E, and identified | the reason of error. | FABJ0283E SWITCHING TO CONCURRENT IMAGE COPY PROCESS FAILED | DBD/AREA=dbdname|partname|areaname | | Explanation: IMS HP Image Copy can not get read only | authorization of the database for the concurrent image copy | process after switching the process by FALLBACK. The image | copy data set of the database is not created. | | System action: IMS HP Image Copy continues the process for | next database. The JOB step return code of IMS HP image Copy | is RC=08. | | User response: Refer to the IMS message DFS047A or DFS3710A, | and identify the error reason. | FABJ3942E IGWARLS RETURNS AN UNEXPECTED ERROR RETURN CODE AND | REASON CODE. RC=rc RSN=rsn | | Explanation: IMS HP Image Copy received unexpected error | return code and reason code from DFSMS module: IGWARLS. | | System action: Program FABJMAIN issues a user error abend code | of 3942. | | User response: Contact IBM Software Support. The following modules and macros are modified by this APAR. FABJBLKD, FABJGLRP, FABJMAIN, FABJPARM, FABJSTMD and FABJTGEN have been modified to be able to specify the new keyword FALLBACK=. FABJBRLS, FABJCMDB, FABJDFCN, FABJDMPN, FABJDPSN, FABJMDPN, FABJOFL1, FABJRPT0, FABJRPT1 have been modified to switch to the concurrent image copy process internally when IMS HP Image Copy can not get the read only exclusive authorization of the input database for the batch image copy process. FABJMSGC has been modified to add the new messages FABJ0280I, FABJ0281I, FABJ0282E, FABJ0283E and FABJ3942E. FABJFCBK, FABJFCCN, FABJFCDN, FABJRFCN, FABJIGWI, FABJMAP1, FABJRDBA, FABJRDBB, FABJRDB2, FABJRDB3 and FABJRDB9 have been modified as follows: - Check whether processing database data set is VSAM KSDS or not before invoking DFSMSdss command. - Check BWO(TYPEIMS) parameter is specified on AMS DEFINE or ALTER for the processing database data set. FABJLINK and H1J0420J have been modified to change the attributes of load module FABJIGWI to RN RU. The following modules have been reassembled. FABJBRLA FABJBRLB FABJBRL2 FABJBRL3 FABJBRL9 FABJDFCA FABJDFCB FABJDFC2 FABJDFC3 FABJDFC9 FABJDMPA FABJDMPB FABJDMP2 FABJDMP3 FABJDMP9 FABJDPSA FABJDPSB FABJDPS2 FABJDPS3 FABJDPS9 FABJFCCA FABJFCCB FABJFCC2 FABJFCC3 FABJFCC9 FABJFCDA FABJFCDB FABJFCD2 FABJFCD3 FABJFCD9 FABJMDPA FABJMDPB FABJMDP2 FABJMDP3 FABJMDP9 FABJRFCA FABJRFCB FABJRFC2 FABJRFC3 FABJRFC9 FABJACQG FABJAPIM FABJASPM FABJATRC FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS FABJDBAL FABJDBCM FABJDBC1 FABJDBDA FABJDBDB FABJDBD2 FABJDBD3 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRA FABJDBRB FABJDBR2 FABJDBR3 FABJDBR9 FABJDCTL FABJDDIM FABJDEMP FABJDMP0 FABJDOPN FABJDPUT FABJDREQ FABJDRQS FABJDRSN FABJFCAI FABJFCCM FABJFDMP FABJGDGB FABJICDD FABJIDXA FABJIDXB FABJIDX2 FABJIDX3 FABJIDX9 FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJMAS1 FABJMRGE FABJMSUL FABJNTFC FABJNTFI FABJNTFS FABJOFDD FABJOFL0 FABJORCA FABJORCB FABJORC2 FABJORC3 FABJORC9 FABJPRM2 FABJPRM3 FABJRCHA FABJRCHB FABJRCH2 FABJRCH3 FABJRCH9 FABJRETC FABJRETM FABJSAS1 FABJSAS2 FABJSTA FABJTERM FABJTOI FABJTOI2 FABJUIC1 FABJXCR FABJXHPC FABJXLIM
APAR Information
APAR number
PM84891
Reported component name
IMS HP IMAGE CO
Reported component ID
5655K9600
Reported release
420
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2013-03-15
Closed date
2013-03-29
Last modified date
2013-05-06
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK93018
Modules/Macros
FABJACQG FABJAPIM FABJASPM FABJATRC FABJBRLA FABJBRLB FABJBRL2 FABJBRL3 FABJBRL9 FABJCMDB FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS FABJDBAL FABJDBCM FABJDBC1 FABJDBDA FABJDBDB FABJDBD2 FABJDBD3 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRA FABJDBRB FABJDBR2 FABJDBR3 FABJDBR9 FABJDCTL FABJDDIM FABJDEMP FABJDFCA FABJDFCB FABJDFC2 FABJDFC3 FABJDFC9 FABJDMPA FABJDMPB FABJDMP0 FABJDMP2 FABJDMP3 FABJDMP9 FABJDOPN FABJDPSA FABJDPSB FABJDPS2 FABJDPS3 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJDRSN FABJFCAI FABJFCCA FABJFCCB FABJFCCM FABJFCC2 FABJFCC3 FABJFCC9 FABJFCDA FABJFCDB FABJFCD2 FABJFCD3 FABJFCD9 FABJFDMP FABJGDGB FABJGLRP FABJICDD FABJIDXA FABJIDXB FABJIDX2 FABJIDX3 FABJIDX9 FABJIGWI FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJLINK FABJMAIN FABJMAS1 FABJMDPA FABJMDPB FABJMDP2 FABJMDP3 FABJMDP9 FABJMRGE FABJMSGC FABJMSUL FABJNTFC FABJNTFI FABJNTFS FABJOFDD FABJOFL0 FABJOFL1 FABJORCA FABJORCB FABJORC2 FABJORC3 FABJORC9 FABJPARM FABJPRM2 FABJPRM3 FABJRCHA FABJRCHB FABJRCH2 FABJRCH3 FABJRCH9 FABJRDBA FABJRDBB FABJRDB2 FABJRDB3 FABJRDB9 FABJRETC FABJRETM FABJRFCA FABJRFCB FABJRFC2 FABJRFC3 FABJRFC9 FABJRPT0 FABJRPT1 FABJSAS1 FABJSAS2 FABJSTA FABJSTMD FABJTERM FABJTGEN FABJTOI FABJTOI2 FABJUIC1 FABJXCR FABJXHPC FABJXLIM H1J0420J
| SC19275601 |
Fix information
Fixed component name
IMS HP IMAGE CO
Fixed component ID
5655K9600
Applicable component levels
R420 PSY UK93018
UP13/04/02 P F304
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.2.0","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
14 December 2020