PI20200: DFHWB0002 A SEVERE ERROR (CODE X'032C') HAS OCCURRED IN MODULE DFHWBAPF.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You upgraded to CICS Transaction Server 5.2 and started
  receiving DFHWB0002 A SEVERE ERROR (CODE X'032C') HAS OCCURRED
  IN MODULE DFHWBAPF. Review of the trace shows that the cause of
  the severe error is:
  SM 0301 SMGF  ENTRY - FUNCTION(GETMAIN) GET_LENGTH(0)
                SUSPEND(NO)  REMARK(USER_BUF) STORAGE_CLASS(TASK)
  SM 0302 SMGF  EXIT  - FUNCTION(GETMAIN) RESPONSE(EXCEPTION)
                REASON(INVALID_GET_LENGTH) ADDRESS(00000000)
  WB 032C WBAPF *EXC* - GETMAIN_ERROR FUNCTION(READ)
                HTTP_BUFFER_NAME(22AF2B75 , 00000000 , 00000006)
                CONVERT(DEFAULT) DATA_TYPE(FORMFIELD)
  The reason this error started happening after going to CICS TS
  V5 is because V5.x now checks if a getmain is done with length
  zero and if so returns invalid_get_length.
  The reason DFHWBAPF is calling DFHSMGF with a zero length is
  because the request that came contained a field without a
  value. For example, the request looked like this:
  *IBMRES=Tran&IBMRROW=Transaction%28*
  *name%29+&IBMRNAME=c*&IBMFREE=&IBMV*
  *ALUE=TRANSID                      *
  As you can see, the field IBMFREE does not contain a value
  which causes a length of zero to be passed to DFHSMGF.
  Additional Symptom(s) Search Keyword(s): KIXREVSCB
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Message DFHWB0002 is issued when CICS   *
  *                      handles WEB READ FORMFIELD with the     *
  *                      SET option for a field whose            *
  *                      VALUELENGTH is 0.                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
   A web application issues WEB READ FORMFIELD with the SET option
   for a field whose VALUELENGTH is 0.
   CICS calls DFHWBAPF to process the request. As the SET option
   is specified, GETMAIN is issued to copy the value to a buffer
   and return it to the user. The GETMAIN length specified is the
   VALUELENGTH of the field, it is 0. This leads to GETMAIN
   failure with an EXCEPTION with reason INVALID_GET_LENGTH.
   Then DFHWBAPF returns a EXCEPTION with reason GETMAIN_ERROR and
   message DFHWB0002 is sent.
  

Problem conclusion

• DFHWBRQF has been changed not to issue GETMAIN when the field
  VALUELENGTH is 0.
  

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:

  UI21066

Modules/Macros

• DFHWBAPF DFHWBAP
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R900 PSY UI21066

     UP14/09/12 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.