Starting and Stopping Forms Trace

12-4 Forms Services Deployment Guide 2. Enter the value and description for the trace group.

3. Click Apply to save the changes, or Revert to discard them.

12.2.2 Specifying URL Parameter Options

The following command line parameters are used to configure Forms Trace: Record = Tracegroup = Log = filename Table 12–1 describes the parameter values:

12.3 Starting and Stopping Forms Trace

You start a trace by specifying trace entries in the URL or from Fusion Middleware Control. Entries should include the grouping of events to collect and the trace file name. Trace collection starts when the form executes. The following are sample URLs to start a trace: http:example.comformsfrmservlet?form=cxlrecord=formstracegroup=0-199 http:example.comformsfrmservlet?form=cxlrecord=formstracegroup=mysql Table 12–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 and Startup 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 MyEvents. ■ 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 Tracing and Diagnostics 12-5 To start tracing a session from Fusion Middleware Control: 1. From the Forms menu, select User Sessions. The User Sessions page appears. 2. Select the row containing the Forms user session for which you want to enable tracing.

3. Click Enable Tracing.

The Enable Tracing dialog appears.

4. From the Select Trace Group list, select an available trace group and click OK.

The Enable Tracing dialog is dismissed and tracing is now enabled for the selected Forms user session. To stop tracing a session from Fusion Middleware Control: 1. From the Forms menu, select User Sessions. The User Sessions page appears. 2. Select the row containing the Forms user session for which you want to disable tracing.

3. Click Disable Tracing.

The Disable Tracing dialog is displayed.

4. Click OK.

The Disable Tracing dialog is dismissed and tracing is now stopped for the selected Forms user session. To switch between trace groups for a session: 1. Select the row containing the Forms user session for which you want to change the trace group.

2. Click Enable Tracing.

The Enable Tracing dialog is displayed.

3. From the Select Trace Group list, select the new trace group and click OK.

The Enable Tracing dialog is dismissed. Refresh the page.

12.4 Viewing Forms Trace Output