Skip Headers
Oracle® Application Server Forms Services Deployment Guide
10g Release 2 (10.1.2)
B14032-03
  Go To Documentation Library
Library
Go To Product List
Product
Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
 
Next
Next
 

8.2 Configuring Forms Trace

An event is something that happens inside Oracle Forms as a direct or indirect result of a user action. An event set specifies a group of events that you can trace simply by specifying the event set name rather than each event number individually when you start the trace.

Use the Forms Trace Configuration selection in the Configuration tab of Oracle Enterprise Manager 10g Application Server Control Console Forms page to define the events that you want to trace. This page manages all changes in the ftrace.cfg file for you.

Keep these items in mind when working with Forms Trace:

See Section 8.5, "List of Traceable Events" for a list of events and their corresponding event numbers.

To configure Forms Trace: 

  1. Start the Enterprise Manager Application Server Control Console.

  2. From the Enterprise Manager Application Server Control Console main page, select the link to the Forms Services instance that you want to configure.

  3. From the Overview page for the Forms Services instance, select the Configuration link.

To create a new parameter in the ftrace.cfg file: 

To delete a parameter in the ftrace.cfg file: 

To edit an existing parameter in the ftrace.cfg file: 

To save your changes: 

Figure 8-1 is a sample ftrace.cfg configuration file where three event sets have been specified.

Figure 8-1 Configuring Trace Events in Enterprise Manager

Configuring trace events with Enterprise Manager.

Note the following if you are manually editing ftrace.cfg:

When you start the trace, you can specify tracegroup = "custom1" on the command line, which is equivalent to specifying tracegroup = "32-46, 65, 66, 96, 194"

8.2.1 Specifying URL Parameter Options

The following command line parameters are used to configure Forms Trace:

Tracegroup =   
Log = <filename> 

Table 8-1 describes the parameter values:

Table 8-1 Forms Trace Command Line Parameters

Parameter Values Description

Record

forms

Enables Forms Trace.

Tracegroup

Name, event number, or event range

Indicates which events should be recorded and logged.

  • If Tracegroup is not specified, only error messages are collected.

  • Tracegroup is ignored if Forms Trace is not switched on at the command line.

  • You can create a named set of events using the Tracegroup keyword, for example

Tracegroup=<keyword>, where <keyword> is specified in ftrace.cfg (for example, Tracegroup=MyEvents).

This lets you log the events in the named set SQLInfo.

  • You can log all events in a specified range using the Tracegroup keyword, for example

    Tracegroup = 0-3
    

    This lets you log all events in the range defined by 0 <= event <=3.

  • You can log individual events using the Tracegroup keyword, for example

    Tracegroup = 34,67
    
  • You can combine event sets using the Tracegroup keyword, for example

    Tracegroup = 0-3,34,67,SQLInfo
    

Log

Directory

Specifies where trace information is saved. Trace files must be saved to ORACLE_HOME/forms/trace for Enterprise Manager to find and process them correctly.

If a directory is not specified, the file is written to the current working directory.

If a log file is not specified, the process ID (PID) of the user process is used as the name of the trace file, for example, forms_<pid>.trc.