A fix is available
APAR status
Closed as program error.
Error description
ABEND0C4 in DFHFCN when issuing SHOWCAT against the data or index component of a VSAM cluster. CICS customer would have to go out of their way to define a dataset in this format. Customer will request the Open that has the .INDEX or .DATA component on the dataset. Instead of the RDO definition having DSNAME USASSC1.FILEA it has USASSC1.FILEA.INDEX. . DFHFCN issues a SHOWCAT with the DSNAME to find associations in routine FMOCFC08. This returns with RC00 and offset 8, SHWTYPE, set to C9 (I) indicating it is an Index entry, SHOWCAT would return C4 (D) if the data entry was in the RDO definition. . Since offset 8 (SHWTYPE) is not a C7 (AIX) or D9 (PATH) CICS marks it as ISABASE and branches to routine FMOCFC60 to get the associated INDEX and DATA entries. . In FMOCFC60 CICS sets R2 to the first association and R6 to the the number of associations. Since SHOWCAT returned an I (INDEX) map, and CICS treats it as a C (CLUSTER) map they set R6 to zeros (which is actually Relative Key Position for I type). . CICS then tries to find the C9 (I) INDEX entry for the first association and it's not equal so R2 is bumbed by four bytes to the next association and BCTR using R6 (which was 00000000 and now goes negative) and try the next association. CICS will stay to a page of until we either getto a page of storage that is not allocated or is fetch protected and receive ABEND0C4 or happen to find a C9 after many BCTRs.
Local fix
Do not include .INDEX or .DATA on File RDO definition
Problem summary
**************************************************************** * USERS AFFECTED: All CICS Users. * **************************************************************** * PROBLEM DESCRIPTION: msgDFHFC0304 and a system dump issued * * when attempting to open an INDEX or * * DATA component of a file cluster. * **************************************************************** * RECOMMENDATION: * **************************************************************** If a user mistakenly attempts to open an INDEX or DATA component of a file, the request will abend with AEXZ. The console will show msgDFHFC0974 followed by msgDFHFC0304 which will issue a system dump. This is due to code in DFHFCN being processed on the assumption that the request is being made against the base. Additional Keywords: DFHFC0304 FC0304 0304 .INDEX .DATA msgDFHFC0978 FC0978 0978 811C
Problem conclusion
Policing code has been added to DFHFCN to ensure that open requests against an INDEX or DATA component are rejected with console message DFHFC0978 with new return code X'811C' in module DFHFCFS. The CICS Transaction Server for z/OS Version 3 Release 1 CICS Messages and Codes, GC34-6442-03, Chapter 1: DFH messages; DFHFCxxxx messages; DFHFC0978 has been altered. There is now an additional return code. 811C The open was requested against the data association or the index association. The base cluster, AIX or path should be specified instead. The CICS Transaction Server for z/OS Version 3 Release 2 CICS Messages and Codes, GC34-6827-00, Chapter 1: DFH messages; DFHFCxxxx messages; DFHFC0978 has been altered. There is now an additional return code. 811C The open was requested against the data association or the index association. The base cluster, AIX or path should be specified instead.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PK58234
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
400
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2007-12-17
Closed date
2007-12-21
Last modified date
2008-01-03
APAR is sysrouted FROM one or more of the following:
PK57143
APAR is sysrouted TO one or more of the following:
UK32537 UK32549
Modules/Macros
DFHFCFS DFHFCN DFHFCNO DFHMEFBE DFH58234 MFHMEFBE
GC34644203 | GC34682700 |
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
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":"3.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":"3.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
03 January 2008