A fix is available
APAR status
Closed as new function.
Error description
This APAR support HP image Copy V4.2 new function
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: This APAR provides a new optional * * function that is Image Copy delete * * function. This is the function that HP * * Image copy deletes the output image * * copy data set that is not completed or * * includes some errors, when the image * * copy process failed due to error or * * abnormal end. * * * * This APAR also fixes the following * * three problems: * * 1. The time stamps of UIC record in * * DBRC RECON data sets are not the * * same. * * This problem occurs in one of the * * following conditions. * * - DBALL=(Y,Y) and VIC=Y. * * - FASTIC=(,FDUMP), REGTIMESTMP=SAME * * and VIC=Y * * 2. HP Image Copy Checkpoint Restart * * function with RESTART=(Y,HASH) can * * not reprocess the DBDS which has the * * pointer error when HP Image Copy * * terminates with ABEND. * * 3. The specification of CATLGERROR > 8 * * in HPSRETCD DD can not stop * * registering the IC record that has * * been detected as a catalog failure * * to DBRC RECON data sets. * * This problem occurs in one of the * * following conditions. * * - NOTIFYMODE=COND * * - NOTIFYMODE=FORCE and * * FASTIC=(,COPY) * * - NOTIFYMODE=FORCE and * * FASTIC=(,FDUMP) * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR provides a new optional function that is Image Copy delete function. This is the function that HP Image copy deletes the output image copy data set that is not completed or includes some errors, when the image copy process failed due to error or abnormal end. This function deletes incomplete image copy data set. This function deletes not only failed image copy data set but also related image copy data sets when the function runs with NOTIFYMODE=COND or RESTART=Y. This enhancement is for FITS MR032509370. This function is enabled with following conditions: - DEL_ICDS=Y is specified in the GLOBAL statement or defined in the site default table. - Image copy data set is allocated dynamically. Notes: If the data set is allocated as JCL DD statements, the image copy data set is not deleted. If the data set is allocated outside of HP Image Copy process, the image copy data set is not deleted. The data set on the tape volumes can not be deleted physically, but its catalog information is deleted when the function runs with ICCAT=Y. *** NOTICE ! *** This APAR changes the length of the control block and the data in Checkpoint file of HP Image Copy V4.2. The Checkpoint data that is created by HP Image Copy V4.2 without fix of APAR PM68259 is not valid after applying APAR PM68259. Users who use Checkpoint Restart function must delete previous Checkpoint file before running HP Image Copy, when you apply the maintenance of APAR PM68259. For more detail, please refer HP Image Copy V4.2 DCF that will be available later. When the DCF becomes available, this APAR information will be update so as to point the DCF document. This APAR also fixes the following three problems: 1. The time stamps of UIC record in DBRC RECON data sets are not the same. This problem occurs in one of the following conditions. - DBALL=(Y,Y) and VIC=Y. - FASTIC=(,FDUMP), REGTIMESTMP=SAME and VIC=Y The cause of this problem is that HP Image Copy does not specify the RUNTIME parameter to NOTIFY.UIC command. Therefore the current time stamp is used as the time stamp of UIC record. 2. HP Image Copy Checkpoint Restart function with RESTART=(Y,HASH) can not reprocess the DBDS which has the pointer error when HP Image Copy terminates with ABEND. The cause of this problem is that HP Image Copy does not check the status of pointer error to identify reprocessed DBDS. 3. The specification of CATLGERROR > 8 in HPSRETCD DD can not stop registering the IC record that has been detected as a catalog failure to DBRC RECON data sets. This problem occurs in one of the following conditions. - NOTIFYMODE=COND - NOTIFYMODE=FORCE and FASTIC=(,COPY) - NOTIFYMODE=FORCE and FASTIC=(,FDUMP)
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: 3.0 Running IMS HP Image Copy IMS HP Image Copy JCL statements ICEIN control statement keywords Part 3. Running IMS HP Image Copy Chapter 9. IMS HP Image Copy control statements and keywords ICEIN control statement keywords | DEL_ICDS keyword | The DEL_ICDS keyword specifies whether to control to delete | the image copy data set of the database data set whose process | is in error. | | Statements that support this keyword | | GLOBAL statement | | Site default option Supported | | Related keyword | ICDALLOC keyword | DBRC keyword | NOTIFYMODE keyword | RESTART keyword | RSTTYPE keyword | RSTTYPE_STK keyword | VIC keyword | | Format | ----------------------------------------------- | | | | | DEL_ICDS=Y|N | | | | | ----------------------------------------------- | | Y | Specifies that the image copy data set which is dynamically | allocated is deleted, if the image copy of the database data | set process fails. | When Image Copy function runs with DBRC=Y and the database | data set is registered in the DBRC RECON data set, IC record | in the DBRC RECON data set is also deleted. | The IC data set on the tape volume is not deleted even if | DEL_ICDS=Y is specified. But the IC data set is uncataloged | and the IC record in the DBRC RECON data set is deleted. | | N | Specifies that the image copy data set is not deleted even | if the image copy of the database data set process fails. | If IC record has been already registered in the DBRC RECON | data set, the IC record is not deleted. | | Default value | DEL_ICDS=N | | Note: DEL_ICDS=Y works for the image copy data set that is | allocated dynamically by Image Copy function of HP Image Copy. | HP Image Copy does not delete the image Copy data set under | the following conditions: | - The image copy data is defined by DD card in the running | JCL. | - The image copy data set is allocated outside of HP Image | Copy process. | - The image copy data set resides on the tape volume. | The IC record of the DBRC RECON data set is deleted with | these conditions. Part 6. Troubleshooting Chapter 20. Messages and codes Messages | FABJ0168I DEL_ICDS=Y IS APPLIED TO ICDS OF DBD=dbdname | DDNAME/AREA=ddname | | Explanation: HP Create Image Copy process applies DEL_ICDS=Y | to the DBDS. | System action: HP Create Image Copy process continues | processing. | Programmer response: None. | FABJ0169E DEL_ICDS=Y IS APPLIED TO ICDS OF DBD=dbdname | DDNAME/AREA=ddname, BUT FOLLOWING DELETE PROCESS HAS NOT | COMPLETED. | - DELETE DBRC IC RECORD|- UNCATALOG|- DELETE ICDS | FABJ0169E ICDSN=data_set_name VOLSER=volser | FABJ0169E DBRC | ICTIME=yyyydddhhmmssthmiju offset |yydddhhmmsst offset | | Explanation: Delete process of HP Image Copy or HP Create | Image Copy detects errors in IDCAMS or DSPURXRT process. | System action: Process ends with a return code of 8. | Programmer response: Check the IDCAMS or DSPURXRT messages, | correct any errors, and delete the resource manually. | FABJ0205I THE IMAGE COPY STATUS IN THE RECON IS CHANGED TO IC | NEEDED DDNAME/AREA=ddname | Explanation:The Image Copy function or The Create Image Copy | function issues the CHANGE.DBDS command. | In the Image Copy function, this command is issued after the | DELETE.IC or DELETE.UIC command. | In the Create Image Copy function, this command is issued | after the NOTIFY.IC command. | This CHANGE.DBDS command prevents the image copy status of the | DBDS from being changed to IC RECOMMENDED. System Action:IMS HP Image Copy continues processing. User Response:None. | FABJ3900E HP IMAGE COPY DETECTS ERRORS DURING IMAGE COPY DATA | SET CREATING PROCESS. | | Explanation: HP Image Copy process ends because some kind of | error is detected. | System action: HP Image Copy process ends with an ABEND code | of 3900. | Programmer response: Check and correct an error and rerun HP | Image Copy job. | FABJ3939E SHADOW DATA SET | IMAGE COPY DATA SET DELETE | FAILED. IDCAMS RETURNED ABNORMAL CONDITION CODE. | | Explanation: IDCAMS failed in deleting a target data set. The | reason code is shown by the IDCAMS messages in ICEPRINT. | System action: Process ends with a return code of 8. | Programmer response: Check the IDCAMS messages, correct any | errors, and delete the data set manually. The following modules and macros have been modified for this APAR. FABJAMSI FABJBLKD FABJCMDB FABJCRC0 FABJCRC1 FABJDALC FABJDALO FABJDBCM FABJDBC1 FABJDFCN FABJDMPN FABJDOPN FABJDPSN FABJFCCN FABJFCDN FABJGLRP FABJMAIN FABJMAP1 FABJMSGC FABJOFL0 FABJOFL1 FABJPARM FABJPRM2 FABJRPT0 FABJRPT1 FABJSTMD FABJTGEN FABJUIC1 FABJXCR FABURHT The following modules have been reassembled. FABJACQG FABJAPIM FABJASPM FABJATRC FABJCRC3 FABJCTCV FABJCZCV FABJDALS FABJDBAL FABJDBD2 FABJDBD9 FABJDBDA FABJDBDB FABJDBDN FABJDBF0 FABJDBLK FABJDBR2 FABJDBR9 FABJDBRA FABJDBRB FABJDBRC FABJDCTL FABJDDIM FABJDEMP FABJDFC2 FABJDFC9 FABJDFCA FABJDFCB FABJDMP0 FABJDMP2 FABJDMP9 FABJDMPA FABJDMPB FABJDPS2 FABJDPS9 FABJDPSA FABJDPSB FABJDPUT FABJDREQ FABJDRQS FABJDRSN FABJFCAI FABJFCC2 FABJFCC9 FABJFCCA FABJFCCB FABJFCCM FABJFCD2 FABJFCD9 FABJFCDA FABJFCDB FABJFDMP FABJGDGB FABJICDD FABJIDX2 FABJIDX9 FABJIDXA FABJIDXB FABJIDXN FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJMAS1 FABJMDP2 FABJMDP9 FABJMDPA FABJMDPB FABJMDPN FABJMRGE FABJMSUL FABJNTFC FABJNTFI FABJNTFS FABJOFDD FABJORC2 FABJORC9 FABJORCA FABJORCB FABJORCN FABJPRM3 FABJRCH2 FABJRCH9 FABJRCHA FABJRCHB FABJRCHK FABJRDB2 FABJRDB9 FABJRDBA FABJRDBB FABJRETC FABJRETM FABJRFC2 FABJRFC9 FABJRFCA FABJRFCB FABJRFCN FABJSAS1 FABJSAS2 FABJSTA FABJTERM FABJTOI FABJTOI2 FABJXHPC FABJXLIM ×**** PE12/09/05 FIX IN ERROR. SEE APAR PM71862 FOR DESCRIPTION
APAR Information
APAR number
PM68259
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
2012-07-06
Closed date
2012-07-30
Last modified date
2012-09-05
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK80640
Modules/Macros
FABJACQG FABJAMSI FABJAPIM FABJASPM FABJATRC FABJCMDB FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS FABJDBAL FABJDBCM FABJDBC1 FABJDBDA FABJDBDB FABJDBD2 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRA FABJDBRB FABJDBR2 FABJDBR9 FABJDCTL FABJDDIM FABJDEMP FABJDFCA FABJDFCB FABJDFC2 FABJDFC9 FABJDMPA FABJDMPB FABJDMP0 FABJDMP2 FABJDMP9 FABJDOPN FABJDPSA FABJDPSB FABJDPS2 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJDRSN FABJFCAI FABJFCCA FABJFCCB FABJFCCM FABJFCC2 FABJFCC9 FABJFCDA FABJFCDB FABJFCD2 FABJFCD9 FABJFDMP FABJGDGB FABJGLRP FABJICDD FABJIDXA FABJIDXB FABJIDX2 FABJIDX9 FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJMAIN FABJMAS1 FABJMDPA FABJMDPB FABJMDP2 FABJMDP9 FABJMRGE FABJMSGC FABJMSUL FABJNTFC FABJNTFI FABJNTFS FABJOFDD FABJOFL0 FABJOFL1 FABJORCA FABJORCB FABJORC2 FABJORC9 FABJPARM FABJPRM2 FABJPRM3 FABJRCHA FABJRCHB FABJRCH2 FABJRCH9 FABJRDBA FABJRDBB FABJRDB2 FABJRDB9 FABJRETC FABJRETM FABJRFCA FABJRFCB FABJRFC2 FABJRFC9 FABJRPT0 FABJRPT1 FABJSAS1 FABJSAS2 FABJSTA FABJSTMD FABJTERM FABJTGEN FABJTOI FABJTOI2 FABJUIC1 FABJXCR FABJXHPC FABJXLIM
| SC19275601 |
Fix information
Fixed component name
IMS HP IMAGE CO
Fixed component ID
5655K9600
Applicable component levels
R420 PSY UK80640
UP12/08/01 P F207
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":"4.2.0"}]
Document Information
Modified date:
14 December 2020