PK55442: HPIC CHECKPOINT/RETART WILL NOW HANDLE DATA BASE HASH CHECK ERRORS.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• HPIC CheckPoint/Restart will handle data base HASH
  errors as follows:
  - If a HASH error is found in CIC process, HPIC will
  assume the data base needs to be restarted.
  - If a severe HASH error (indicating a damaged data base),
  HPIC will report it and will not RESTART the DB.
  

Local fix

• no work around
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 1 users ( FMID=H1J0410 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides a new optional       *
  *                      function of Checkpoint/Rstart which DB  *
  *                      with HASH error can be restartable. The *
  *                      new optional parameters                 *
  *                       - COUNT=nn                             *
  *                       - HASH                                 *
  *                      and new DD FABJHRDD are provided.       *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides a new optional function of Checkpoint/Rstart
  which DB with HASH error can be restartable, when the HASH error
  is not fatal error.
  By this APAR following new parameters are provided:
   - COUNT=nn
      specified to indicate the max number of the restart process.
   - HASH
      specified to check hash error information from HPPC and
      determine which DBDS is to be restarted.
  And optional DD FABJHRDD which is used for HASH check at
  Restart time is provided.
  +--------------------------------------------------------------+
  |The RESTART=(,HASH) keyword is effective when you apply APAR  |
  |PK55086 to IMS High Performance Pointer Checker for z/OS      |
  |Version 2 Release 2 ( FMID=HPC2220 ).                         |
  +--------------------------------------------------------------+
  

Problem conclusion

Temporary fix

Comments

• FABJDMPN has been modified to call FABJXCR by a new function and
  control input and output processing for FABJHRDD data set.
  
  FABJXCR has been modified to check hash error and to determine
  which DBDS is to be restarted.
  
  FABJMAIN has been modified to call FABJRPT0 by a new function.
  
  FABJPARM, FABJSTMD, FABJSTMP, FABJTGEN and FABJBLKD have been
  modified to accept new parameters.
  
  FABJGLRP has been modified to report new parameters for RESTART=
  keyword.
  
  FABJRPT0 has been modified to report DBDS members to be
  restarted.
  
  FABUITCT, FABJXLK and FABJXCRR have been modified to add control
  flags and areas for restart.
  
  FABJDPSN, FABJFCDN and FABJINT1 have been modified to change TCT
  entry address for HPPC parameter.
  
  The following modules have been reassembled.
    FABJACQG, FABJAPIM, FABJASPM, FABJATRC, FABJCMDB, FABJCRC0,
    FABJCRC1, FABJCRC3, FABJCTCV, FABJCZCV, FABJDALC, FABJDALO,
    FABJDALS, FABJDBAL, FABJDBCM, FABJDBC1, FABJDBDA, FABJDBD7,
    FABJDBD8, FABJDBD9, FABJDBF0, FABJDBLK, FABJDBRA, FABJDBR7,
    FABJDBR8, FABJDBR9, FABJDCTL, FABJDDIM, FABJDEMP, FABJDFCA,
    FABJDFC7, FABJDFC8, FABJDFC9, FABJDMP0, FABJDMPA, FABJDMP7,
    FABJDMP8, FABJDMP9, FABJDOPN, FABJDPSA, FABJDPS7, FABJDPS8,
    FABJDPS9, FABJDPUT, FABJDREQ, FABJDRQS, FABJDRSN, FABJFCAI,
    FABJFCCA, FABJFCC7, FABJFCC8, FABJFCC9, FABJFCCM, FABJFCDA,
    FABJFCD7, FABJFCD8, FABJFCD9, FABJGDGB, FABJICDD, FABJIDXA,
    FABJIDX7, FABJIDX8, FABJIDX9, FABJINT2, FABJINT3, FABJIPRC,
    FABJMAS1, FABJMDPA, FABJMDP7, FABJMDP8, FABJMDP9, FABJMRGE,
    FABJNTFC, FABJNTFI, FABJNTFS, FABJORCA, FABJORC7, FABJORC8,
    FABJORC9, FABJPRM2, FABJPRM3, FABJRCHA, FABJRCH7, FABJRCH8,
    FABJRCH9, FABJRDBA, FABJRDB7, FABJRDB8, FABJRDB9, FABJRETC,
    FABJRETM, FABJRFCA, FABJRFC7, FABJRFC8, FABJRFC9, FABJRPT1,
    FABJSAS1, FABJSAS2, FABJSTA,  FABJTERM, FABJUIC1, FABJXHPC,
    FABJXLIM
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 4 Release 1
  User's Guide SC18-9409 ( SC189409 ) should be changed as
  follows:
  
  3.0 Operating instructions
   3.2 FABJMAIN JCL requirements
    3.2.2 Image Copy function JCL
  
    Add following DD statements in this section.
    Table 1. DD statements of the FABJMAIN JCL
    +------------+--------+--------------+----------------------+
    | DDNAME     | Use    | Format       | Required of Optional |
    +------------+--------+--------------+----------------------+
    | FABJHRDD   | Input/ | RECFM=VBS    | Optional             |
    |            | Output |              |                      |
    +------------+--------+--------------+----------------------+
    :
    :
  |FABJHRDD DD
  | This is a function-unique DD statement for the Checkpoint
  | Restart with HASH option. The DD statement is valid when
  | RESTART=(Y,HASH) is specified.  The file should
  | be pre-allocated and cataloged before the requested checkpoint
  | or restart. If the HASH record file (FABJHRDD) is not defined
  | in the job step or is DD DUMMY, HASH record validation is
  | bypassed. However, the requested functions are attempted.
  |
  | This DD defines the HASH record file for validation
  | which is used restart time. It must be the same file used for
  | a both a particular checkpoint and for the associated
  | attempted subsequent restarts. If HASH check finds same hash
  | error in previous run at restart time, the HPIC regards the DB
  | has fatal error and do not restart next run.
  
  
   3.4 ICEIN control statement data set
    3.4.3 Option parameters
     3.4.3.58 RESTART=
  
    Add following sentences in this section;
  
    +---------------------------------------------------------+
  | | RESTART=Y|N|C | (Y,option-1,option-2)                   |
    +---------------------------------------------------------+
  :
    C
      specifies that only checkpoint processing is allowed.
  |
  | where option-n values are:
  |  HASH
  |   specifies that Restart processing is to be done when HASH
  |   error has been detected. If you specify N in first operand,
  |   this option is ignored.
  |
  |  COUNT=1-99
  |   specifies the max number of restart processing. If the
  |   amount of restart process exceeds this value, Restart
  |   processing is not done any more, and the Checkpoint Restart
  |   file is reset. If you specify C or N in first operand, this
  |   option is ignored. The default value is 5.
  
  
   3.6 Output
    3.6.3 Image Copy Dump Process report
  
   Modify the sentence as follows;
  
  | Figure 12, Figure 13 and Figure nn are the Image Copy Dump
  | Process report, which show the result of the Image Copy
  | process and the information of the IC record in DBRC.
  
   Add the new Figure;
  | Figure nn. Image Copy Dump Process report--restart information
  |
  | The restart information shows the following information:
  |
  | #MEMBER=
  |  The number of data sets to be reprocessed at the next Restart
  |  process.
  |
  | -DBD-
  |  The list of DBD names to be reprocessed.
  |
  | -DDN/AREA-
  |  The list of DBDS ddnames and area names to be reprocessed.
  |
  
  A.0 Appendix A. Return codes, abend codes, and messages
   A.3 Messages
  
  The message FABJ4135I is added.
  | FABJ4135I  THIS PROCESS IS RUNNING IN CHECKPOINT|RESTART MODE.
  |
  | Explanation: This is an informational message indicating
  | whether the process is Checkpoint mode or Restart mode.
  |
  | System action: None.
  |
  | Programmer response: None.
  
  The message FABJ4136I is added.
  | FABJ4136I  THIS IS THE 1ST|2ND|3RD|nnTH PROCESS OF A RESTART.
  |
  | Explanation: This is an informational message indicating the
  | number of times of the Restart process to be done.
  |
  | System action: None.
  |
  | Programmer response: None.
  
  The message FABJ4137I is added.
  | FABJ4137I  THE RESTART COUNT HAS REACHED TO THE LIMIT. RESTART
  | WILL NOT BE PROCESSED ANY MORE.
  |
  | Explanation: The number of times of the Restart processing has
  | exceeded the limit specified in RESTART= keyword. Restart
  | processing is not done any more, and the Checkpoint Restart
  | file is reset.
  |
  | System action: None.
  |
  | Programmer response: None.
  
  The message FABJ4138I is added.
  | FABJ4138I  PROCESSING (HECHK) RECORD IMAGE
  |
  | Explanation: This is an informational message indicating the
  | internal image copy processing (SYSIN) record image created
  | during a HECHK call phase. At HECHK call phase, HPIC checks
  | whether the HASH error is found or not.
  |
  | System action: None.
  |
  | Programmer response: None.
  
  The message FABJ4139I is added.
  | FABJ4139I  ERROR IN HASH CHECK. THIS DB IS TO BE RESTARTED.
  |
  | Explanation: HASH error has found in this DBDS. This DB will
  | be reprocessed at the next Restart processing.
  |
  | System action: None.
  |
  | Programmer response: None.
  
  The message FABJ4140E is added.
  | FABJ4140E FATAL POINTER ERROR IS FOUND. THIS DB IS NOT TO BE
  | RESTARTED.
  |
  | Explanation: Severe pointer error has found in this DBDS: the
  | DB is damaged. This DB will not be reprocessed at the next
  | Restart processing.
  |
  | System action: None.
  |
  | Programmer response: Repair the database and rerun the JOB.
  
  The message FABJ4141I is added.
  | FABJ4141I RELATED DBDS HAS FATAL POINTER ERROR: IC WILL NOT TO
  | BE REATTEMPTED
  |
  | Explanation: Severe pointer error has found in this DBDS or
  | the related DBDS. This DB will not be reprocessed at the next
  | Restart processing.
  |
  | System action: None.
  |
  | Programmer response: Repair the database and rerun the JOB.
  

APAR Information

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

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

  UK30798

Modules/Macros

• FABJACQG FABJAPIM FABJASPM FABJATRC FABJBLKD
  FABJCMDB FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC
  FABJDALO FABJDALS FABJDBAL FABJDBCM FABJDBC1 FABJDBDA FABJDBDN
  FABJDBD7 FABJDBD8 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRA FABJDBRC
  FABJDBR7 FABJDBR8 FABJDBR9 FABJDCTL FABJDDIM FABJDEMP FABJDFCA
  FABJDFCN FABJDFC7 FABJDFC8 FABJDFC9 FABJDMPA FABJDMPN FABJDMP0
  FABJDMP7 FABJDMP8 FABJDMP9 FABJDOPN FABJDPSA FABJDPSN FABJDPS7
  FABJDPS8 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJDRSN FABJFCAI
  FABJFCCA FABJFCCM FABJFCCN FABJFCC7 FABJFCC8 FABJFCC9 FABJFCDA
  FABJFCDN FABJFCD7 FABJFCD8 FABJFCD9 FABJGDGB FABJGLRP FABJICDD
  FABJIDXA FABJIDXN FABJIDX7 FABJIDX8 FABJIDX9 FABJINT1 FABJINT2
  FABJINT3 FABJIPRC FABJMAIN FABJMAS1 FABJMDPA FABJMDPN FABJMDP7
  FABJMDP8 FABJMDP9 FABJMRGE FABJNTFC FABJNTFI FABJNTFS FABJORCA
  FABJORCN FABJORC7 FABJORC8 FABJORC9 FABJPARM FABJPRM2 FABJPRM3
  FABJRCHA FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9 FABJRDBA FABJRDB7
  FABJRDB8 FABJRDB9 FABJRETC FABJRETM FABJRFCA FABJRFCN FABJRFC7
  FABJRFC8 FABJRFC9 FABJRPT0 FABJRPT1 FABJSAS1 FABJSAS2 FABJSTA
  FABJSTMD FABJSTMP FABJTERM FABJTGEN FABJTOI  FABJUIC1 FABJXCR
  FABJXCRR FABJXHPC FABJXLIM FABJXLK  FABUITCT
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK30798

     UP07/11/02 P F711

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.