IBM Support

PI59018: DFHSM0002 (CODE X'0C15') IN MODULE DFHSMMG

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • You are running with CICS TS 5.1 on z/OS 2.1 and receiving the
    following message,
     DFHSM0002 A severe error (code X'0C15') has occurred
     in module DFHSMMG.
    .
    The trace shows the following exception trace entry -
    SM 0C15 SMMG  *EXC* -
                Invalid_length_on_getmain_for_SHARED_CICS31_storage
                - FUNCTION(GETMAIN) REMARK(MISCDATA)
                GET_LENGTH(FFFFECA5)
                SUSPEND(YES) STORAGE_CLASS(SHARED_CICS)
    .
    The GETMAIN length FFFFECA5 is invalid. This GETMAIN was issued
    by DFHWBPW UI30325 at offset 3F4. DECODE_USER_DATA_LENGTH is
    defined FL2 or half word only. However, the original request is
    1ECA5 bytes in length. The old commarea mechanism for processing
    the HTTP request requests up to 32k which is why
    decode_user_data_length is a halfword. DFHWBPW can be modified
    to use the WEB API to get hold of the user data. This would
    avoid the problem with the invalid getmain length value.
    .
    Additional Symptoms Search Keywords: KIXREVEPH
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Abend AEXZ in program DFHWBPW due to    *
    *                      DFHSM0002 (code X'0C15') in DFHSMMG.    *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    CICS receives an HTTP POST request with over x'7FFF' bytes of
    data.  The TCPIPSERVICE has been configured to use basic
    authentication and the user's password has expired.
    CICS drives DFHWBPW to allow the user to change their password.
    DFHWBPW issues a LH instruction to get the length of the data
    to be stored whilst the user changes their password.  However,
    this instruction is operating on only a halfword value, so the
    length may have been truncated, and if the top bit of the
    halfword length is on, this is extended such that the most
    significant half of the fullword is populated with 'F's.
    A GETMAIN request is issued for this length with comment
    MISCDATA.  The GETMAIN fails with a DFHSM0002 message due to
    the invalid length, DFHWBPW abends AEXZ and a system dump is
    taken.
    Additional keywords: msgDFHSM0002 SM0002 abendAEXZ
    

Problem conclusion

  • DFHWBPW has been modified to use a WEB RECEIVE command to
    retrieve the HTTP POST request's data and length.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PI59018

  • 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 / Xsystem

  • Submitted date

    2016-03-11

  • Closed date

    2016-05-19

  • Last modified date

    2016-06-02

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    PI61956 UI38035 UI38036

Modules/Macros

  • DFHWBPW
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R800 PSY UI38035

       UP16/05/27 P F605

  • R900 PSY UI38036

       UP16/05/27 P F605

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 June 2016