PK21822: NOTOPEN IS RETURNED ON A RLS FILE THAT HAS BEEN UNQUIESCED. THE FILE IS CLOSED UNENABLED AND MUST BE ENABLED MANUALLY.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• An RLS file is quiesced, and during this time it's opened by a
  batch job that copies, deletes, and redefines it.  The file
  remains inuse by a batch program during the quiesce period, and
  cannot be sucseffully accessed from CICS.  During this quiesce
  period, an application in CICS tries to access the file and
  receives a DFHFC0952 rc4 rsn210 stating that the file is inuse
  by another program.  After the RLS file is unquiesced, it's left
  in a closed unenabled state.  Applications receive NOTOPEN
  return codes until the file is manually set to closed enabled.
    The file was going through a series of quiesces and
  unquiesces.  If the file was open at the time of the quiesce,
  it would be marked as closed unenabled.  Then when the
  unquiesce is made, the file would be set to closed enabled.
  If an application tried to access the file when it was quiesced
  it would receive a notopen (due to the closed unenabled state).
  If the file remained closed across an unquiesce and quiesce
  sequence, the file state would be closed enabled on entry to
  the quiesce, and remain that way.  If an application tried to
  access the file during this quiesce phase a dynalloc request
  would be made because of the file's enabled state.  The request
  would fail with the DFHFC0952, because another job is using the
  file, and the file state in CICS would be set to closed unenabl-
  ed and remain that way after the unquiesce flowed.
    The file state needs to be set to closed enabled when the
  unquiesce is processed.  This would eliminate the need to
  manually reset the file state from unenabled to enabled.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: NOTOPEN is returned on a RLS FILE       *
  *                      that has been unquiesced.               *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  An RLS file is in CLOSED ENABLED state. Before it is opened the
  corresponding dataset is quiesced. Then a batch job has DISP=OLD
  against the dataset and while the batch job is running, CICS
  attempts to open the RLS file. The dynamic allocation fails and
  an OPEN/CLOSE FAILED error is received. Once the batch job has
  completed and the dataset is unquiesced, the RLS file is in
  CLOSED UNENABLED state. This leads to a NOTOPEN being returned
  to applications until the RLS file is manually set to CLOSED
  ENABLED.
  
  Additional Keywords: DFHFC0952 DFHFC0955 MSGDFHFC0952
                       MSGDFHFC0955 210 FCTUQENA
  

Problem conclusion

• The processing during OPEN FILE has been updated. When a dynamic
  allocation fails we now check to see if the dataset is quiesced.
  If so we treat the file as if the dynamic allocation has
  occurred until the DSNB active FCTE chain has been updated. A
  DATASET QUIESCED error will be returned to the OPEN FILE
  request. When the dataset is unquiesced, it will be placed in
  CLOSED ENABLED state since it was on the DSNB active FCTE chain.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PK17876

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

  UK13545

Modules/Macros

•    DESFCO1  DESFCRO  DFHFCRO
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK13545

     UP06/04/20 P F604

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.