IBM Support

Collect troubleshooting data for Data Object and XML Serialization problems with WebSphere Process Server

Technote (troubleshooting)


You are having a business object resolution problem with WebSphere Process Server. You would like to know what documentation you must collect (MustGather) so that the WebSphere Process Server Support team can diagnose your problem. If you gather this documentation before contacting support it will expedite the troubleshooting process, and save you time.

Resolving the problem

Collect troubleshooting data for problems with WebSphere Process Server. Gathering this information before calling IBM support will help familiarize you with the troubleshooting process and save you time.

Setting the trace setting

Set the following trace string, then reproduce the problem. For instructions, see the main WebSphere Process Server MustGather document.

BOCore=all: BOFactory=all:
BOXMLSerializer=all: BOXMLDocument=all: BOTypeMetaData=all:

Note: Enabling the trace might slow down your system. This delay can lead to transaction time-outs and errors.

Required diagnostic information

Gather the following information and files:

General diagnostic information
  • Problem description
  • Environment description
  • Server logs: All files from
  • Project interchange (PI) or enterprise archive (EAR) file from the relevant applications

Automated Collection of Troubleshooting Data

Automated data collectors are available in IBM Support Assistant to improve the accuracy of complete data collection. You can use ISA Lite to automate the gathering of the required log files.

Note: When you use ISA Lite, also gather a detailed problem description, environment description, and other requested materials, such as a PI file.

IBM Support Assistant Lite
IBM Support Assistant Workbench
A special offering that contains just the data collector component of the IBM Support Assistant Workbench For a full range of problem solving features, the workbench contains all of the data-collection capability of ISA Lite and much more!

Instructions for collecting the diagnostic information

For instructions on collecting the general diagnostic information, see the "Manually collect troubleshooting information" section in Collect troubleshooting data for WebSphere Process Server Version 6. The server logs and some of the environment details can be collected with ISA Lite.
Note: If you are having problems with any of the data object APIs be sure to include the specifics in the problem description.

What to do next

  1. Review the logs and traces at the time of the problem to try to determine the source of the problem.

  2. Use IBM Support Assistant to search for known problems in the information center, forums, and technotes.

  3. If you cannot find related problems or cannot solve the problem, send the information you collected to IBM by following the instructions in Exchanging Information with IBM Technical Support.

For a listing of all technotes, downloads, and educational materials specific to WebSphere Process Server , search the WebSphere Process Server support page.

Document information

More support for: WebSphere Process Server
Business Object Framework

Software version: 6.1, 6.1.2, 6.2

Operating system(s): AIX, HP-UX, Linux, Solaris, Windows, z/OS

Reference #: 1245236

Modified date: 26 October 2009