PH07596: EXCLUSIVE CONTROL CONFLICT ON RLS DELETE FOLLOWING READ UPDATE USING RIDFLD

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Record Level Sharing RLS EXEC CICS Delete with RIDFLD fails
  with exclusive control conflict FCXCSUSP if preceded by
  a Read Update with RIDFLD.
  

Local fix

• For NON-RLS use DFHSIT parameter CILOCK=NO. For RLS code a
  userexit to remove the RIDFLD from the Delete.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: CICS Users migrating to VSAM RLS.            *
  ****************************************************************
  * PROBLEM DESCRIPTION: AFCG abend executing EXEC CICS DELETE   *
  *                      command when migrating from LOCAL       *
  *                      VSAM to RLS.                            *
  ****************************************************************
  When you are migrating from non-RLS to RLS access mode,
  potential AFCG abends might occur if a transaction issues a
  sequence of file control requests that would cause the file to
  deadlock itself.
  If a file is being accessed in non-RLS mode, an AFCG abend is
  caused by a transaction making conflicting requests against the
  same control interval (CI). For example, if a file is being
  accessed in LSR mode, a self deadlock might arise when a
  transaction issues a DELETE request on a record in the CI that
  is also the subject of a READ UPDATE request issued by the same
  transaction. However, if the system initialization parameter
  CILOCK=NO is in effect to prevent non-RLS VSAM from retaining
  the CI lock after a READ UPDATE command, the AFCG abend would
  not be returned as no self-deadlock condition occurs on the
  DELETE request. However, CILOCK is not relevant for RLS, so
  after the files are migrated to RLS access mode, AFCG abends can
  occur for the reasons given above.
  

Problem conclusion

• New feature toggle com.ibm.cics.rls.delete.ridfld has been added
  to aid migration to RLS by providing the ability to allow CICS
  to match the behaviour of local VSAM with SIT Parm CILOCK=NO
  when issuing an EXEC CICS READ UPDATE RIDFLD followed by an
  EXEC CICS DELETE RIDFLD.
  
  There will be the following changes to the CICS TS for z/OS 5.4
  and 5.5 Knowledge Centers.
  https://www.ibm.com/support/knowledgecenter/en/SSGMCP_5.4.0/
  https://www.ibm.com/support/knowledgecenter/en/SSGMCP_5.5.0/
  
  1. upgrading/changes/feature-toggle-changes.html
  Update Table 1 to have a new row.
  Feature Name: Avoid the potential of AFCG abends when using
  DELETE RIDFLD on RLS files
  Feature toggle for enabling the feature:
  com.ibm.cics.rls.delete.ridfld= { false | true }
  V5.4 & V5.5: APAR PH07596
  
  2. reference/abend-codes/AFxx_abend_codes/AFCG.html
  Extend User Response to add paragraph:
  When the file is being accessed in RLS mode, if the programming
  error is a READ UPDATE with RIDFLD specified followed by a
  DELETE with RIDFLD specified, consider using the feature toggle
  com.ibm.cics.rls.delete.ridfld to allow the DELETE with RIDFLD
  command to succeed. This is intended as a migration aid when you
  are converting to RLS from local VSAM with CILOCK=NO specified
  in CICS. For more information, see VSAM RLS.
  
  3. reference/commands-api/dfhp4_delete.html
  New box note added to the Description:
  NOTE: If you are converting to RLS access mode and are using
  the system initialization parameter CILOCK=NO in CICS, see VSAM
  RLS for migration considerations and advice.
  
  4. configuring/parallel-sysplex/vsam_rls.html
  Add new section entitled "Considerations for migrating from
  non-RLS to RLS access mode" explaining how AFCG abends can occur
  and how the feature toggle com.ibm.cics.rls.delete.ridfld=true
  can assist in migration.
  
  5. installing/dfha1dg.html
  Add new section entitled "Considerations for migrating from
  non-RLS to RLS access mode"
  When you are migrating from non-RLS to RLS access mode, to avoid
  potential AFCG abends, consider enabling the following feature
  toggle:
  com.ibm.cics.rls.delete.ridfld=true
  For details on why AFCG abends might occur and how this feature
  toggle can solve this issue, see VSAM RLS.
  
  6. reference/data-areas/DFHFCSKS.html
  Add new row into table for FCS - File control static storage
  (E4) | .... ..1. | | FC_DELETE_RIDFLD | Allow with DELETEs
  
  7. reference/data-areas/DFHFRTEK.html
  Add new row into table for FRTEC - File Request Thread Element
  (1D) | 1... ....| | FRT_READ_UPDATE_THEN_DELETE |
  Allow RIDFLD delete
  

Temporary fix

Comments

APAR Information

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

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

  UI65671 UI65672

Modules/Macros

• DFHAMFC  DFHAMPFI DFHAPLI1 DFHAPSM  DFHAPTR5 DFHBALR2 DFHBALR3
  DFHBALR4 DFHBALR6 DFHBALR7 DFHBALR8 DFHBALR9 DFHBRNS  DFHDMPCA
  DFHDMRM  DFHDPFM  DFHDPLM  DFHDPUM  DFHDTLA  DFHDTLX  DFHEDFX
  DFHEIFC  DFHEIQCF DFHEIQDN DFHEIQDS DFHEIQMS DFHEIQSA DFHEIUOW
  DFHEJOB  DFHEJOS  DFHERM   DFHESE   DFHFCAT  DFHFCBD  DFHFCBU
  DFHFCCA  DFHFCDL  DFHFCDN  DFHFCDO  DFHFCDR  DFHFCDTS DFHFCDTX
  DFHFCDU  DFHFCDUF DFHFCDW  DFHFCDY  DFHFCES  DFHFCFL  DFHFCFR
  DFHFCFRT DFHFCFS  DFHFCIN1 DFHFCIN2 DFHFCIR  DFHFCL   DFHFCLF
  DFHFCLJ  DFHFCLJ1 DFHFCM   DFHFCMT  DFHFCN   DFHFCNQ  DFHFCOR
  DFHFCQI  DFHFCQR  DFHFCQS  DFHFCQT  DFHFCQU  DFHFCQX  DFHFCRC
  DFHFCRC2 DFHFCRD  DFHFCRF  DFHFCRL  DFHFCRN  DFHFCRO  DFHFCRP
  DFHFCRR  DFHFCRS  DFHFCRV  DFHFCSD  DFHFCSDS DFHFCST  DFHFCU
  DFHFCVC  DFHFCVR  DFHFCVS  DFHFCXDF DFHFRDUF DFHISFS  DFHMIRS
  DFHRSDU  DFHRSSR  DFHRSTP  DFHRSXM  DFHSHDM  DFHSHPR  DFHSHRE1
  DFHSHRM  DFHSHRQ  DFHSHRQ1 DFHSHRR  DFHSHTI  DFHSHXM  DFHSTFC
  DFHSTLS  DFHSTP   DFHTFP   DFHUEH   DFHW2FI  DFHW2FR  DFHXFP
  DFHXFQ   DFHXFRM  DFHXFX
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R100 PSY UI65672

     UP19/10/12 P F910

• R200 PSY UI65671

     UP19/10/12 P F910

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.