PH67034: A FILE CLOSE RECORD IS SOMETIMES NOT WRITTEN TO THE REPLICATION LOGSTREAM WHEN AN RLS FILE IS CLOSED.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A File Close record is sometimes not written to the replication
  logstream when an RLS file is closed.
  
  The problem happens for RLS files that specify LOGREPLICATE and
  a LOGSTREAMID, and do *not* specify LOG(ALL).   Defined that
  way, the file is setup to do replication logging, and is not
  setup to do Forward Recovery logging.   When such a file is
  closed in a CICS Region, the CICS region should always write a
  File Close record to the replication logstream.
  
  The logstream specified in LOGSTREAMID in the IDCAMS DEFINE
  CLUSTER definition of an RLS file serves as the name of either
  logstream.  This logstream should always be closed
  by the CICS region that is closing the RLS file.   The closing
  of the logstream flushes out the FILE_CLOSE record that was
  written to the logstream buffer. The error is that CICS
  only closes the logstream if Forward Recovery is active.   If
  Forward Recovery is not active but replication logging is
  active, CICS no longer closes the replication logstream.   This
  means that the FILE_CLOSE record written to the logstream buffer
  might not be flushed out to the logstream.   Whether or not it
  is flushed out depends on if there are other writes to that
  logstream that fill up the buffer which forces an I/O to the
  logstream.
  
  When the FILE_CLOSE record is never written to the logstream, it
  can cause any product using the replication logstream ( such as
  IIDR ) to be inefficient and do unnecessary work.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: Missing file close log record when a    *
  *                      file that uses replication logging is   *
  *                      closed.                                 *
  ****************************************************************
  DFHFCRO will only log a file close log record if
  the file being closed had FCTBCFR specified in its DSNB. This
  means forward recovery is specified for that file. A file can
  also be defined to use replication logging, and may not also use
  forward recovery. This means such a file will no longer cause a
  close record to be logged when the file is closed.
  

Problem conclusion

• DFHFCRO has been changed to write a file close record if either
  forward recovery or replication logging is specified in a file's
  DSNB.
  

Temporary fix

Comments

APAR Information

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

  PH67011

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

  UO04430

Modules/Macros

• DFHFCRO
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R500 PSY UO04430

     UP25/08/08 P F508

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.