1. Working with Oracle Forms
  2. Troubleshooting, Diagnostics, and Performance Tuning
  3. Tracing and Diagnostics
  4. Viewing Forms Trace Output

Viewing Forms Trace Output

Only administrators or a user belonging to administrators' group can view trace log files. Once the user has logged in, he or she does not have to log in again in the same browser session to view trace log files for different sessions.

Trace data is stored in a binary file with a *.trc extension. The default location of the trace log is $DOMAIN_HOME/system_components/FORMS/<FORMS INSTANCE NAME>/trace/forms_<PID>.trc where pid is the process ID of the user session. If you are not using Enterprise Manager Fusion Middleware Control, you need to use the Translate utility, as described in Running the Translate Utility.

To view trace data:

  1. From the Forms menu in Fusion Middleware Control, select the User Sessions menu item.
  2. Select a User Session row and click Trace Log to see the contents of the trace log.
  3. Log in to view the trace file.

Running the Translate Utility

The Translate utility converts trace data to XML, HTML, or text formats. You need to specify an additional parameter "OutputClass" which has three legal values: "WriteOutTEXT", "WriteOutXML" and "WriteOutHTML". If you do not specify the outputclass, the output file is in text format. These values are case-sensitive.

Note:

To use the Translate Utility:

  1. Set the PATH variable to include the path to the directory containing the Java executable.

  2. Set the CLASSPATH variable to include the path to frmxlate.jar.

To convert trace data to Text format:

  • At the command line, enter:

    java oracle.forms.diagnostics.Xlate datafile=a.trc outputfile=myfile.txt outputclass=WriteOutTEXT

    This creates a file called myfile.txt in text format.

To convert trace data to HTML format:

  • At the command line, enter:

    java oracle.forms.diagnostics.Xlate datafile=a.trc outputfile=myfile.html outputclass=WriteOutHTML

    This creates a file called myfile.html in HTML format.

To convert trace data to XML format:

  • To create myfile.xml, at the command line, enter:

    java oracle.forms.diagnostics.Xlate datafile=a.trc outputfile=myfile.xml outputclass=WriteOutXML

    This creates a file called myfile.xml in XML format.