IBM Support

PM74497: THIS APAR FIXES SOME TROUBLES IN HP IMAGE COPY V4.2.

A fix is available

Obtain the fix for this APAR.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • This APAR fixes some troubles in HP image Copy V4.2 which are
detected by the test.

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 fixes following:              *
*                      1. Corrects the extent of the deletion  *
*                         by the image copy delete option for  *
*                         the Fast recovery format of the      *
*                         Advanced Image Copy function.        *
*                         - HP Image copy deletes secondary    *
*                           image copy data set only if the    *
*                           creation of the secondary image    *
*                           copy is failed in the Fast         *
*                           Recovery format(COPY) of the       *
*                           Advanced Image Copy function with  *
*                           NOTIFYMODE=FORCE.                  *
*                           This is applied when the HP Image  *
*                           Copy run with following            *
*                           conditions:                        *
*                           - DEL_ICDS=Y                       *
*                           - FASTIC=(,COPY)                   *
*                           - NOTIFYMODE=FORCE                 *
*                         - HP Image Copy deletes all image    *
*                           copy data sets for DB data set in  *
*                           which HASH check detects some      *
*                           errors when RESTART=(Y,HASH) is    *
*                           requested.                         *
*                      2. Corrects the error handling for      *
*                         Image Copy delete option:            *
*                         - Corrects JOB step return code when *
*                           IDCAMS DELETE command is failed.   *
*                         - Corrects the deletion target data  *
*                           set when the secondary data set is *
*                           requested in the Advanced Image    *
*                           Copy function and CHANGE.IC        *
*                           command is failed .                *
*                         - Stores the result of DBRC command  *
*                           in IMS Tools KB report repository  *
*                           when DELETE.IC command is failed.  *
*                      3. Corrects message texts of the        *
*                         severe error of the HASH check with  *
*                         Checkpoint Restart function.         *
*                      4. Corrects reporting data in 'Create   *
*                         Image Copy report' for processing    *
*                         the Fast Recovery format by Create   *
*                         Image Copy (CRC) function.           *
*                      5. Corrects JOB step return code when   *
*                         the error is detected dual image     *
*                         copy is requested in the process of  *
*                         Fast Recovery format of the Advanced *
*                         Image Copy function and WAIT         *
*                         statement is used.                   *
*                      6. Reports the HASH Check state in the  *
*                         'Image Copy Process Summary Report'  *
*                         correctly even if some of error is   *
*                         detected in the image copy process.  *
****************************************************************
* RECOMMENDATION: Apply the maintenance for this APAR.         *
****************************************************************
This APAR fixes following:
1. Corrects the extent of the deletion by the image copy delete
   option for the Fast recovery format of the Advanced Image
   Copy function.
   - HP Image copy deletes secondary image copy data set only if
     the creation of the secondary image copy is failed in the
     Fast Recovery format(COPY) of the Advanced Image Copy
     function with NOTIFYMODE=FORCE.
     This is applied when the HP Image Copy run with following
     conditions:
     - DEL_ICDS=Y
     - FASTIC=(,COPY)
     - NOTIFYMODE=FORCE
   - HP Image Copy deletes all image copy data sets for DB data
     set in which HASH check detects some errors when
     RESTART=(Y,HASH) is requested.
2. Corrects the error handling for Image Copy delete option:
   - Corrects JOB step return code when IDCAMS DELETE command is
     failed.
   - Corrects the deletion target data set when the secondary
     data set is requested in the Advanced Image Copy function
     and CHANGE.IC command is failed.
   - Stores the result of DBRC command in IMS Tools KB report
     repository when DELETE.IC command is failed.
3. Corrects message texts of the severe error of the HASH check
   with Checkpoint Restart function.
4. Corrects reporting data in 'Create Image Copy report' for
   processing the Fast Recovery format by Create Image Copy
   (CRC) function.
5. Corrects JOB step return code when the error is detected
   dual image copy is requested in the process of
   Fast Recovery format of the Advanced Image Copy function and
   WAIT statement is used.
6. Reports the HASH Check state in the 'Image Copy Process
   Summary Report' correctly even if some of error is detected
   in the image copy process.

Problem conclusion

  • ========================
= 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

RESTART keyword
:
| The following optional parameters can be specified as
| subparameters of 'Y' or 'C'. These optional parameters are
| ignored when used with 'N'.

  HASH
  Specifies whether to run the Restart processing based on the
  type of the pointer error detected by HASH Check.
  When the detected pointer error is an unidentified error, the
  Restart processing is run.
  When the detected pointer error is a severe error, the Restart
  processing is not run

Part 6. Troubleshooting
Chapter 20. Messages and codes
  Messages

| FABJ4128I IMAGE COPY PROCESS WILL NOT BE RESTARTED BECAUSE
|  A SEVERE POINTER ERROR WAS FOUND IN THE PREVIOUS RUN.
|     or
|  RELATED DBDS HAS A SEVERE POINTER ERROR IN THE PREVIOUS RUN.
|
| Explanation: The image copy process for the DB data set that
| was identified by FABJ4102I and FABJ4103I was bypassed.
| System Action: IMS HP Image Copy continues processing for
| other DB data sets.
| User Response: Determine the cause of the database errors
| by the HD Pointer Checker reports or DEDB Pointer Checker
| report in the previous run. If necessary, repair the database.
|
| FABJ4129I HASH CHECK IS INCOMPLETE. THIS DB IS TO BE
| RESTARTED.
|
| Explanation: HP Image Copy cancel the HASH process because of
| detecting some errors during creating image copy data set.
| This database will be reprocessed at the next run of restart
| process. This message is issued only when RESTART=(Y,HASH) is
| specified.
| System Action: IMS HP Image Copy continues processing for
| other database data sets.
| User Response: None.

The following modules and macros have been modified for this
APAR.

FABJBLKD FABJDBCM FABJDBC1 FABJDFCN FABJDMPN FABJDPSN FABJFCDN
FABJMAIN FABJOFL0 FABJRPT0 FABJRPT1 FABJXCR  FABUITCT

The following modules have been reassembled.

FABJACQG FABJAPIM FABJASPM FABJATRC FABJCMDB FABJCRC0 FABJCRC1
FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO 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 FABJDOPN FABJDPS2 FABJDPS9 FABJDPSA
FABJDPSB FABJDPUT FABJDREQ FABJDRQS FABJDRSN FABJFCAI FABJFCC2
FABJFCC9 FABJFCCA FABJFCCB FABJFCCM FABJFCCN FABJFCD2 FABJFCD9
FABJFCDA FABJFCDB FABJFDMP FABJGDGB FABJGLRP FABJICDD FABJIDX2
FABJIDX9 FABJIDXA FABJIDXB FABJIDXN FABJINT1 FABJINT2 FABJINT3
FABJIPRC FABJMAS1 FABJMDP2 FABJMDP9 FABJMDPA FABJMDPB FABJMDPN
FABJMRGE FABJMSUL FABJNTFC FABJNTFI FABJNTFS FABJOFDD FABJOFL1
FABJORC2 FABJORC9 FABJORCA FABJORCB FABJORCN FABJPARM FABJPRM2
FABJPRM3 FABJRCH2 FABJRCH9 FABJRCHA FABJRCHB FABJRCHK FABJRDB2
FABJRDB9 FABJRDBA FABJRDBB FABJRETC FABJRETM FABJRFC2 FABJRFC9
FABJRFCA FABJRFCB FABJRFCN FABJSAS1 FABJSAS2 FABJSTA  FABJTERM
FABJTGEN FABJTOI  FABJTOI2 FABJUIC1 FABJXHPC FABJXLIM

Temporary fix

  • 



Comments


    

  • 



APAR Information




    

  • APAR number
    PM74497
    • 

  • Reported component name
    IMS HP IMAGE CO
    • 

  • Reported component ID
    5655K9600
    • 

  • Reported release
    420
    • 

  • Status
    CLOSED  PER
    • 

  • PE
    NoPE
    • 

  • HIPER
    NoHIPER
    • 

  • Special Attention
    NoSpecatt / Xsystem
    • 

  • Submitted date
    2012-10-07
    • 

  • Closed date
    2012-10-22
    • 

  • Last modified date
    2012-11-02
    • 





    

  • APAR is sysrouted FROM one or more of the following:
    

    • 

  • APAR is sysrouted TO one or more of the following:
    

    
UK82807
    

    • 



Modules/Macros


    

  • FABJACQG 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 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  FABJTERM
FABJTGEN FABJTOI  FABJTOI2 FABJUIC1 FABJXCR  FABJXHPC FABJXLIM

    




Publications Referenced


SC19275601    





Fix information


    

  • Fixed component name
    IMS HP IMAGE CO
    • 

  • Fixed component ID
    5655K9600
    • 



Applicable component levels


    

  • R420  PSY  UK82807
       UP12/10/23  P  F210
    • 



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
            

            
                      

        


        

        


      

    

  



    

  

  
    
            

          
Page Feedback