PM17402: DEQ FOR DBRC RECON WHEN DB RECORD IS NOT FOUND TO PREVENT ABEND S138 10/07/16 PTF PECHANGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• By PK55693, HPIC Recovery function sets ENQ to DBRC RECON when
  reading DB record and DBDS record. If DB record is not found in
  DBRC, HPIC performs RCV process without DBRC. But HPIC did not
  DEQ for DBRC RECON and continue the process, when DB record is
  not found. So HPIC should DEQ it.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 1 users ( FMID=H1J0410 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: HP Image Copy terminates with ABEND     *
  *                      S138 ( ABEND138 ) when the following    *
  *                      conditions are satisfied:               *
  *                       - IMS version 9 or less.               *
  *                       - HP Image Copy Recovery function.     *
  *                       - Processing DB other than HALDB.      *
  *                       - DBRC=Y is specified.                 *
  *                       - DB record or DBDS record of target   *
  *                         database is not registered in DBRC   *
  *                         RECON.                               *
  *                                                              *
  *                      This APAR also fixes the following      *
  *                      problems:                               *
  *                      1. HP Image Copy issues unnecessary     *
  *                         message FABJ4217I ( MSGFABJ4217I )   *
  *                         when the following conditions are    *
  *                         satisfied:                           *
  *                         - Creating Fast Recovery image copy. *
  *                         - DBRC=Y is specified.               *
  *                         - DB record or DBDS record of target *
  *                           database is not registered in      *
  *                           DBRC RECON.                        *
  *                      2. HP Image Copy terminates with RC=08  *
  *                         and message FABJ4216E                *
  *                         ( MSGFABJ4216E ) when the following  *
  *                         conditions are satisfied:            *
  *                         - Creating Concurrent Image Copy     *
  *                           using DFSMSdss DUMP command.       *
  *                         - DBRC=Y is specified.               *
  *                         - DB record or DBDS record of target *
  *                           database is not registered in      *
  *                           DBRC RECON.                        *
  *                      3. HP Image Copy Recovery function      *
  *                         terminates with ABEND U3811          *
  *                         ( ABENDU3811 ) when the following    *
  *                         conditions are satisfied:            *
  *                         - Recovering from Fast Recovery      *
  *                           image copy of DEDB.                *
  *                         - DBRC=Y is specified.               *
  *                         - DB record or DBDS record of target *
  *                           database is not registered in      *
  *                           DBRC RECON.                        *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  HP Image Copy terminates with ABEND S138 ( ABEND138 ) when the
  following conditions are satisfied:
   - IMS version 9 or less.
   - HP Image Copy Recovery function.
   - Processing DB other than HALDB.
   - DBRC=Y is specified.
   - DB record or DBDS record of target database is not registered
     in DBRC RECON.
  
  HP Image Copy checks DBRC DB record and DBDS record with DBRC=Y,
  even if the DBDS and image copy data set are allocated by JCL
  DD. By PK55693, HP Image Copy Recovery function sets ENQ to DBRC
  RECON on IMS version 9 or less when reading DB record and DBDS
  record. If DB record is not registered in DBRC RECON, HP Image
  Copy performs Recovery process without DBRC. But HP Image Copy
  did not DEQ for DBRC RECON and continue the process, when DB
  record is not registered. So HP Image Copy should DEQ it.
  
  
  This APAR also fixes the following problems:
  1. HP Image Copy issues unnecessary message FABJ4217I
     ( MSGFABJ4217I ) when the following conditions are satisfied:
     - Creating Fast Recovery image copy.
     - DBRC=Y is specified.
     - DB record or DBDS record of target database is not
       registered in DBRC RECON.
  2. HP Image Copy terminates with RC=08 and message FABJ4216E
     ( MSGFABJ4216E ) when the following conditions are satisfied:
     - Creating Concurrent Image Copy to use DFSMSdss DUMP
       command.
     - DBRC=Y is specified.
     - DB record or DBDS record of target database is not
       registered in DBRC RECON.
  3. HP Image Copy Recovery function terminates with ABEND U3811
     ( ABENDU3811 ) when the following conditions are satisfied:
     - Recovering from Fast Recovery image copy of DEDB.
     - DBRC=Y is specified.
     - DB record or DBDS record of target DBDS is not
       registered in DBRC RECON.
  
  The causes of the problems are as follows:
  1. HP Image Copy misjudges that NOTIFY.IC command was issued
     correctly when the above conditions are satisfied. Therefore
     HP Image Copy issues message FABJ4217I ( MSGFABJ4217I ) even
     if NOTIFY.IC command is not issued.
  2. HP Image Copy issues NOTIFY.IC command even if DB record or
     DBDS record is not registered in DBRC RECON. Then NOTIFY.IC
     command fails. HP Image Copy must not issue NOTIFY.IC command
     when the above conditions are satisfied.
  3. HP Image Copy Recovery function must use AREA name for DD
     name of output DBDS when DBRC=Y is specified and DB record or
     DBDS record of target database is not registered in DBRC
     RECON. However HP Image Copy tries to use a DD name in ADS
     list of target AREA for DD name of output DBDS when above
     conditions are satisfied. Therefore HP Image Copy terminates
     with ABEND U3811 ( ABENDU3811 ) because incorrect DD name is
     used.
  

Problem conclusion

• FABJDBRC has been modified to set DEQ on IMS version 9 or less
  when DB record or DBDS record of target database is not
  registered in DBRC RECON.
  
  FABJDFCN has been modified as follows:
   - Bypass to issue NOTIFY.IC command when Concurrent Image Copy
     is created by DFSMSdss DUMP command and DB record or DBDS
     record of target database is not registered in DBRC RECON.
   - Bypass to issue message FABJ4217I ( MSGFABJ4217I ) when
     NOTIFY.IC command is not issued.
  
  FABJRDBA,FABJRDBB,FABJRDB7,FABJRDB8 and FABJRDB9 have been
  modified not to use a DD name in ADS list of target AREA for DD
  name of output DBDS when recovers from Fast Recovery image copy
  of DEDB and DB record or DBDS record of target database is not
  registered in DBRC RECON.
  
  The following modules have been reassembled.
   FABJDBRA FABJDBRB FABJDBR7 FABJDBR8 FABJDBR9 FABJDFCA FABJDFCB
   FABJDFC7 FABJDFC8 FABJDFC9
  

Temporary fix

Comments

APAR Information

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

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

  UK58941

Modules/Macros

• FABJDBRA FABJDBRB FABJDBRC FABJDBR7 FABJDBR8
  FABJDBR9 FABJDFCA FABJDFCB FABJDFCN FABJDFC7 FABJDFC8 FABJDFC9
  FABJRDBA FABJRDBB FABJRDB7 FABJRDB8 FABJRDB9
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK58941

     UP10/07/21 P F007 Ø

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.