IBM Support

PM44846: 3270 BRIDGE FAILS WITH DFHAP0002 CODE X'2150'

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • A 3270 Bridge transaction works well as long as only function
    keys are used. If the ENTER key is depressed, the 3270 Bridge
    transction fails with message DFHAP0002 reporting code x'2150'
    in module DFHBRFM.
       Pressing ENTER has caused the request to be sent in as if the
    PF1 button had been pressed as that is what was in focus at the
    time. This has caused the HELP transaction to be started.
       To process the start DFHBRFM creates a BSB and then stores
    the start data on a TSQ. This is done by calling DFHBREI.
    The commarea passed to DFHBREI is not fully initialised.
    Specifically the output fields are not cleared.  DFHBREI also
    does not expicitly set the response for every call. It only sets
    the response on a failure.  In this case, the operation was
    successful but the response field must have contained a residual
    non-zero value and DFHBRFM assumed the call had failed.
    .
    ADDITIONAL KEYWORD(s): DFHWB1020 DFHWB0137
                           MSGDFHWB1020 MSGDFHWB0137
    KIXREVDAM
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Using the 3270 Bridge to START a        *
    *                      transaction fails with abend            *
    *                      AP0002 code X'2150'.                    *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    An application using the 3270 Web Bridge issues an:
    
    EXEC CICS START TRANSID() FROM() TERMID()
    
    DFHEIIC calls DFHBRFM to process the START command. DFHBRFM
    issues a LINK to DFHBREI, but does not initialise the COMMAREA
    correctly. DFHBREI attempts to update a non-existent TS queue
    entry, which fails with QIDERR. It then issues the correct
    WRITEQ TS to create a new queue.
    
    DFHBREI has not correctly initialised the COMMAREA response
    and reason codes on entry, and as successful completion is not
    set, DFHBRFM believes that there has been an error, and issues
    the AP0002 abend.
    
    Additional keywords: DFHAP0002 ABENDAP0002 ABENDDFHAP0002
    

Problem conclusion

  • DFHBRFM and DFHBREI have been updated to correctly process the
    START command.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM44846

  • Reported component name

    CICSTS FOR VSE

  • Reported component ID

    564805400

  • Reported release

    B0P

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2011-08-01

  • Closed date

    2011-10-28

  • Last modified date

    2012-05-15

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

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

    UK73338

Modules/Macros

  •    DESBREI  DESBRFM  DFHBREI  DFHBRFM
    

Fix information

  • Fixed component name

    CICSTS FOR VSE

  • Fixed component ID

    564805400

Applicable component levels

  • RB0P PSY UK73338

       UP11/11/07 P E511

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":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.1.1","Edition":""}]

Document Information

Modified date:
15 May 2012