A fix is available
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 4 Release 1, Data Areas manual (GC34-7014-01) will be updated as follows: Table 201 (FCS File Control Static Storage) on page 367 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 536 (SIT System initialization table) on page 890 will be updated to read: (9CF) 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 4 Release 1, System Definition Guide (SC34-6999-01) will be updated in Chapter 16 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 4 Release 1, Upgrading from CICS TS Version 3.1 (GC34-6997-01) - The CICS Transaction Server for z/OS Version 4 Release 1, Upgrading from CICS TS Version 2.3 (GC34-6996-01) The CICS Transaction Server for z/OS Version 4 Release 1, System Definition Guide (SC34-6999-01) will be also be updated in the following locations. Chapter 5 Setting up the CICS system definition data set will be updated in the section titled 'Planning your CSD configuration'. 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. Chapter 5 will also be updated in the section titled 'Defining CSD attributes', subsection 'Procedure'. Step 2. will be updated to read: Define whether the CSD is eligible for BWO using the CSDBKUP parameter. This parameter is ignored if you specify CSDRLS=YES. CICS uses the BWO parameter in the ICF catalog instead. By default, CICS also uses the BWO parameter in the ICF catalog for non-RLS mode CSDs if the LOG parameter in the ICF catalog specifies either UNDO or ALL. You can set the NONRLSRECOV system initialization parameter to FILEDEF, if you want CICS to always use the CSDBKUP parameter over the BWO attribute. Step 7. will be updated to read: Define a forward recovery journal identifier using the CSDFRLOG parameter. This parameter is ignored if you specify CSDRLS=YES, or if the recovery attributes are defined in the ICF catalog on the LOG parameter, in which case LOGSTREAMID from the ICF catalog is used instead. You can set the NONRLSRECOV system initialization parameter to FILEDEF, if you want CICS to always use the CSDFRLOG parameter over the LOGSTREAMID attribute. Step 11. will be updated in its second paragraph to read: If CSDRLS=NO, this parameter is used only if LOG in the ICF catalog is undefined." By default, if LOG in the ICF catalog specifies NONE, UNDO, or ALL, the LOG parameter overrides the CSDRECOV value. You can set the NONRLSRECOV system initialization parameter to FILEDEF, if you want CICS to always use the CSDRECOV parameter over the LOG attribute. Still in Chapter 5, the section titled 'Planning for backup and recovery', subsection 'About this task' 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 16 Specifying CICS system initialization parameters, will also be updated in Table 17 '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 4 Release 1, Resource Definition Guide (SC34-7000-01) will be updated in Chapter 15 FILE resources, in the section titled 'FILE 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 Version 4 Release 1 Recovery and Restart Guide (SC34-7012-01) will be updated in the following chapters. 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 18 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 number
PM19961
Reported component name
CICS TS Z/OS V4
Reported component ID
5655S9700
Reported release
600
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2010-08-06
Closed date
2010-09-29
Last modified date
2010-12-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK60878 UK60879
Modules/Macros
DESPAIN DFHFCN DFHFCNO DFHFCRP DFHFCSDS DFHFCSPS DFHPAIN DFHPAINA DFHPAINM DFHPAINT DFHPASY DFHSIT DFHSIT$$ DFHSITPS EYUQ0197 EYUTNAGC
| GC34701401 | SC34699901 | SC34700001 | SC34701201 | GC34699701 |
| GC34699601 |
Fix information
Fixed component name
CICS TS Z/OS V4
Fixed component ID
5655S9700
Applicable component levels
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.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 December 2010