ttTraceMon
The ttTraceMon
utility lets you enable and disable the TimesTen internal tracing facilities.
Tracing options can be enabled and disabled separately for each database. Each database contains a trace buffer into which messages describing TimesTen internal operations can be written. By default, tracing is disabled. However, it can be enabled using this utility.
The ttTraceMon
utility provides subcommands to enable, disable, dump and manipulate trace information. ttTraceMon
can be run interactively (multiple subcommands can be entered at a prompt) or not interactively (one subcommand can be specified on the ttTraceMon
command line).
When run interactively, ttTraceMon
prompts for lines of text from standard input and interprets the lines as trace commands. You can provide multiple trace commands on the same line by separating them with semicolons. To exit ttTraceMon
, enter a blank line.
In interactive mode, you can redirect ttTraceMon
command output to a file:
% ttTraceMon connection_string > filename
Component names are case-insensitive. Some commands (dump
, show
and flush
) allow you to list many components and operate on each one. For each subcommand, if you do not list components, the utility operates on all components.
For a description of the components available through this utility and a description of the information that ttTraceMon
returns for each, see Using the ttTraceMon Utility in Oracle TimesTen In-Memory Database Troubleshooting Guide.
Required Privilege
This utility requires the ADMIN
privilege.
Usage in TimesTen Scaleout and TimesTen Classic
This utility is supported in TimesTen Classic but not supported in TimesTen Scaleout.
Syntax
ttTraceMon {-h | -help | -?} ttTraceMon {-V | -version} ttTraceMon [-e subcommand] {-connStr connection_string | DSN}
Options
ttTraceMon
has the options:
Option | Description |
---|---|
|
An ODBC connection string that specifies a database location, driver, and optionally other connection attribute settings. |
|
Indicates the ODBC data source name of the database from which to get trace information. |
|
Causes the subcommand to be run against the specified database. If the subcommand consists of more than one word, enclose it in double quotes. For example: ttTraceMon -e "show err" database1 Once the subcommand is complete, |
|
Prints a usage message and exits. |
|
Prints the release number of |
Subcommands
ttTraceMon
can be called with the following subcommands:
Command | Description |
---|---|
|
List the names and internal identifiers of all For a description of the components available through this utility and a description of the information that |
|
Turn tracing on/off for specified connection. At database creation, tracing is "on" for all connections. The value for |
|
Prints all trace records currently buffered. Requires |
|
Prints all trace records for component |
|
Discards all buffered trace records. |
|
Discards all buffered trace records for component |
|
Prints a summary of the trace commands. |
|
Sets the trace level for component |
|
Prints trace output to the specified file. The file may be any of |
|
Shows all the trace levels in force. |
|
Shows the trace level for component |
|
Sets the maximum number of output files. |
|
Sets the file size limit for output files. If If |
Note:
Because tracing can degrade performance significantly, we recommend that you enable tracing only to debug problems. While primarily intended for use by TimesTen customer support, this information may be useful to system administrators and developers.