PI83313: DFHFC0307 SHOULD PROVIDE ADDITIONAL INFORMATION IN SYSTEM ACTIONAND USER RESPONSE FOR RESTORATION OF BUFFERS MARKED UNUSABLE.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• DFHFC0307 informs of an I/O error that temporarily disables a
  file.  A buffer that was in use during the I/O operation that
  failed will be marked UNUSABLE.  In order to restore the buffer
  to usability, the appropriate action is to close all files using
  the same LSRPOOL, and to reopen them.
  .
  The SYSTEM ACTION should state:
  Activity against the file is stopped, and the file is closed and
  then reopened in an attempt to release the VSAM output buffers
  (further action may be required - see USER RESPONSE). Until the
  close has completed successfully, the file appears 'UNENABLED'
  to new would-be users and they receive a 'NOTOPEN' response to
  requests to use the file.
  
  USER RESPONSE should read:
  The installation should follow its standard procedure for I/O
  errors.  The data set name and component code may help in
  identifying the problem. In order to fully release the VSAM LSR
  output buffers it may be necessary to close every other file in
  this CICS region using the same LSRPOOL, and subsequently reopen
  those files. If that is not possible, then you should consider
  restarting CICS, when possible, in order to reclaim the full
  complement of buffers.  If there are sufficient buffers defined,
  the loss of the buffers in use during the request that resulted
  in IOERROR will not prevent subsequent requests from processing
  normally until you can either close all the LSRPOOL files or
  restart CICS.
  

Local fix

• KIXREVEAA
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: The system action and user response for *
  *                      message DFHFC0307 needs to be extended. *
  ****************************************************************
  * RECOMMENDATION: .                                            *
  ****************************************************************
  MsgDFHFC0307 informs a user of an IO error reported by VSAM.
  This results in the file being closed and opened so that the
  associated buffers can be freed and reused. There are times when
  additional action is required to free those buffers. The
  system action and user response for message DFHFC0307 is being
  updated to reflect these additional actions.
  
  Additional Keywords: FC0307 0307 IOERR
  

Problem conclusion

• DFHMEFAE has been altered to update the system action and user
  response for message DFHFC0307.
  
  The IBM Knowledge Center for CICS Transaction Server 5.4.0
  (SK4T-2736-00) will all be updated in Reference > CICS
  Messages > DFHFCnnnn messages > DFHFC0307 so that the System
  Action and User Response sections are as follows:-
  
  System Action
  Activity against the file is stopped. The file is closed, then
  reopened in an attempt to release the VSAM output buffers.
  Further action might be required, see user response section.
  
  Until the close has completed successfully, the file appears
  UNENABLED to new, potential users. They receive a NOTOPEN
  response to requests to use the file. The application request
  which encountered the error receives an IOERR response.
  
  User Response
  The installation should follow the standard procedure for I/O
  errors. The data set name and component code might help in
  identifying the problem. To fully release the VSAM LSR output
  buffers, it might be necessary to close every file in this
  CICS region that uses the same LSRPOOL, and subsequently
  reopen those files. If that is not possible, then you should
  consider restarting CICS, to reclaim the full complement of
  buffers.
  
  If there are sufficient buffers defined, subsequent requests are
  not prevented from processing normally after an IOERR response.
  You should close all the LSRPOOL files or restart CICS as soon
  as possible.
  
  A description for message DFHFC0307 can be found in the CICS
  Transaction Server for z/OS, CICS Messages, Version 5 Release
  4 pdf.
  

Temporary fix

Comments

APAR Information

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

  PI79098

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

  UI49681

Modules/Macros

• DFHMEFAE
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R100 PSY UI49681

     UP17/08/23 P F708

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.