IBM Support

PI20513: DFHRM0302 ERROR WRITING THE DFHGCD DATA SET RETURNCODE: X'00000008', REASON: X'0000005C' WHEN RUNNING DFHRMUTL A

A fix is available

Subscribe

You can track all active APARs for this component.

 

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