WMB/IIB MustGather: Problems with Adapters on UNIX and Linux

1. Consider Using the Test Client in trace and debug mode.


2. A user level trace is intended to assist users with understanding how their ESQL is processed.
   It will also show a high level view of the message flow behavior.


3. Check for known issues:
   WebSphere Adapter nodes

   Transport and connectivity samples

   
   Resolving problems when developing message flows with WebSphere Adapter nodes
   Integrating WMB with SAP
   WebSphere Message Broker support site
   

1. mqsidc
   See: mqsidc usage instructions
   
   • This command line tool is only available for WMB 7.0.0.5+, WMB 8.0.0.1+, and IIB 9.0.
   • When running the tool, select the option for 'Broker Collector', when prompted.


2. Project Interchange files for the problematic flow/set/ESQL/model
   
   • You can export your Message Flow and Message Set project(s) into an archive file for easy transmission to IBM Support.
     See: Backing up the Toolkit Workspace


3. Refer to Adapter troubleshooting MustGathers
4. Traces If the problem occurs during a runtime test or with the Toolkit test facility, WMB execution group traces can be used to gain a better understanding of the problem.
   • A user level trace is intended to assist users with understanding how their ESQL is processed. It will also show a high level view of the message flow behavior.
   • A service level trace is intended to be provided to IBM Support to assist in the diagnosis of your issue.
   • RFC traces:
     Steps to enable and collect the RFC Traces:
     1. Launch the Adapter Connection Wizard ,and proceed to the 'Service Generation and Deployment Configuration' window. In the SAP RFC trace configuration section:
     -Set the RFCTraceOn property to 'true'
     -Set the RFC Trace Level property to '8' , which outputs verbose debug messages, full
     execution path, info messages, errors and warnings
     -Set the Folder for RFC trace files property to the directory location where the RFC Traces
     are created
     * Alternatively, these properties may also be set on SAPConnection configurable service using mqsichangeproperties command or MB Explorer, which would require a broker/execution group restart.

     
     For example: mqsichangeproperties <broker> -c SAPConnection -o Template -n RFCTraceOn -v true

     
     
     2. Recreate the issue.
     
     3. Collect the RFC trace files generated.
     
     Note: The trace files are created in the directory where the adapter process has been started by default. The trace file has a .trc file extension and the file name will start with the letters rfc followed by a unique identifier. For example, rfc03912_02220.trc.


5. General Broker information
   If the mqsidc tool was not run, then capture this information manually
   • Record the WebSphere Message Broker version, release, and maintenance level.
     This can be captured using the command 'mqsiservice -v'..
   • Record the operating system version, release, and maintenance level.
   • Record the version, release, and maintenance level of any related products and components for the problematic application.
   • Collect the local error log. On UNIX and Linux systems, the local error log is the syslog. The location of your syslog is configured in the syslog daemon.
     See: Configuring the syslog daemon
   • Collect the Standard Output/Error logs.
     WMB writes information to both STDOUT and STDERR. These files are located under the Message Broker workpath.
     See: Standard System Logs

ATTENTION: A good problem description is one of the most important tools IBM needs to analyze your data!
When sending data to IBM, be sure to update your PMR or send a note with the following information:

• Tell us what errors you saw, where you saw them, and what time they happened
• Let us know if you made any changes to WebSphere Message Broker or the system before the problem
• Share any other observations which you think will help us to better understand the problem

• Use IBM Service Request to open or view a problem record with IBM.
• Send your data to IBM for further analysis.