A fix is available
APAR status
Closed as program error.
Error description
DFHRM0302 ERROR WRITING THE DFHGCD DATA SET RETURNCODE: X'00000008', REASON: X'0000005C' when running DFHRMUTL against GCD This error is saying a PUT, ERASE, or IDALKCD was issued without a previous GET for UPDATE. Or a PUTIX was issued without a previous GETIX. The problem is that there is no RMDM_RESTART record on the GCD, which is quite possible if the previous run of CICS did not shut down cleanly. So, when we run DFHRMUTL with the SET_AUTO_START=AUTOINIT SYSIN option, we call rmdmu_save and reach the code: if start_req = 'AUTOINIT' then ! Only for INITIAL . This causes us to try and read the restart record. I can confirm from SLD that this is failing with rc8,rsn10, meaning notfound. The code in gcd_read avoids an error message in such an expected case, which is why you've been struggling to see what the error was! We get back to the code which tests if data_length = 0, meaning no record was found, and if so we create one via a call to gcd_write. However, this passes "update" on the method signature, meaning a rewrite operation to vsam. Since there is no record to be (re)written we get the 5C error being seen. If I replace the "update" option with "seq" then the gcd_write works correctly and DFHRMUTL completes with rc0. So that is the bug. Additional Symptom(s) Search Keyword(s): KIXREVCTC
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All * **************************************************************** * PROBLEM DESCRIPTION: DFHRM0302 Error writing the DFHGCD data * * set. Return code: x'00000008', reason: * * x'0000005C' message issued by DFHRMUTL. * **************************************************************** * RECOMMENDATION: * **************************************************************** DFHRMUTL is called to SET_AUTO_START to AUTOINIT. It will try to create an rmdm_restart record if one does not already exist. When writing the record to VSAM, it will specify "upd" on the request if an rmdm_options record is present. This results in VSAM returning the 5C reason code on the put, since no previous get for update had been issued. KEYWORDS: RMUTL msgdfhrm0302 rm0302 rm 0302 302
Problem conclusion
DFHRMUTL has been corrected to specify "seq" (sequential) on a request to write an rmdm_restart record where none already exists as part of SET_AUTO_START to AUTOINIT processing.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PI20513
Reported component name
CICS TS Z/OS V4
Reported component ID
5655S9700
Reported release
700
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2014-06-20
Closed date
2014-09-11
Last modified date
2014-10-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PI23809 UI21276
Modules/Macros
DFHRMUTL
Fix information
Fixed component name
CICS TS Z/OS V4
Fixed component ID
5655S9700
Applicable component levels
R700 PSY UI21276
UP14/09/20 P F409
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.2","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.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 October 2014