IBM Support

PI10802: RECEIVING DFHWB0002 SEVERE ERROR CODE X'0325' IN MODULE DFHWBAP

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Receiving a Web Request with an unsupported OPTIONS parameter
    causes a Getmain for READHEAD storage for a ZERO length, which
    causes this error.  Here are Trace Entries leading up to the
    error.
    .
    0301 SMGF  ENTRY - FUNCTION(GETMAIN)
                       SUBPOOL_TOKEN(35BDA9B0 , 000000FF)
                       GET_LENGTH(0) SUSPEND(NO) INITIAL_IMAGE(00)
                       REMARK(READHEAD)
    .
    0302 SMGF  EXIT  - FUNCTION(GETMAIN) RESPONSE(EXCEPTION)
                       REASON(INVALID_GET_LENGTH) ADDRESS(00000000)
    .
    0325 WBAP *EXC* - GETMAIN_ERROR FUNCTION(INQUIRE)
                      HTTP_METHOD(3E5A21F2 , 00000000 , 00000004)
                      HTTP_VERSION(3E5A21FC , 00000000 , 00000064)
                      URI(3E5A2264 , 00000000 , 00000100)
    .
    You may also see the following errors:
    .
    |.................E..HTTP/1.0 400|
    | Bad Request..CONTENT-LENGTH: 00|
    |168..CONTENT-TYPE: text/html....|
    |<!doctype html public "-//IETF//|
    |DTD HTML 2.0//EN">..<html>..<hea|
    |d>..<title>CICS Web Interface er|
    |ror</title>..</head>..<body>..<H|
    |1>400 Bad Request</H1>..</body>.|
    |.</html>........................|
    .
    and
    .
    *C0012345DFHWB0762 01/22/2014 11:*
    *28:21 REGNNAME TASK The received*
    * HTTP request specifies the OPTI*
    *ONS method but cannot be handled*
    * by CICS. Status code: 400. Host*
    * IP address: xx.xx.x.xx. Client *
    *IP address: xx.xx.x.xxx. TCPIPS*
    *ERVICE: TASK....................*
    Additional Symptom(s) Search Keyword(s): KIXREVEPH
    

Local fix

  • n/a
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS Users                               *
    ****************************************************************
    * PROBLEM DESCRIPTION: DFHWB0002 Severe error x'0325' within   *
    *                      DFHWBAP when using custom DFHWBEP URM.  *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    DFHWBEP URM is called by the WEB domain when an error occurs
    to ensure a response is returned to the client web application.
    Dependent on when the error occurs it's possible that the HTTP
    headers have not been received by CICS.
    
    In this case a customised DFHWBEP was being used which issued
    EXEC CICS WEB EXTRACT. DFHWBAP attempted to getmain an area of
    storage for the headers but this resulted in a getmain for a
    length of 0, causing storage manager to return an EXCEPTION
    response. DFHWBAP failed to handle the EXCEPTION response
    resulting in the reported msgDFHWB0002 for code x'0325' and a
    system dump.
    

Problem conclusion

  • DFHWBAP has been altered to check the length of the headers
    and to return an error if the length is 0.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PI10802

  • 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

    2014-01-31

  • Closed date

    2014-04-25

  • Last modified date

    2015-03-05

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

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

    UI17382

Modules/Macros

  • DFHWBAPF DFHWBAP
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R800 PSY UI17382

       UP14/05/03 P F405

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:
05 March 2015