Network Deployment (Distributed operating systems), v8.0 > Troubleshoot and support > Troubleshoot Service integration
Troubleshoot service integration technologies
Use this overview task to help resolve a problem that you think is related to service integration technologies.
For general information about fixing problems, see Diagnosing problems (using diagnosis tools). To help you identify and resolve problems, use the WAS tracing and logging facilities. For more information about using tracing and logging, see Add logging and tracing to the application.
If you encounter a problem that you think might be related to service integration technologies, complete the following stages.
Procedure
- Check the "Tips for troubleshooting" related links for specific problems related to service integration technologies.
- Use Troubleshoot service integration message problems to investigate problems with messages, such as messages not arriving or being consumed. If the tips and the investigations do not help you fix the problem, complete the following general stages.
- Check the Release Notes for known problems and their resolution. The Release Notes are available from the WAS library website.
- For current information from IBM Support on known problems and their resolution, see the WAS support page.
- Search the WebSphere Technotes database.
We can use the following queries to find articles for service integration technologies:
- All technotes: http://www.ibm.com/support/search.wss?rs=180tc=SSEQTP&tc1=SSCBRCS
- MustGather technotes, used to debug problems: http://www.ibm.com/support/search.wss?rs=180tc=SSEQTP&tc1=SSCBRCS&q=MustGather
- Check for error messages.
Check in the application server SystemOut log at PROFILE_ROOT\logs\server_name
SystemOut.log for error messages, where PROFILE_ROOT is the directory in which profile-specific information is stored.
With WAS v8 you can configure the server to use the HPEL log and trace infrastructure instead of using SystemOut.log , SystemErr.log, trace.log, and activity.log files or native z/OS logging facilities. If you are using HPEL, you can access all of your log and trace information using $PROFILE/bin/LogViewer.sh.
The following message prefixes relate to specific aspects of service integration technologies:
Prefixes and service integration technologies. The first column of the table lists the message prefixes. The second column contains the specific aspects of service integration technologies related to the message prefixes.
Message prefix Aspect of service integration technologies CWSIA API CWSIB Message formatting and parsing core CWSIC Communications CWSID Administration and system management CWSIE Message formatting and parsing SPI CWSIF Message formatting and parsing CWSIG Example CWSIH Match space CWSII Security CWSIJ Communications formats and protocol CWSIK Common messages CWSIL Publish and subscribe bridge CWSIM Mediations CWSIN Mediation services CWSIO Administration migration CWSIP Message processor CWSIQ MQ formats and protocol CWSIR Core programming interface CWSIS Message store CWSIT Topology routing and management CWSIU Utilities CWSIV Resource adapter CWSIX Core beans CWSIY Mediation handler framework CWSIZ Mediation framework CWSJA Administration commands CWSJB Inter-bus link CWSJC Core selector CWSJD Administration security CWSJO Service Data Objects configuration CWSJQ Message formatting and parsing MQ interoperability CWSJR Resource adapter (JMS) CWSJU Message tracing CWSJW WLM classifier for z/OS The Troubleshooter reference: Messages contains information about the messages, indexed by message prefix. For each message there is an explanation of the problem, and details of any action that you can take to resolve the problem.
- Check for more information and error messages that might provide a clue to a related problem. For example, if you see WebSphere MQ error messages or reason codes in WAS messages and logs, refer to the WebSphere MQ Messages document at http://publibfi.boulder.ibm.com/epubs/pdf/amqzao05.pdf.
- If the information obtained in the preceding stages is still inconclusive you should explore further, for example by enabling the application server debug trace to provide a detailed exception dump.
Resolve indoubt transactions
Restore a data store and recovering its messaging engine
Diagnosing problems with data store exclusive access locks
Use HPEL to troubleshoot applications