A fix is available
APAR status
Closed as new function.
Error description
FILE CONTROL THREADSAFETY ENABLER FOR LOCAL VSAM LSR FILES
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS Users. * **************************************************************** * PROBLEM DESCRIPTION: Threadsafety of file control requests * * to local VSAM files is disabled. * **************************************************************** * RECOMMENDATION: * **************************************************************** When a program is defined as CONCURRENY(THREADSAFE) and FCQRONLY(NO) is specified in the SIT, local VSAM requests had not been enabled to run threadsafe.
Problem conclusion
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
DFHFCRP has been altered to enable threadsafety for local VSAM files defined as LSR when running z/OS 1.9 or higher. To run with threadsafety enabled on z/OS 1.9, VSAM apars OA20352 and OA24071 must first be applied. When CICS is run on z/OS lower than 1.9, commands against local VSAM files will not be threadsafe. The SIT parameter FCQRONLY has been changed. The default will now be FCQRONLY=YES. This will affect RLS threadsafety if the SIT parameter had been allowed to default to FCQRONLY=NO. It must now be explicitly set to enable threadsafety. If a local VSAM file is defined as NSR, or transaction isolation is being used in a transaction defined with ISOLATE(YES) against an LSR file, then these commands are not threadsafe. The following documentation changes are required: The CICS Transaction Server for z/OS, System Definition Guide, Version 3 Release 2 manual, SC34-6813-01, Part 3, Chapter 17, section 'The system initialization parameter descriptions' has been updated. The explanation for FCQRONLY has been replaced by the following: FCQRONLY={NO|YES} (Yes is underlined) Specifies whether you want CICS to force all user application programs that are specified as threadsafe to run file control requests under the CICS QR TCB, as if they were specified as quasi-reentrant programs. NO CICS honors the CONCURRENCY(THREADSAFE) attribute on program resource definitions, and allows user application programs to run applicable file control requests on an open TCB to avoid unnecessary TCB switching. YES (Yes is underlined) CICS forces all file control requests to run under the CICS QR TCB, as if they were non-threadsafe EXEC CICS commands. With all file requests on the QR TCB, CICS is able to minimise the amount of locking required at the expense of additional TCB switches if requests were issued from applications running on OPEN TCBs. The FCQRONLY=YES setting can improve the performance of file-owning regions. APAR PK45354 changes the default from NO to YES. Local VSAM threadsafety requires CICS APAR PK45354, z/OS 1.9 with APARs OA20352 and OA24071. If run on z/OS 1.7 or z/OS 1.8, these commands are not threadsafe for local VSAM files. ------------------------------------------------------------- The CICS Transaction Server for z/OS, Migration from CICS TS Version 3.1, Version 3 Release 2 manual, GC34-6858-01, Part 1, Chapter 2, section 'New system initialization parameters' has been updated to replace the explanation for the FCQRONLY parameter with the same text as for the System Definition Guide. The same changes have been made to the other migration guides: CICS Transaction Server for z/OS, Migration from CICS TS Version 2.3, Version 3 Release 2, GC34-6857-01. CICS Transaction Server for z/OS, Migration from CICS TS Version 2.2, Version 3 Release 2, GC34-6856-01. CICS Transaction Server for z/OS, Migration from CICS TS Version 1.3, Version 3 Release 2, GC34-6855-01. ------------------------------------------------------------- The CICS Transaction Server for z/OS, Release Guide Version 3 Release 2, GC34-6811-01, Part 6, Chapter 48, section 'API commands that are now threadsafe for local VSAM or RLS files' has been updated to read as follows: API commands that are now threadsafe for local VSAM or RLS files DELETE ENDBR READ READNEXT READPREV RESETBR REWRITE STARTBR UNLOCK WRITE These commands are threadsafe if the file to which they refer is defined as either local VSAM or RLS. Local VSAM threadsafety requires CICS APAR PK45354, z/OS 1.9 with APARs OA20352 and OA24071. If run on z/OS 1.7 or z/OS 1.8, these commands are not threadsafe for local VSAM files. If a local VSAM file is defined as NSR, or transaction isolation is being used in a transaction defined with ISOLATE(YES) against an LSR file, these commands are not threadsafe. If the file is defined as remote, or is a shared data table, a coupling facility data table, or a BDAM file the commands are not threadsafe. ------------------------------------------------------------- The CICS Transaction Server for z/OS, Performance Guide Version 3 Release 2, GC34-6833-01, Part 2, Chapter 15, section 'Local shared resources (LSR) or Nonshared resources (NSR)' has been changed as follows: After the line ' NSR is not supported for transactions that use transaction isolation. ' add ' File control commands using NSR files are not threadsafe.' --------------------------------------------------------------- The CICS Transaction Server for z/OS, Version 3 Release 2, Data Areas manual, GC34-6863-00, has been changed in section 'FCS File control static storage' as follows: (E4) CHARACTER 1 FC_THREADSAFE_FLAGS ... .1.. FC_VSAM_TRACE Trace all VSAM reqs .... ..11 * Reserved (E5) UNSIGNED 1 FC_0890_MAX_RETRY Max No. retries (E6) CHARACTER 2 * Reserved Section 'SIT System initialisation table' has been updated as follows: (7CF) BIT(8) 1 SITFCFLG FC Flags 1... .... SITRLS RLS enabled for this CICS .1.. .... SITRTOL RLS files in pool build ..11 1.1. * Reserved .... .1.. SITFCTH FC Threadsafe (FCQRONLY=NO) .... ...1 SITCILK CI lock set for this CICS Section 'VSWA FC VSAM work area' has been updated as follows: (74) CHARACTER 1 VSWAFLG1 Flag byte 1 .... ..1. VSWA_080X14 index and base may be out of sync (75) CHARACTER 1 VSWAFLG2 Flag byte 2 ..1. .... VSWA_PURGE_PROTECT Start Purge Prot ...1 .... VSWA_REPAIR Reposition needed .... 1... VSWA_RETRY_USING_BASE Use Base ACB .... .111 * Reserved (94) UNSIGNED 1 VSWA_VICTIM_COUNT No. of attempts to kill this VSWA (C0) CHARACTER 288 VSWA_TRACE_TABLE (C0) CHARACTER 16 VSWA_TRACE_DIAGS Diags for this task (D0) CHARACTER 8 VSWA_SUSP last suspend call (D8) UNSIGNED 1 VSWA_DEADLOCK_RSN deadlock reason (D9) CHARACTER 3 * Spare --------------------------------------------------------------- The CICS Transaction Server for z/OS, Trace Entries, Verison 3 Release 2 manual, SC34-6828-01, has been changed in Chapter 2, section 'File control trace points (AP 0410 - AP 04FB)' to add a new trace point AP 0491 as follows: AP 0491 DFHFCVR Event VSAM Request 1 VSWA Trace Table 2 Key 3 Base Key Trace points 04B6 and 04B7 have been updated as follows: AP 04B6 DFHFCVS Exc Purged 1 FCFR parameter list 2 Transaction name 3 VSWA Trace Table AP 04B7 DFHFCVS Exc Nonzero VSAM 1 FCFR parameter list return code 2 RPL 3 RPL address 4 File name 5 Transaction name 6 VSWA Trace Table ž**** PE10/05/26 FIX IN ERROR. SEE APAR PM13330 FOR DESCRIPTION ž**** PE10/06/24 FIX IN ERROR. SEE APAR PM10667 FOR DESCRIPTION
APAR Information
APAR number
PK45354
Reported component name
CICSTS 3.X Z/OS
Reported component ID
5655M1500
Reported release
500
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function
Submitted date
2007-05-18
Closed date
2008-06-30
Last modified date
2010-06-29
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK37688
Modules/Macros
DESFCCA DESFCCM DESFCRD DESFCRO DESFCRS DESFCRV DESTDA DFHAPTR5 DFHFCCA DFHFCCAA DFHFCCAM DFHFCCAT DFHFCCMS DFHFCDMS DFHFCDN DFHFCDUF DFHFCFL DFHFCFR DFHFCFS DFHFCLMS DFHFCMT DFHFCNQ DFHFCQU DFHFCRC DFHFCRD DFHFCRO DFHFCRP DFHFCRR DFHFCRS DFHFCRV DFHFCSD DFHFCSPS DFHFCST DFHFCTRM DFHFCVR DFHFCVS DFHFCVS1 DFHLGFLC DFHLGFLD DFHLGGL DFHPASY DFHSIT DFHSIT$$ DFHSITPS DFHSIT6$ DFHTDA DFHVSWAS DFHXFP DFHXFX
| SC34681301 | GC34685801 | GC34685701 | GC34685601 | GC34685501 |
| GC34681101 | GC34683301 | GC34686300 | SC34682801 |
Fix information
Fixed component name
CICSTS 3.X Z/OS
Fixed component ID
5655M1500
Applicable component levels
R500 PSY UK37688
UP08/07/02 P F807
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":"3.2","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":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
29 June 2010