PM28790: DFR V2R2 ENHANCEMENT TO SUPPORT THE EXTENDED FORMAT IMS LOG DATA SETS WHICH IS INTRODUCED IN IMS V12

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• DFR V2R2 enhancement to support the extended format IMS log
  data sets of IMS Version 12 Release 1.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS DEDB FAST RECOVERY Version 2         *
  *                 Release 2 (FMID=H1J2220) users who use IMS   *
  *                 V12.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: The extended format IMS log data sets   *
  *                      support.                                *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  DFR V2R2 enhancement to support the extended format IMS log data
  sets of IMS Version 12 Release 1.
  

Problem conclusion

Temporary fix

Comments

• The following module has been added.
  DFRFDLAC - The calculation of amount of space for the extended
             format data set.
  *
  The following modules and macros have been modified.
  DFRGAL1C - This module was changed so that the value of JFCBDSNM
             might be set to RLGDSNP/S field of RLGT in OLDSALLC
             sub-routine when DBRC=N was specified.
  DFRGEFCC - This module was changed so that the new EXEXTNT sub-
             routine for calculating amount of space for the
             extended format OLDS might be added.
  DFRGRD1C - This module was changed as follows:
             . The new EXEXTNT sub-routine for calculating amount
               of space for the extended format OLDS might be
               added.
             . The track number used for checking whether a
               checkpoint is out of extent might be calculated in
               the extended format OLDS.
  DFRNGCLC - This module was changed so that the 'INOUT' option
             might be specified to an OPEN macro when re-opening
             the extended format OLDS.
  DFRRSCDC - It was reconstructed by change of a DFRRLGTC macro
             and a DFRRSCC macro.
  DFRRLGTC - The PASTEOD=YES flag in DCBE for OLDS was turned off.
  DFRRSCC  - New V-CON field for new DFRFDLAC module was added.
  *
  The following sample JCL has been replaced.
  DFRLINK  - The additional module by this PTF was added.
  *
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS DEDB Fast Recovery for z/OS Version 2 Release 2 User's Guide
  and Reference (Document Number: SC27-0928-04) should be changed
  as follows.
  ================================================================
    1.6 Processing environment limitations
  .
  The following limitation is deleted:
  .
        DFR does not support IMS log data set as a DFSMS striped
        extended-format data set, which is supported by IMS
        Version 12 Release 1.
  *
  ================================================================
    4.2 Input in an IMS V10 or later environment
      4.2.1 JCL requirements
                      :
      DFSOLPnn DD
      DFSOLSnn DD
       Specifies the online log data sets (OLDSs) that IMS DEDB
       Fast Recovery is to read to determine the recovery start
       checkpoint.
       nn is 00 - 99. DFSOLPnn indicates the primary OLDS, and
       DFSOLSnn indicates the secondary OLDS. The OLDS ddnames are
       the same as the ddnames used at IMS online execution.
  .
       The OLDS defined as a large format data set can be
       specified.
  .
  |    The OLDS defined as a DFSMS striped extended-format data
  |    set can be specified.
       ....
  *
      IMSLOGR  DD
      IMSLOGR2 DD
      ssssssss DD
       Specifies the system log data sets (SLDSs) that IMS DEDB
       Fast Recovery is to read to determine the recovery start
       checkpoint.
  .
       The SLDS defined as a large format data set can be
       specified.
  .
  |    The SLDS defined as a DFSMS striped extended-format data
  |    set can be specified.
       ....
  *
  ================================================================
    8.4 Messages
  .
    The following message is added.
  .
       DFR3109E xxxxxxxxxxx ERROR IN OLDS DDNAME=ddname
  .
       Explanation:
         An attempt to calculate amount of space for the OLDS of
         the indicated 'ddname' that was in use when IMS failed
         has resulted in error indicated by the error type of
         xxxxxxxxxxx.
  .
         Type        Meaning
         DEVTYPE     MVS DEVTYPE macro has returned an error code.
         ISITMGD     MVS ISITMGD macro has returned an error code.
         TRKCALC     MVS TRKCALC macro has returned an error code.
         OBTAIN      MVS OBTAIN macro has returned an error code.
         ZERO BLOCKS MVS TRKCALC macro gave blocks per track value
                     of zero.
         ZERO TRACKS The number of calculated tracks is zero.
  .
       System action:
         The job ends with an abend code of U3109.
  .
       User Response:
         Check if the DD statement for OLDS is specified
         correctly. If there is any error, correct it and rerun
         the job. If there is no error in the DD statement,
         contact IBM Software Support.
  *
  

APAR Information

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

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

  UK63490

Modules/Macros

• DFRFDLAC DFRGAL1C DFRGEFCC DFRGRD1C DFRLINK
  DFRNGCLC DFRRLGTC DFRRSCC  DFRRSCDC H1J2220J
  

Fix information

• Fixed component name

  DEDB FAST RECOV

• Fixed component ID

  5655E3200

Applicable component levels

• R220 PSY UK63490

     UP10/12/28 P F012

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.