A fix is available
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 number
PH07596
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
100
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2019-01-22
Closed date
2019-10-03
Last modified date
2019-11-01
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
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":"5.4","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":"5.4","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
01 November 2019