Technote (troubleshooting)
Problem(Abstract)
Collecting data for problems with the IBM WebSphere Application Server Scheduler component, a Programming Model Extension (PME) that is available in WebSphere Application Server V5.0 Enterprise Edition, WebSphere Business Integration Server Foundation V5.1, and all editions of WebSphere Application Server. Gathering this information before calling IBM support will help familiarize you with the troubleshooting process and save you time.
Resolving the problem
Collecting data for problems with the IBM WebSphere Application Server Scheduler component, a Programming Model Extension (PME) that is available in WebSphere Application Server V5.0 Enterprise Edition, WebSphere Business Integration Server Foundation V5.1, and all editions of WebSphere Application Server. Gathering this information before calling IBM support will help familiarize you with the troubleshooting process and save you time.
To improve the accuracy of complete data collection, IBM recommends you use the automated data collectors within IBM Support Assistant. Not only will the automated collector gather the equivalent of the manual process, it will also provide a secure file transfer of the collection to IBM.
Collecting data using the IBM Support Assistant Data Collector
- Go to the ISA Data Collector site for WebSphere Application Server.
- Start the ISA Data Collector:
- To run online, select the option to collect from this system using the current browser and click Start Collection.
- To run locally, select the option to collect from this or another system using a downloadable utility. Download and extract the zip file to your WAS_HOME directory. From a command line, run isadc.[sh|bat] or launch index.html to use the web interface.
- To run online, select the option to collect from this system using the current browser and click Start Collection.
- Select the Runtime > Scheduler Problem collector and click Start.
- Follow the prompts to automatically submit the collected data to IBM Support.
- What is the exact version and the edition (for example: Base, Enterprise, WebSphere Business Integration Server Foundation, Network Deployment) of WebSphere Application Server that is installed?
- Provide a full description of the problem that you have encountered, including the stack traces of any errors or exceptions that are occurring. Provide any logs that contain the errors or exceptions.
- Under what circumstances does the problem occur? Does it occur every time a certain task is done or does it occur intermittently? Has this problem always occurred? If not, was a change recently made before the problem started to occur?
- What is the name and JNDI name of the Scheduler that you have configured?
- What is the name and JNDI name of the data source used by the Scheduler, and what database (including version) is used for the Scheduler tables? Also, what JDBC driver (and version) is used?
- Have the Scheduler tables been created? What is the output of the Verify tables button for the Scheduler in the Administrative Console (available in V6.0 and above)?
- Is the problem occurring for EJB tasks or JMS tasks?
- Are the tasks scheduled by an application using the Scheduler API or from an administrative script using JMX (available in V6.0 and above)?
- Send the SystemOut.log file for the application server on which the Scheduler problem occurs:
- For V6.0 and higher the standard output log is located in the following directory:
install_root/profiles/profile_name/logs/server_name - For V5.1, the standard output log is located in the following directory:
install_root/logs/server_name
- For V6.0 and higher the standard output log is located in the following directory:
- Enable tracing:
- For WebSphere Application Server V6.0 and higher:
- In the Administrative Console, expand Troubleshooting and select Logs and Trace.
- In the Logging and Tracing page, select your server and then Diagnostic Trace.
- Under Trace Output, select File, and set the Maximum File Size to 50 and Maximum Number of Historical Files to 5.
- Set the Trace Output Format to Basic (Compatible).
- Click OK and save your configuration.
- Again expand Troubleshooting and select Logs and Trace.
- In the Logging and Tracing page, select your server and then Change Log Detail Levels.
- Enter the following trace string:
*=info:Scheduler=all:ExtHelper=all:LeaseManager=all:AsynchBeans=all:AsynchBeans_Alarms=all:WAS.j2c=all:RRA=all
- Click OK and save your configuration.
- Restart the application server.
- Reproduce the problem.
- Send the resulting trace output file(s).
- In the Administrative Console, expand Troubleshooting and select Logs and Trace.
- For WebSphere Application Server V5.1:
- In the Administrative Console, expand Troubleshooting and select Logs and Trace.
- In the Logging and Tracing page, select your server and then Diagnostic Trace.
- Ensure that Enable trace with the following specification is selected.
- In the Trace Specification field, enter the following:
Scheduler=all=enabled:ExtHelper=all=enabled:LeaseManager=all=enabled:AsynchBeans=all=enabled:AsynchBeans_Alarms=all=enabled:WAS.j2c=all=enabled:RRA=all=enabled
- Under Trace Output, select File, and accept the defaults.
- Click OK and save your configuration.
- Restart the application server.
- Reproduce the problem.
- Send the resulting trace output file.
- In the Administrative Console, expand Troubleshooting and select Logs and Trace.
- For WebSphere Application Server V6.0 and higher:
- Run the collector tool to produce a JAR file containing your WebSphere configuration files and other logs that are useful to the WebSphere Application Server support team:
- Follow instructions to send the following diagnostic information to IBM support:
- SystemOut.log
- The trace output file
- The collector output
| For a listing of all technotes, downloads, and educational materials specific to the Scheduler component, search the WebSphere Application Server support site or the WebSphere Business Integration Server Foundation support site. Related information Submitting information to IBM support Steps to getting support for WebSphere Application Server MustGather: Read first for WebSphere Application Server Troubleshooting guide for WebSphere Application Server |
To diagnose or identify a problem, it is sometimes necessary to provide Technical Support with data and information from your system. In addition, Technical Support might also need to provide you with tools or utilities to be used in problem determination. You can submit files using one of following methods to help speed problem diagnosis:
- IBM Support Assistant (ISA)
- Service Request (SR)
- FTP to the Enhanced Customer Data Repository (ECuRep)
| Segment | Product | Component | Platform | Version | Edition |
|---|---|---|---|---|---|
| Business Integration | WebSphere Business Integration Server Foundation | AIX, HP-UX, Linux, Solaris, Windows | 5.1 | ||
| Application Servers | Runtimes for Java Technology | Java SDK |
Rate this page:
Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.