This command displays and sets tracing options within Process Engine (PE) and is mainly intended for FileNet engineering staff use. You can trace a variety of server activity, such as remote procedure calls or log manager processes. You can route this trace information to the screen (stdout device), to a PE trace file, or to memory—if you route the trace information to memory, you can subsequently save the trace information to a file of your choice.
The command displays each trace destination and option. Those that are currently enabled are prefaced with "**".
NOTE Restarting the PE server automatically turns off all trace options.
Syntax
The syntax varies depending on the mode you choose. The interactive mode requires that you indicate settings for all of the trace options. The command line mode allows you to enable selected options. (Note that as with all vwtool commands, the information for the interactive mode can be entered at the command line as well, as long as you provide all necessary information.)
Mode | Syntax |
---|---|
Interactive |
trace <change_tracing_options> [<trace_destinations>] [<trace_options>] |
Command line |
trace [set_or_reset] [<trace_destination>] [<trace_options>] TIP You can set and reset options in the same command line, for example: |
Parameters
change_tracing_options |
Enter "y" to change any of the displayed settings, or "n" to leave them as is. The remaining prompts only appear if you answer 'y' to the change_tracing_options prompt. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
set_or_reset | Enter "set" or plus (+) to enable a trace destination or option. Enter "reset" or minus (-) to disable a trace destination or option. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
trace_destination |
Indicates where you want the trace information to be stored. Interactive mode: For each destination, enter "y" for yes or "n" for no. The destinations appear in the order indicated below. Command line mode: Enter the destination, in any order. You can abbreviate the destination to three characters, as noted below.
To turn tracing off: NOTE Disabling all trace destinations effectively turns off tracing. However, there is some performance overhead resulting from leaving trace options enabled. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
trace_options |
The trace activity that you can enable or disable. Interactive mode: For each parameter, enter "y" for yes or "n" for no. The options appear in the order indicated below. Command line mode: Enter the option name, in any order. You can abbreviate most options to three or more unique characters. Spaces are removed for syntax purposes (for example, Object Service becomes "objectservice"). The shortest usable abbreviation or an acceptable alternative for each option is shown in parentheses following its name.
|