PK47226: RECOVERY FAILS AFTER MESSAGE FRD4308I IC RESTORE STOPPED. OUTPUT RECORD LENGTH ERROR:

APAR status

• Closed as program error.

Error description

• After the following messages have been received :
  FRD4308I IC RESTORE STOPPED. OUTPUT RECORD LENGTH ERROR:
  DBD=CMDDBD04 DDN=CMDEDI   WITH
  FRD4100I DSNAME=DY.IMSVE.FCMDEDI.CLUSTER
  FRD4301I DATA SET RESTORE FAILED:  CMDDBD04 CMDEDI
  you suspect a problem with the Image Copy header containing a
  different LRECL than the one shown by the listcat (4089).
  Had a look at the IC header record and can see the following:
             - DKBLKSZ  = x'1000'  4096   KSDS BLOCK SIZE
               DHRECLEN = x'0FF9'  4089   KSDS RECORD LENGTH
               DHOSBLK  = x'1000'  4096   OSAM BLOCK SIZE
               DHOSRECL = x'0FF9'  4089   OSAM RECORD LENGTH
  So, looks like in FRXIVCN0, the test should return a good
  VSAMOUT_RC ....
  
  The problem is :
  DRF is using the AVGLRECL which is 14 for it's comparision.  A
  change to use the MAXLRECL (4089) instead is needed.
  These two values are only different for variable length dbs.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS Database Recovery Facility Version 3 *
  *                 Release 1 users with variable length         *
  *                 database data sets.                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: DRF users may encounter MSGFRD4308I IC  *
  *                      RESTORE STOPPED OUTPUT RECORD LENGTH    *
  *                      ERROR while attempting to recover a     *
  *                      variable length database data set.      *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  DRF compares the record length obtained from the image copy
  header record against the average record length from the DBD.
  If the two lengths do not match, then DRF will fail with
  MSGFRD4308I IC RESTORE STOPPED OUTPUT RECORD LENGTH ERROR.
  This comparision, however, is not valid in cases where the
  database is variable length.  In these situations, the
  maximum record length should be used instead of the average
  record length.
  

Problem conclusion

• AIDS: RIDS/UTIL RIDS/DBS DBS/UTIL
    DEP: NONE
    GEN:
  
  *** END IMS KEYWORDS ***
  FRXIVCN0 is changed to obtain the maximum record length of a
  database data set from the CATALOG.  This value is used instead
  of the average record length.
  
  FRXMTC, FRXBDMG0, and FRXVRCV0 are changed to issue MSGFRD1011
  DATABASE RECOVERY TERMINATING, END OF RECOVERY WITH ERRORS if
  recovery was allowed to continue even after one or more
  database data sets failed.
  
  The following DOC change is made:
  ---------------------------------------------------------------
  IMS Database Recovery Facility for z/OS Version 3 Release 1
  User's Guide and Reference
  Chapter 7. Messages and Codes of IMS Database Recovery Facility
  
  A new message text and description is added for the following:
  
  FRD1011I DATABASE RECOVERY TERMINATING, reason
  ...
  * END OF RECOVERY WITH ERRORS
  
  System action:
  The IMS Database Recovery Facility address space ends.  END OF
  RECOVERY WITH ERRORS means that one or more database data sets
  failed recovery, however, other database data sets in the
  recovery list were allowed to complete successfully.
  
  System programmer response:
  If the reason is INITIALIZATION FAILURE, EARLY END OF RECOVERY,
  or END OF RECOVERY WITH ERRORS, examine accompanying messages
  and take the action indicated by those messages.
  

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:

  UK26469

Modules/Macros

• FRXBDMG0 FRXIVCN0 FRXMTC   FRXVRCV0
  

Fix information

• Fixed component name

  IMS DB RECOVERY

• Fixed component ID

  5655I4400

Applicable component levels

• R310 PSY UK26469

     UP07/06/26 P F706