A fix is available
APAR status
Closed as program error.
Error description
Customer has a shared DFHCSD defined with SHROPTS(2,3) which allows only one user to open for output (Write) at a time. During the failing scenario, region A had the DFHCSD open for output while region B also needed the DFHCSD open for output. Message DFHFC0987 was produced to report VSAM return and reason codes as follows: DFHFC0987 applid Non-RLS OPEN of file DFHCSD failed: Not available for type of processing. VSAM codes - 0008, 00A8 in module DFHFCFS. Message DFHCA4865 is also produced to further explain the failure is due to another user accessing the dataset. Message DFHCA4865 is not documented within the 5.1 or 5.2 manuals. It should read as follows: DFHCA4865 S date time applid tranid Unable to perform operation - DFHCSD currently accessed by another user. While CICS is trying to issue the message, it is discovered module DFHMET1E is unaware of the message. Thus, message DFHME0108 and a dump is produced. DFHME0108 applid Message DFHCA4865 cannot be found in module DFHMET1E. Additional Symptom(s) Search Keyword(s): KIXREVEPH NOTE: Same issue can be realized for message DFHCA4864
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users. * **************************************************************** * PROBLEM DESCRIPTION: DFHCA4865 cannot be found in module * * DFHMET1E. * **************************************************************** * RECOMMENDATION: * **************************************************************** Customer is trying to access CSD file as output(write access) using CICS explorer. Meanwhile, the CSD file is already used by other CICS region as output. So DFHAMMSG is called to output MSGNO(4865). Message builder DFHAMER is invoked to build the error message. As CICS explorer is using EXEC CICS CSD command to access CSD file, component_id is switched from AM to CA so that all messages can go to TDQ CSMT. It's designed that all the relevant AM messages have counterparts in the CA component with the same number. However, for DFHCA4865 it's missing so error message DFHME0108 is issued for DFHCA4865 cannot be found in module DFHMET1E. The same happens for DFHCA4864.
Problem conclusion
DFHMECAE is changed to copy messages DFHCA4864 and DFHCA4865 from DFHMEAME. CICS Transaction Server for z/OS Version 5 Release 1 CICS Messages and Codes Vol 1, GC34-2861-00 and CICS Transaction Server for z/OS Version 5 Release 2 CICS Messages and Codes Vol 1, GC34-7283-00 Chapter 4. DFH messages - DFH01 to DFHM has been changed to add message DFHCA4864 and DFHCA4865: DFHCA4864S date time applid tranid Unable to perform operation - DFHCSD cannot be opened. Explanation CICS cannot use the CSD file for one of the following reasons: 1. The DDNAME or data set name of the CSD file is incorrect coded in the startup JCL. 2. VSAM has diagnosed that the CSD file cannot be opened. 3. CICS file control cannot open DFHCSD because insufficient storage has been allocated by the job REGION= parameter. System Action The command is not executed. User Response The action to solve the problem depends on the cause as follows: 1. Correct the JCL. 2. Check the system operator's console for VSAM messages, and correct all VSAM errors. 3. Increase the size limit of the DSAs or EDSAs. Module: DFHAMP Message inserts: 1. date 2. time 3. applid 4. tranid Destination: TDQ DFHCA4865S date time applid tranid Unable to perform operation - DFHCSD currently accessed by another user. Explanation CICS cannot get read access to the CSD file because another region is accessing it, and the CSD cluster is defined to VSAM with SHAREOPTIONS(1). System Action The command is not executed and CSD file is set in Unenabled status. User Response To avoid a recurrence of this problem, recreate the CSD file specifying SHAREOPTIONS(2). See the CICS System Definition Guide for further details. Module: DFHAMP Message inserts: 1. date 2. time 3. applid 4. tranid Destination: TDQ
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PI45008
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
800
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2015-07-15
Closed date
2015-09-14
Last modified date
2015-10-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI31198 UI31199 PI49658
Modules/Macros
DFHMEAMC DFHMEAME DFHMEAMK DFHMECAC DFHMECAE DFHMECAK
GC34286100 | GC34728300 |
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.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":"5.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 October 2015