A fix is available
APAR status
Closed as program error.
Error description
The DFHFC0001 dump is taken as a result of an 0C4 in IAM module IAMCOMPO + x'0A26'. The cause of the 0C4 is that field RPLAREA (or VSWAREA) is zeroes when a GET request is issued against a file with an alternate index. The RPLAREA (VSWAREA) should be set up from FRT_DATA_BUFFER in DFHFCVS. However, it does not appear that DFHFCVS has properly set up FRT_DATA_BUFFER prior to the call to proc ACCMTEST and subsequent call to DFHFCDTS. At the time the dump is taken, there is an ongoing browse in progress, and CICS has determined that the browse needs to be repositioned in order to satisfy the current READ PREVIOUS request. During the reposition, we test to see if the key is all x'FF's. In this case it is, and we issue a READ NEXT SET command to help position the browse pointer correctly. The original user request was for a READ PREVIOUS INTO, so no SET storage area is available (this is normally addressed from FRT_DATA_BUFFER, but is only initialised for a SET command.) Herein lies the problem. During a READPREV INTO, CICS has issued an extra READNEXT SET, in order to reposition the browse. Nothing has been set up in the FRT_DATA_BUFFER address, so when the request ultimately gets into the file manager system (VSAM/IAM) the RPLAREA contains zeros, and we get the 0C4 in IAMCOMPO. Additional Symptom(s) Search Keyword(s): FOR , AOR, HANG, FC0001, S0C4, IAM, KIXREVJJW
Local fix
n/a
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users. * **************************************************************** * PROBLEM DESCRIPTION: An abend S0C4 occurs during a READPREV * * INTO request against a CICS maintained * * data table. * **************************************************************** * RECOMMENDATION: * **************************************************************** An abend 0C4 occured during a READPREV INTO for a CICS maintained data table. In the reported instance of the problem, the file system being used was IAM. The S0C4 occured at offset x'0A26' in module IAMCOMPO. The problem also occurs using VSAM, in which case it is reported at offset x'FFFF' in DFHFCVR. . During a BROWSE operation, a READPREV INTO was issued for a record, with a key of all x'FF's. CICS determined that the browse needed to be repositioned. An attempt to read from the data table was made, but returned a DTP_EXCEPTION for reason DTP_NOT_IN_TABLE. This caused SOURCE_BROWSE_REPOSITION to be driven. Because the key was FFF..., it is necessary to issue an intervening READNEXT SET. The original request was an READPREV INTO, which meant that no SET storage had ever been created. On the call to VSAM/IAM, the RPLAREA passed was all zeros, leading to the 0C4. . The user transaction is abended AFCZ. . Additional Keywords: abendS0C4 abend0C4 abendAFCZ
Problem conclusion
DFHFCDTS has been changed to ensure that SET storage is initialised prior to the intervening READNEXT SET.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PM86461
Reported component name
CICS TS Z/OS V4
Reported component ID
5655S9700
Reported release
600
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2013-04-05
Closed date
2013-07-01
Last modified date
2013-08-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PM86711 UK95609 UK95610
Modules/Macros
DFHFCDTS
Fix information
Fixed component name
CICS TS Z/OS V4
Fixed component ID
5655S9700
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":"4.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":"4.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 August 2013