Generating a Trace

How to:

If you encounter a server problem, you can run a set of traces that will help you assess the problem, and, if necessary, communicate it to Customer Support Services for further troubleshooting. This topic describes trace options and provides instruction for creating the traces.

There are two types of traces you can run to troubleshoot a problem:

Under normal conditions, most applications are run in a server context. However, if you run your trace in a non-server context (that is, if you run a non-server trace), you can produce the necessary diagnostic information while significantly reducing the amount of material that needs to be reviewed. Running a non-server trace also rules out server communications as a cause of your problem.

Optionally, you can start traces, turn traces off, and perform the edastart -savediag function by selecting options from the Windows Start menu, under the Diagnostics folder, rather than by opening a DOS session to execute these commands.

Top of page
x
Procedure: How to Generate a Server Trace

To generate a server trace:

  1. Turn tracing on by doing one of the following:
    • Go to the Web Console menu bar, select Workspace and then Enable Traces.
    • Start the server by issuing the following command:

      edastart -traceon

      You must preface edastart with the appropriate path, or place the directory in your system PATH variable.

  2. Reproduce the problem.
  3. Stop the server.
  4. Issue the following command: 
    edastart -savediag
  5. Respond to the prompts to capture, and optionally archive, diagnostic information.

    For information about sending the diagnostic information to Customer Support Services, see Information You Should Have and Customer Support.

Top of page
x
Procedure: How to Generate a Non-Server Trace

To generate a non-server trace:

  1. Create a directory under APPROOT to reproduce the problem.
  2. Copy any files required for the reproduction to the directory.
  3. Switch to the directory.
  4. Reproduce the problem using edastart -traceon and one of switches -t, -x, or -f.
  5. Switch to a directory other than the problem reproduction directory.
  6. Issue the following command: 
    edastart –savediag
  7. Respond to the prompts to capture, and optionally archive, diagnostic information.

    For information about sending the diagnostic information to Customer Support Services, see Information You Should Have and Customer Support.

iWay Software