PK60974: ALTHOUGH LCHKPT=N IS SPECIFIED, DFR DOES NOT CORRECTLY OUTPUT THE BACKOUT INFORMATION FOR DL/I-DB

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Although the LCHKPT=N parameter is specified, DFR does not
  correctly output the backout information for the DL/I database
  as follows:
  - Backout Required PSB list
  - The DBRC commands written to DBRCOUTL/DBRCOUTV DD
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS DEDB FAST RECOVERY Version 2         *
  *                 Release 2 (FMID=H1J2220) users.              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Although the LCHKPT=N parameter is      *
  *                      specified, DFR does not output the      *
  *                      backout information for DL/I database   *
  *                      to the following correctly:             *
  *                      - Backout Required PSB list             *
  *                      - The DBRC commands written to          *
  *                        DBRCOUTL/DBRCOUTV DD.                 *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  - When LCHKPT=N parameter is specified, DFR has used the oldest
    among the following ID as USING CHKPT.
    - BCPLDCID
    - BCPLCKID
    - BCPFCKID
    But it is possible that BCPBMPID is the oldest checkpoint.
    And DFR does not have to check BCPLDCID because BCPLDCID is
    not related to DB recovery.
    So DFR should check BCPBMPID instead of BCPLDCID.
  - If LCHKPT=N parameter is specified in DBCTL environment,
    and the logs started from the selected USING CHKPT do not
    include x'5607' log, DFR cannot get the UORTIME.
    DFR should save the UORTIME in x'47' log and x'4030' log to
    output the backout information correctly in this situation.
  

Problem conclusion

• The following modules have been modified.
  (x = 8, 9 and A)
  *
  DFRDCHPx - This module was changed so that DFR uses the oldest
             among the following ID as USING CHKPT when LCHKPT=N
             parameter is specified.
             - BCPBMPID
             - BCPLCKID
             - BCPFCKID
  DFRLUORx - This module was changed to save UORTIME in x'47' log
             and x'4030' log.
  *
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS DEDB Fast Recovery for z/OS Version 2 Release 2 User's Guide
  and Reference (Document Number: SC27-0928-03) should be changed
  as follows.
  ================================================================
  - The description of the LCHKPT parameter is changed as follows:
  *
  4.0 Input and output for DFR under IMS V8 and IMS V9
    4.1 Understanding the required input
     4.1.1 JCL requirements
                       :
                       :
                       :
      LCHKPT=
        Specifies whether to start recovery log processing from
  |     the Fast Path checkpoint (LCHKPT=Y) or from the checkpoint
  |     required for backout of DL/I databases (LCHKPT=N).
        The default is LCHKPT=Y.
              :
              :
              :
  *--------------------------------------------------------------*
  - The description of the Note: is changed as follows:
  *
     4.1.7 Skeleton JCL
      4.1.7.3 $$ statements
              :
              :
              :
  |    Note: If you specify LCHKPT=Y on the EXEC parameter, you
  |          may see incomplete commands.
  *
  *--------------------------------------------------------------*
  - The description of the Note: is changed as follows:
  *
    4.2 Understanding the output produced
     4.2.1 Backout Required PSB list
                       :
                       :
                       :
       DATABASE
         The DL/I databases (DBD name) that will be recovered
         when you run the Batch Backout utility.
  *
  |      Note: If you specify LCHKPT=Y on the EXEC parameter,
  |            you may see 'NOT FOUND' for UOR time or 'DBNAME
  |            NOT FOUND' for the DBD name.
  *
                       :
                       :
                       :
  ================================================================
  - The description of the LCHKPT parameter is changed as follows:
  *
  5.0 Input and output for DFR under IMS V10
    5.1 Understanding the required input
     5.1.1 JCL requirements
                       :
                       :
                       :
      LCHKPT=
        Specifies whether to start recovery log processing from
  |     the Fast Path checkpoint (LCHKPT=Y) or from the checkpoint
  |     required for backout of DL/I databases (LCHKPT=N).
        The default is LCHKPT=Y.
              :
              :
              :
  *--------------------------------------------------------------*
  - The description of the Note: is changed as follows:
  *
     5.1.7 Skeleton JCL
      5.1.7.3 $$ statements
              :
              :
              :
  |    Note: If you specify LCHKPT=Y on the EXEC parameter, you
  |          may see incomplete commands.
  *
  *--------------------------------------------------------------*
  - The description of the Note: is changed as follows:
  *
    5.2 Understanding the output produced
     5.2.1 Backout Required PSB list
                       :
                       :
                       :
       DATABASE
         The DL/I databases (DBD name) that will be recovered
         when you run the Batch Backout utility.
  *
  |      Note: If you specify LCHKPT=Y on the EXEC parameter,
  |            you may see 'NOT FOUND' for UOR time or 'DBNAME
  |            NOT FOUND' for the DBD name.
  *
                       :
                       :
                       :
  *
  

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:

  UK34468

Modules/Macros

• DFRDCHPA DFRDCHP8 DFRDCHP9 DFRLUORA DFRLUOR8
  DFRLUOR9
  

Fix information

• Fixed component name

  DEDB FAST RECOV

• Fixed component ID

  5655E3200

Applicable component levels

• R220 PSY UK34468

     UP08/03/14 P F803

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.