PH22433: WEB RECEIVE SET BUFFER INCORRECTLY FREED DURING WEB CLOSE PROCESSING

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• An application issues an EXEC CICS WEB RECEIVE SET or EXEC CICS
  WEB CONVERSE SET command.  The SET buffer that is returned
  should be valid until the next receive command using the same
  web session or until the end of task.
  
  When the application issues an EXEC CICS WEB CLOSE command the
  earlier SET buffer is being incorrectly freemained.  Referring
  to data in the SET buffer after the WEB CLOSE command would lead
  to unpredictable results.
  
  
  For example, an abends0c7 could occur if the application later
  refers to the freed storage, and it has been used to satisfy
  another getmain, the data will not be what the application
  expects, causing abends such as s0c7, s0c4, etc.  This can be
  found in the trace by looking for any prior getmain for the
  impacted storage and checking for a web_close. For example, if
  the storage location causing the error starts at 255B6178, you
  can see the getmain, web_receive, web-close, freemain in the
  trace;
  
  04033 SO    SM 0301 SMGF  ENTRY GETMAIN
  295E,YES,WBSETBUF,TASK
  04033 SO    SM 0302 SMGF  EXIT  GETMAIN/OK
  00000000_255B6178
  04033 L800D AP F911 EIWB  EXIT  WEB_RECEIVE           RESP=0
  RESP2=0
  04033 L800D AP 00E1 EIP   EXIT  WEB-RECEIVE           OK
  00F4,00000000 ....,00003802 ....,0200
  04033 L800D AP 00E1 EIP   ENTRY WEB-CLOSE
  0004,25522360 ...-,0900381A ....,0200
   Called-from-address 2FFE9E18 : Module xxxxxxxx program yyyyyyyy
  + X'4B58'
  04033 L800D AP F910 EIWB  ENTRY WEB_CLOSE
  04033 SO    SM 0301 SMGF  ENTRY FREEMAIN              1E5AD020 ,
  00000112,27CD7030,TASKASOC
  04033 SO    SM 0302 SMGF  EXIT  FREEMAIN/OK
  04033 L800D SM 0301 SMGF  ENTRY FREEMAIN
  295E,WBSETBUF,TASK,00000000_255B6178
  
  Then the same storage is obtained after this;
  
  04033 L800D SM 0C01 SMMG  ENTRY GETMAIN
  8968,YES,USER,EXEC
  04033 L800D SM 0C02 SMMG  EXIT  GETMAIN/OK            255B6178
  
  And then a program check is encountered when the application
  tries to refer to the web data but it is not as expected;
  
  04033 L800D AP 1942 APLI  *EXC* Program-Check
  START_PROGRAM.........
  
  Sample error;
  
  DFHSR0001 nnnnnn An abend (code 0C7/AKEA) has occurred at offset
   X'FFFFFFFF' in program ppppppp.
  
  Additional symptoms:
  KIXREVxxx
  abends0c4
  SR0001
  abends0c7
  s0c4
  s0c7
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: EXEC CICS WEB CONVERSE SET buffer is    *
  *                      incorrectly freed during WEB CLOSE      *
  *                      processing.                             *
  ****************************************************************
  An outbound web application issues EXEC CICS WEB OPEN, WEB
  CONVERSE SET and WEB CLOSE.  The SET buffer that was allocated
  for the WEB CONVERSE command is incorrectly freemained during
  WEB CLOSE processing.  This means an application cannot reliably
  use the data in the SET buffer after the WEB CLOSE command.  In
  this scenario the SET buffer should remain valid until the end
  of the task.
  
  The same problem occurs if EXEC CICS WEB RECEIVE SET is used
  instead of EXEC CICS WEB CONVERSE.
  

Problem conclusion

• DFHWBCL has been changed to no longer free the SET buffer during
  WEB CLOSE processing.
  

Temporary fix

Comments

APAR Information

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

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

  UI69475

Modules/Macros

• DFHWBCL
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R200 PSY UI69475

     UP20/05/15 P F005

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.