PM06687: NON RLS FILES TAKE RECOVERY ATTRIBUTES FROM VSAM CATALOG LOG PARAMETER WHEN SPECIFIED.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Recovery attributes for updatable files are loaded from the VSAM
  catalog, if they have been specified there. These settings
  override any settings given on the CICS file definition. This is
  not necessary for non-RLS files.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: A FILE is installed with                *
  *                      RECOVERY(BACKOUTONLY) specified on the  *
  *                      file definition. When the file is       *
  *                      opened it is not recoverable.           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A definition is installed for a VSAM FILE specifying
  RLSACCESS(NO) and RECOVERY(BACKOUTONLY). The underlying
  dataset specifies LOG(NONE) on the catalog. When
  the file is opened it is opened as not recoverable
  because CICS is honouring the recovery attribute
  specified on the catalog definition for both
  RLS and non-RLS files.
  

Problem conclusion

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• A new System Initialization Table (SIT) Parameter has been
  introduced - NONRLSRECOV. There are two possible options for
  this parameter. The default option is VSAMCAT, and means that
  file recovery attributes for non-RLS files should be built
  using values specified on the ICF Catalog Definition. If
  FILEDEF is specified, CICS will use the recovery attributes
  specified on the CICS File Definition.
  Files opened for RLS are not affected by this parameter.
  
  
  
  The CICS Transaction Server for z/OS, Version 3 Release 2,
  Data Areas manual (GC34-6863-02) will be updated as follows:
  
  Table 190 (FCS File Control Static Storage) on page 346 will be
  updated to read:
  (E8) CHARACTER 1 FC_FLAGS1          Flag byte 1
       1... ....   FCSCMPLT           FC restart complete
       .1.. ....   FC_NO_ENVIRONMENT  FC restart failed to rebuild
                                      FC environment
       ..1. ....   *                  Reserved
       ...1 ....   FC_XFCFRIN_ACTIVE  XFCFRIN active
       .... 1...   FC_XFCFROUT_ACTIVE XFCFROUT active
       .... .1..   FC_NONRLS_RECOV    Ignore LOG for non-RLS files
       .... ..11   *                  Reserved
  
  
  Table 494 (SIT System initialization table) on page 844 will be
  updated to read:
  (7CF) BIT(8)    1 SITFCFLG FC Flags
        1... ....   SITRLS   RLS enabled for this CICS
        .1.. ....   SITRTOL  RLS files in pool build
        ..1. ....   SITFCNRR NONRLSRECOV flag
        ...1 1.1.   *        Reserved
        .... .1..   SITFCTH  FC Threadsafe (FCQRONLY=NO):
        .... ...1   SITCILK  CI lock set for this CICS
  
  
  
  The CICS Transaction Server for z/OS Version 3 Release 2, System
  Definition Guide (SC34-6813-03) will be updated in Chapter 17
  Specifying CICS system initialization parameters, in the section
  titled 'The system initialization parameter descriptions'
  with a new parameter - NONRLSRECOV
  
  NONRLSRECOV
   NONRLSRECOV={VSAMCAT|FILEDEF}
                -------
   Specifies whether CICS uses the recovery options of the VSAM
   catalog or the FILE resource for non-RLS files, including
   the CSD.
  
   Recovery options do not apply to read-only files.
  
     VSAMCAT
     -------    By default, CICS uses the recovery options that
                are specified on the VSAM catalog for non-RLS
                files. These recovery options include the LOG,
                LOGSTREAMID, and BWO options. If no recovery
                options are set, CICS uses the attributes on
                the FILE resource.
     FILEDEF
                For non-RLS files, including the CSD, CICS ignores
                any recovery options on the catalog and uses the
                values specified on the FILE resource instead.
                The recovery attributes for the CSD are set by
                the appropriate system initialization parameters.
  
  
  The same text will also be added to Chapter 2. Changes to system
  initialization parameters, in the section titled 'New system
  initialization parameters', in the following manuals:
  
  - The CICS Transaction Server for z/OS Version 3 Release 2,
  Migration from CICS TS Version 3.1 (GC34-6858-03)
  - The CICS Transaction Server for z/OS Version 3 Release 2,
  Migration from CICS TS Version 2.3 (GC34-6857-03)
  - The CICS Transaction Server for z/OS Version 3 Release 2,
  Migration from CICS TS Version 2.2 (GC34-6856-03)
  - The CICS Transaction Server for z/OS Version 3 Release 2,
  Migration from CICS TS Version 1.3 (GC34-6855-03)
  
  
  The CICS Transaction Server for z/OS Version 3 Release 2, System
  Definition Guide (SC34-6813-03) will be also be updated in
  the following locations.
  
  Chapter 7 Setting up the CICS system definition data set will be
  updated in the section titled 'Creating a CSD'.
  
  Step 6 will be removed and combined with step 3 so that the
  third bullet reads:
  
  Decide what backup and recovery procedures you require for your
  CSD. The CSD can use backup-while-open (BWO), which means that
  DFSMS components can back up the CSD while the data set is open
  for update. To use BWO, ensure that DFSMShsm and DFSMSdss
  components of DFSMS 1.2 or later are available. The CSD must
  have an ICF catalog entry and be defined in SMS-managed storage.
  
   * Define the recovery options for a CSD accessed in RLS mode:
        o Specify BWO(TYPECICS) in the ICF catalog to make the
          data set eligible for backup-while open.
        o Make the CSD a recoverable data set by specifying
          the appropriate LOG parameter in the ICF catalog.
   * Define the recovery options for a CSD accessed in
     non-RLS mode:
        o Make the data set eligible for backup-while-open
          by either specifying BWO(TYPECICS) in the catalog
          or setting the CSDBKUP system initialization
          parameter to DYNAMIC.
        o Make the data set recoverable by setting the
          appropriate LOG parameter in the ICF catalog
          entry or specifying the appropriate option on the
          CSDRECOV system initialization parameter.
          By default, the recovery options in the catalog
          override the attributes in the FILE resource.
          If no recovery options are set in the catalog,
          CICS uses the attribute values of the FILE resource.
          You can set the NONRLSRECOV system initialization
          parameter to FILEDEF, if you want CICS to always
          use the recovery options on the FILE resource
          instead of the catalog.
  
  
  Still in Chapter 7, the section titled 'Planning for backup
  and recovery' will be updated in the fourth paragraph
  so that it reads:
  
  For a CSD opened in non-RLS mode, the recovery attributes can
  be defined in the ICF catalog entry for the CSD, or on the CSD
  system initialization parameters. The forward recovery
  log stream name (LSN) is retrieved from either CSDFRLOG or the
  ICF catalog. If LOG is defined in the catalog, the forward
  recovery log stream specified in the catalog is used. If LOG is
  not defined, the CSDFRLOG journal ID is used to determine the
  log stream name. If the NONRLSRECOV system initialization
  parameter is set to FILEDEF, the CSDFRLOG journal ID is always
  used to  determine the logstream name. Any recovery attributes
  specified on the ICF catalog are ignored.
  
  
  Chapter 17 Specifying CICS system initialization parameters,
  will be updated in Table 25 'DFHSIT, the pregenerated
  default system initialization table', with a new entry for
  NONRLSRECOV:
  Parameter   | Default Value | Description
  NONRLSRECOV | VSAMCAT       | Select location of recovery
              |               | options for non-RLS files
  
  
  
  The CICS Transaction Server for z/OS Version 3 Release 2,
  Resource Definition Guide (SC34-6815-03) will be updated in
  Chapter 14 FILE resource definitions, in the section titled
  'FILE definition attributes'.
  
  
  The BACKUPTYPE attribute description will be updated in its
  first paragraph to read:
  
  CICS VSAM files can be defined as eligible for backup while
  open for update. This attribute is not used for files defined
  with RLSACCESS(YES), or if the recovery options are defined
  in the ICF catalog. To force CICS to use this attribute
  instead of the recovery options in the catalog, set the
  NONRLSRECOV system initialization parameter to FILEDEF.
  For files that are accessed in RLS mode, you must specify
  the backup type on the data set definition in the ICF catalog.
  
  
  The paragraph beginning 'If you define' will also be
  updated to read:
  
  If you define the recovery attributes for a file in the ICF
  catalog entry for the corresponding data set, CICS always uses
  the ICF catalog recovery attributes and ignores those in the
  FILE resource. To force CICS to use the FILE resource
  attributes instead of the recovery options in the catalog,
  set the NONRLSRECOV system initialization parameter to FILEDEF.
  You can alter the recovery attributes defined in the ICF
  catalog by using the IDCAMS ALTER command. This is not
  prevented while there are ACBs open for a data set. However,
  if you change the recovery attributes, be aware of the
  possible effect on data integrity.
  
  
  The RECOVERY attribute description will also be updated in
  the paragraph starting 'This attribute is not used for files
  defined' to read as follows:
  
  This attribute is not used for files defined with
  RLSACCESS(YES), or if the recovery options are defined in the
  ICF catalog. If LOG is defined in the ICF catalog, CICS ignores
  the RECOVERY option and takes the LOG value from the ICF
  catalog, even for files defined with RLSACCESS(NO). If
  LOG(ALL) is specified in the ICF catalog, CICS also takes
  the LOGSTREAMID and BWO values from the ICF catalog. To
  force CICS to use this attribute instead of the recovery
  options in the catalog, set the NONRLSRECOV system
  initialization parameter to FILEDEF.
  
  
  
  The CICS Transaction Server for z/OS Version 3 Release 2
  Recovery and Restart Guide (SC34-6832-03) will be updated
  in the following chapters.
  
  Chapter 10 Planning Considerations will be updated in the
  section titled 'System initialization parameters' (within
  the section titled 'System definitions for recovery-related
  functions') to include a new entry for SIT parameter
  NONRLSRECOV in the list of parameters there:
  
  NONRLSRECOV={VSAMCAT|FILEDEF}
               -------
  
  
  Chapter 12 Defining recoverability for CICS-managed resources
  will be updated in section 'Recovery for files', subsection
  'Defining files as recoverable resources'. The second bullet
  point will be changed to read:
  
  If your VSAM data sets are accessed by CICS in non-RLS mode,
  you can define recovery attributes in either the FILE resource
  or the ICF catalog.  If you use the ICF catalog to define
  attributes for data sets accessed in non-RLS mode, CICS uses
  the ICF catalog entry recovery attributes instead of the FILE
  resource. To force CICS to use the FILE resource attributes
  instead of the catalog, set the NONRLSRECOV system
  initialization parameter to FILEDEF.
  
  
  
  Chapter 19 Backup-while-open (BWO) will be updated in the
  section titled 'How you request BWO'. The paragraph beginning
  'Defining BWO' will be updated to read:
  
  Defining BWO in the ICF catalog requires DFSMS 1.3. For data
  sets that are accessed in RLS mode, the BWO option must be
  defined in the ICF catalog. Recovery attributes for data
  sets that are accessed only in non-RLS mode can be defined
  either in the ICF catalog or in the CICS FILE resource.
  If BWO is defined in the ICF catalog definition, by default
  it overrides any BWO option defined in the FILE resource.
  To force CICS to use the FILE resource attributes instead
  of the catalog recovery options, set the NONRLSRECOV
  system initialization parameter to FILEDEF.
  

APAR Information

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

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

  PM19961 UK60407

Modules/Macros

•    DFHFCN   DFHFCNO  DFHFCRP  DFHFCSDS DFHFCSPS
  DFHPASY  DFHSIT   DFHSIT$$ DFHSITPS
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R500 PSY UK60407

     UP10/09/21 P F009

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.