Planning for problem diagnosis

This section describes:

Overview of problem diagnosis

WebSphere Application Server for z/OS uses component trace (CTRACE) to capture and display trace data in trace data sets. WebSphere Application Server for z/OS identifies itself to CTRACE with a dynamic component name determined by the short cell name. CTRACE allows you to:

WebSphere Application Server for z/OS also has an error log stream that records error information when WebSphere Application Server for z/OS detects an unexpected condition or failure within its own code, such as:

Use the error log stream in conjunction with other facilities available to capture error or status information, such as an activity log, trace data, system logrec, and job log.

The WebSphere Application Server for z/OS error log stream is a system logger application. Because the error log stream uses the system logger, you can:

WebSphere Application Server for z/OS provides a REXX EXEC (BBORBLOG) that allows you to browse the error log stream. By default, the EXEC formats the error records to fit a 3270 display.

This topic describes the error log stream and how to set it up. Information about using the error log stream to diagnose problems is in the Troubleshooting section of the WebSphere Application Server information center. General information and guidance about the system logger is in z/OS MVS Setting Up a Sysplex.

Finding WebSphere Application Server for z/OS Error Log Stream Information
What is your goal? You should read:
Learn about the system logger and understand its requirements z/OS MVS Setting Up a Sysplex
Learn about the WebSphere Application Server for z/OS error log stream This topic
Size the coupling facility structure space needed for the WebSphere Application Server for z/OS error log stream z/OS MVS Setting Up a Sysplex
Define the WebSphere Application Server for z/OS error log stream
View the WebSphere Application Server for z/OS error log stream The Troubleshooting section of the WebSphere Application Server information center
Learn about how Java applications can log messages and trace data in the error log stream The Applications section of the WebSphere Application Server information center


For details about problem diagnosis, see the Troubleshooting section of the WebSphere Application Server information center.

Planning for Component Trace

To use CTRACE, you:

Recommendation for dumps

Plan as you would normally for system dumps. Due to the size of WebSphere Application Server for z/OS address spaces, you may need to re-size your system dump data sets and use dynamic dump data sets.


Related tasks
Updating the CFRM policy



Searchable topic ID:   cinsdiagbk
Last updated: Jun 21, 2007 9:56:50 PM CDT    WebSphere Application Server for z/OS, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.zseries.doc/info/zseries/ae/cins_diagbk.html

Library | Support | Terms of Use | Feedback