PI82872: DFHSM0002 A SEVERE ERROR (CODE X'0305') HAS OCCURRED IN MODULE DFHSMGF

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You receive this message in the region,
  .
  DFHSM0002 applid A severe error (code X'0305') has occurred in
  module DFHSMGF
  .
  The x'0305' code corresponds the following exception entry in
  the trace:
  .
  SM 0305 SMGF  *EXC* - Invalid_freemain_address - FREEMAIN
     SUBPOOL_TOKEN(270A05B4 , 00000049) ADDRESS(00000000)
     FREE_LEN (0) REMARK(SOBUFLIS)
  .
  Both the freemain address and freemain length are zeros.
  .
  Going backward in the trace, you could see the error originated
  from an invalid Getmain request during the SECURE_SOC_WRITE
  process, the trace entries like this,
  .
  SO 0801 SOSE  ENTRY - FUNCTION(SECURE_SOC_WRITE)
          BUFFER_LIST(18C4223C , 00000000)
  SM 0301 SMGF  ENTRY - FUNCTION(GETMAIN)
          GET_LENGTH(0) SUSPEND(YES) REMARK(SOBUFLIS)
          *************                     ********
  SM 0302 SMGF  EXIT  - FUNCTION(GETMAIN) RESPONSE(EXCEPTION)
          REASON(INVALID_GET_LENGTH) ADDRESS(00000000)
                 ******************
  SO 080C SOSE  *EXC* - SYSTEM_SSL_ERROR
     GSK_RESPONSE(GSK_INVALID_BUFFER_SIZE)
                  ***********************
     FUNCTION(SECURE_SOC_WRITE)
     RESPONSE(EXCEPTION) REASON GSK_RETURN_CODE(1F5)
  .
  SM 0301 SMGF  ENTRY - FUNCTION(FREEMAIN)
     ADDRESS(00000000) FREE_LENGTH(0) REMARK(SOBUFLIS)
  SM 0305 SMGF  *EXC* - Invalid_freemain_address - FREEMAIN
     ADDRESS(00000000) FREE_LEN (0) REMARK(SOBUFLIS)
  .
  The relevant kernel stacks of the failing task is as below,
  .
   KE_NUM @STACK   TYPE NAME
  ...
  00B9   18C3EEE0 Dom  DFHAPLI1
                  Int  CICS_INTERFACE
  00B9   18C3FF30 Dom  DFHWBSR
                  Int  SEND_STATIC_RESPONSE
                  Int  RESPOND_WITH_HFSFILE
  00B9   18C41590 Dom  DFHWBAP
                  Int  SEND_RESPONSE_TO_CLIENT
                  Int  SEND_NEXT_CHUNK
                  Int  WBCM_SERVER_SEND_DATA
  00B9   1E544040 Dom  DFHSOCK
                  Int  SEND_SOCK
  00B9   1E545340 Sub  DFHSOSE
                  Int  SECURE_SOC_WRITE
  00B9   1E546040 Dom  DFHSMGF
                  Int  FREEMAIN
                  Int  FREEMAIN_STANDARD
                  Int  SEVERE_ERROR
  .
  The zero length Getmain was issued during the process of large
  (greater than 256K) file for HTTP HEAD request.
  Additional Symptom(s) Search Keyword(s): SM0002 DFHSM0002 code
  0305 INVALID_GET_LENGTH GSK_INVALID_BUFFER_SIZE
  Invalid_freemain_address SOBUFLIS SEND_NEXT_CHUNK KIXREVxxx
  

Local fix

• No
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHSM0002 a severe error (code x'0305') *
  *                      in module DFHSMGF when an HTTP HEAD     *
  *                      request is received to retrieve a large *
  *                      binary file and CICS is configured to   *
  *                      use SSL.                                *
  ****************************************************************
  CICS is configured to use SSL and there is a URIMAP defined to
  return a large binary file.  An HTTP HEAD request is received
  to retrieve the large file. DFHWBSR is called to send the data
  in chunks.  A buffer list containing the HTTP response is built
  up to be passed to sockets domain.  The first chunk is sent out
  successfully and DFHWBSR is called again to send the second
  chunk.  The buffer list which contains 0 entries is passed to
  sockets domain.  A GETMAIN is then issued with a length of 0
  which returns EXCEPTION/INVALID_GET_LENGTH.
  What happens next depends upon whether PI78180 is applied.
  
  1) If PI78180 is not applied the GETMAIN failure is ignored
  and later an invalid FREEMAIN with length 0 is issued which
  results in message "DFHSM0002 applid A severe error (code
  X'0305') has occurred in module" and an SVC dump.
  
  2) If PI78180 is applied the GETMAIN failure is recognised
  and an IO_ERROR exception response is returned to the caller.
  In this case the application should get an IOERR response or an
  AEIQ abend.
  

Problem conclusion

• DFHWBSR has been changed to correctly return only the HTTP
  headers when it receives an HTTP HEAD request for a large binary
  file.
  

Temporary fix

Comments

• ×**** PE18/07/04 FIX IN ERROR. SEE APAR PH00119  FOR DESCRIPTION
  

APAR Information

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

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

  UI49481 UI49513

Modules/Macros

• DFHWBSR
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R000 PSY UI49481

     UP17/08/15 P F708

• R100 PSY UI49513

     UP17/08/15 P F708

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.