PK45354: FILE CONTROL THREADSAFETY ENABLER FOR LOCAL VSAM LSR FILES

A fix is available

Subscribe

You can track all active APARs for this component.

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
    

Publications Referenced
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.



Rate this page:

(0 users)Average rating

Document information


More support for:

CICS Transaction Server

Software version:

3.2

Reference #:

PK45354

Modified date:

2010-06-29

Translate my page

Machine Translation

Content navigation