Diagnosing Problems

  1. Connection Problem diagnostics
  2. Working with Log Files

Connection Problem Diagnostics

Follow the steps below to diagnose problems while establishing a connection to the ADFz Common Components Server.

  1. Specify a new connection in the Host Connections view
    Specify new connection in Host Connections View
    Host Connections View
  2. Open the ADFz preference page in the Eclipse preferences (Window -> Preferences).
    ADFz Preference Page
    ADFz Common Components preference page view
  3. Select the system to diagnose from the Connection drop-list.
  4. Click on the Check Connection button to perform the problem diagnostics.
  5. The tool returns problem diagnostic information in a dialog.
    Success Dialog Failure Dialog
    Connection Success dialog Connection failure dialog

Once you have the dialog, especially the dialog with errors, you can examine the returned messages to diagnose the problem.

Diagnostic Information Action
'***** ERROR *****' Marks the beginning of errors discovered during the problem diagnosis. Read the error message to understand the problem. For example, the error dialog above reports an error related to an invalid port number. You need to verify that the port number is valid for the ADFz server with your system administrator.
The diagnostic tool hangs If the client is hanging after clicking on the test connection button, click on the cancel button and read the problem diagnostic information returned in the dialog. You have most likely specified a port number which is used by another product.
Failure to launch an extension The ADFz Server is extensible with additional configuration files. For example, it can be extended to handle Fault Analyzer for z/OS and File Manager for z/OS plug-ins by configuring the extensions. If you are unable to use one of the ADFz plug-ins, it is possible that the server extensions are not installed and configured on your server. To check which extensions are configured on the server, look for the following section in the diagnostics text: Getting the information about extensions installed on the server. You will find a list of server extensions that are known to the ADFz Server. Look for the extension configuration names shown below:
  • APA: Application Performance Analyzer for z/OS extension
  • FA: Fault Analyzer for z/OS extension
  • FM: File Manager for z/OS extension
  • DT: z/OS Debugger DTSP extension
Known server extensions
Known server extensions reported

In the example above, FA and FM extensions are installed along with DEFAULT (a required configuration file) and VRFY (a pre-configured extension for enabling the problem diagnosis).

Back to top

Working with Log Files

You can view the local log file contents by pressing the View Log button. You can also clear the contents of the local log file by pressing the "Clear Log" button.

The log files are intended for use by the IBM support team when diagnosing problems. If requested, follow these steps to capture the debugging information:

  1. Select Run the server in debug mode option.
  2. Clear the local log file contents by pressing Clear Log button.
  3. Execute the sequence of actions to reproduce the problem.
  4. View the log file by pressing View Log button and send the contents to the IBM support team.
Back to top