PK89021: ABENDB37 FOR FULL DWWMSG DATASET FOR CICSVR SERVER

Obtain the fix for this APAR.

APAR status

• Closed as unreproducible in next release.

Error description

• DWWMGS dataset is used by CICSVR server for recording its status
  during initialization and for some events as it processes.
  .
  In the Implementation Guide,
  Section "Creating the DWWMSG, DWWDMSG, and DWWDUMP data sets",
  the sample shows DWWMSG allocation with SPACE=(CYL,(1,1))
  but does not provide any guidance on how to tune this number.
  .
    If left at a single cylinder, the CICSVR Server may stay up
  long enough to fill it up.  When that happens, ABENDS0B37
  happens when CICSVR tries to write a message but there is no
  room.
  .
    CICS VR documentation should be changed to indicate that the
          SPACE=(CYL,(1,1))
  is only an example and should only be used for proof of concept
  or testing.  A realistic value should be provided for production
  systems.  And, an indication of how to tune the parameter could
  be given.
  .
    Also, CICS VR code should be changed so that,
  no matter how large the message log dataset is,
  the CICS VR Server should not exceed that limit.
  Some change should be made so that the CICS VR server
  does not abend because its message log fills up.
  .
    Note:  DWWDUMP and DWWDMSG datasets,
     used when technical support requests trace data,
     may have the same exposure.
  Additional keywords
  B37 SB37 S0B37
  IEF196I IEC030I B37-04,IFG0554A,IEESYSAS,CICSVR,DWWMSG,dev,ser,
   IEF196I &hlq..CICSVR.DWWMSG
   IEC030I B37-04,IFG0554A,IEESYSAS,CICSVR,DWWMSG,dev,ser,
  &hlq..CICSVR.DWWMSG
  

Local fix

• Two steps can be taken to avoid the ABENDSB37.
  1. Terminate CICSVR server,
      Reallocate the DWWMSG data set, e.g. SPACE=(CYL,(10,10))
      Provide free space for secondary allocation
      Activate CICSVR server
  2. When the DWWMSG data set is 80% full,
    use this command to empty DWWMSG data set:
      SETSMS CICSVR_ZZVALUE_PARM(RESETMSG)
    All of the messages from DWWMSG were previously written to
  the SYSLOG. If the messages are needed at a future time, look
  for them there.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: This APAR affects CICS VR 4.2 and 4.3 users  *
  *                 that use CICS VR server address space.       *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS VR server address space terminates *
  *                      with Abend B37 if the DWWMSG, DWWDUMP   *
  *                      or DWWDMSG data sets are becoming full. *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  At CICS VR server address space activation, CICS VR will
  allocate 2 message data sets, one of them, with more free space
  will open as a current message data set. When CICS VR server
  detects that the current message data set is becoming full, it
  performs switching to other message data set and uses it until
  that becomes full. Then CICS VR server will switch back to
  using the first dataset and start overwriting its contents.
  
  For diagnostic messages and dump the server still allocates
  single data sets DWWDMSG and DWWDUMP. The server will detect
  when the diagnostic message dataset or dump dataset is becoming
  full and will re-write them.
  

Problem conclusion

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:

  UK55555 UK55556

Modules/Macros

•    DWWBCAP  DWWBDW   DWWB0BI  DWWB0BW  DWWITENV
  DWWMHI   DWWQSOOP DWWQSOPU DWWUTCAP DWWUTENV HCCV420J HCCV430J
  ZXBCBI   ZXENV
  

Fix information

• Fixed component name

  CICS VSAM RECOV

• Fixed component ID

  5655P3000

Applicable component levels

• R420 PSY UK55555

     UP10/04/02 P F004

• R430 PSY UK55556

     UP10/04/02 P F004

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.