ttCapture

The ttCapture utility captures information about the state of TimesTen at the time the command is used. This information may be useful in diagnosing problems. Sometimes TimesTen Customer Support must make repeated incremental requests for information to diagnose a customer's problem in the field.

The information captured by this utility may be requested by TimesTen Customer Support and may be sent with your support email.

The utility does not interpret errors. It only collects information about the state of things and sends output to the ttcapture.date.number.log file in the directory from which you invoke the ttCapture utility. This utility collects general information that is usually relevant to support cases.

Note:

You should always enclose directory and file names in double quotes, in case there are spaces in them.

Required Privilege

This utility requires the instance administrator privilege.

If authentication information is not supplied in the connection string or DSN, this utility prompts for a user ID and password before continuing.

Usage in TimesTen Scaleout and TimesTen Classic

This utility is supported in both TimesTen Classic and TimesTen Scaleout.

Syntax

ttCapture {-h | -help | -?}
ttCapture {-V | -version}
ttCapture [-noinstinfo] [-nosysinfo] [-stdout | -dest dir] [-logdir dir] 
 [dspath | DSN]
ttCapture [-noinstinfo] [-nosysinfo] [-stdout | -dest dir] [-logdir dir] 
 [-noconnect] [dspath | DSN]
ttCapture -noconnect [dspath | DSN]

Options

ttCapture has the options:

Option	Description
-dest dir	Writes the output file to the designated directory.
DSN	Specifies an ODBC data source name of the database to be checked.
dspath	Specifies the fully qualified name of the database to be evaluated. This is not the DSN associated with the connection but the fully qualified database path name associated with the database as specified in the DataStore= parameter of the database's ODBC definition. For example, for a database consisting of files/home/payroll/2011.ds0, /home/payroll/2011.ds1, and several transaction log files /home/payroll/2011.logn, dspath is /home/payroll/2011. NOTE: The DSN and dspath options are mutually exclusive. If you do not supply either option, ttCapture does not provide any database information.
-h -help -?	Prints a usage message and exits.
-logdir dir	Specifies the location of the log directory. Must be used with the -dspath option. If not specified, the log directory may not be available.
-noconnect	Specifies that the utility should capture information on the DSN without connecting to it. If specified, some information, such as ttConfiguration output and replication schemes, is not included in the output. This option is useful if you do not want to load a large database or if you are reporting a problem where connections are failing.
-noinstinfo	Indicates that ttCapture should not capture any installation information.
-nosysinfo	Indicates that ttCapture should not capture any system information.
-stdout	On UNIX and Linux systems, ttCapture writes all output to stdout, instead of writing the output to a file. On Windows, ttCapture writes to a Command prompt.
-V | -version	Prints the release number of ttCapture and exits.

Examples

To capture data on the test_db database and write the database checkpoint files to the directory D:\my_data\recover\test_db, use:

% ttCapture -dest "D:\my_data\recover\test_db" test_db

Note:

This utility is supported only where the TimesTen Data Manager is installed.