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

Obtain the fix for this APAR.

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 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.