A fix is available
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:
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