IBM Support

PM37637: SYSTEM.OUT.CHECKERROR() ALWAYS RETURNS FALSE

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • System.out.checkError() always returns false.  The checkError()
    call will return true when the underlying stream cannot be
    used due to error. Thus, any check of the PrintStream will
    indicate that the stream is fine and ready for use, even if the
    stream cannot be used due to error.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of IBM WebSphere Application       *
    *                 Server V7.0                                  *
    *                                                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Can not detect when System.out.println  *
    *                      requests are not being written to       *
    *                      the HFS file pointed to by SYSPRINT.    *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    System.out.checkError() does not return true after a
    System.out.println fails because the HFS is full
    

Problem conclusion

  • Changed the code so checkError() will return true when the
    underlying stream encountered an error.
    
    A new property server_wto_on_write_error can be set to cause
    the BBOO0384I message to be written when there was an error
    writing to SYSPRINT or SYSOUT.
    
    APAR PM37637 requires changes to documentation.
    
    NOTE: Periodically, we refresh the documentation on our
    Web site, so the changes might have been made before you
    read this text. To access the latest on-line
    documentation, go to the product library page at
    
    http://www.ibm.com/software/webservers/appserv/library
    
    The following changes to the z/OS version of the WebSphere
    Application Server Version 7.0 Information Center will be
    made available in July, 2011.
    
    The following information will be added to the
    topic "Application server custom properties that are
    unique for the z/OS platform":
    
    server_wto_on_write_error
    
    Indicates whether the error message BBOO0384I ERROR
    OCCURRED WRITING TO {0} is written to the SYSLOG when an
    error occurs while writing to SYSPRINT or SYSOUT.
    
    This property can be set to 0 or 1. When this property is
    set to 1, this error message is written to the SYSLOG.
    When this property is set to 0 no message is issue
    
    Data Type  Integer
    Default  0
    Used by Daemon  No
    
    The following information will be added to the table in the
    topic "Changing the values of variables referenced in
    BBOM0001I messages:"
    
    server_wto_on_write_error
    
    In the administrative console, click Servers > Application
    Servers > server > Server infrastructure > Administration >
    Custom Properties > New, select the appropriate node or cell
    from the list of available nodes and cells, and then click
    New. Add the server_wto_on_write_error property, and specify
    a different value.
    
    Indicates whether the error message BBOO0384I ERROR OCCURRED
    WRITING TO {0} is written to the SYSLOG when an error occurs
    while writing to SYSPRINT or SYSOUT. See Application server
    z/OS custom properties for additional information.
    
    The BBOO messages topic under Messages in the Reference section
    of the Information Center will be updated to include the
    following new message:
    
    BBOO0384I ERROR OCCURRED WRITING TO {0}.
    
    Explanation: An error occurred when writing to SYSOUT or
    SYSPRINT.
    
    Programmer response: If SYSOUT or SYSPRINT is being directed to
    the HFS, free up some space.
    
    APAR PM37637 is currently targeted for inclusion in Service
    Level (Fix Pack) 7.0.0.17 of WebSphere Application Server V7.0.
    
    Please refer to URL:
    //www.ibm.com/support/docview.wss?rs=404&uid=swg27006970
    for Fix Pack availability.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PM37637

  • Reported component name

    WEBSPHERE FOR Z

  • Reported component ID

    5655I3500

  • Reported release

    700

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2011-04-21

  • Closed date

    2011-05-02

  • Last modified date

    2011-06-02

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

    PM25806

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

Modules/Macros

  • BBGUBINF BBOUBINF
    

Fix information

  • Fixed component name

    WEBSPHERE FOR Z

  • Fixed component ID

    5655I3500

Applicable component levels

  • R700 PSY UK67335

       UP11/05/19 P F105

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.

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS7K4U","label":"WebSphere Application Server for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
10 February 2022