Default Trace and Log Options Dialog Box

Use the options in this dialog box to enable tracing. Trace files are primarily used by Attachmate Technical Support for diagnostic purposes. Trace files are not enabled by default because they use a significant amount of hard disk space. For more information about trace files, see "Trace and Log Files" in the DATABridge Client Administrator's Guide.

Trace Options

Select all

Click to select all of the trace options.

Log output

Writes log messages (in addition to trace information) to the trace.log file. (Decimal value: 1 Hexadecimal value: 0x1.)

Server messages

Enables tracing of DATABridge Server communications messages for key actions associated with DATABridge on the host, including API calls such as DB_SELECT and DB_READ and their responses. (Decimal value: 4. Hexadecimal value: 0x4.)

 

Database API calls

Enables the logging of calls from the DATABridge Client to the ODBC, OCI or CLI APIs. This is also referred to as relational database API tracing.

 

TCP/IP data

Enables a protocol trace of the information exchange between DATABridge Server on the host or Enterprise Server and the DATABridge Client. The blocks of data are traced as they are read and written to the TCP interface. The messages are listed in DEBUG format, which is an offset followed by 16 bytes in hexadecimal, followed by the same 16 bytes interpreted as EBCDIC text. The non-printable EBCDIC characters are displayed as periods (.). (Decimal value: 64. Hexadecimal value: 0x40.)

 

Debug

Enables debugging code that may be added to engineering releases of the DATABridge Client. (Decimal value: 256. Hexadecimal value: 0x100.)

 

Remote console RPCs

Enables remote console message tracing when running DBClient or DBClntCfgServer in conjunction with the service. (Decimal value: 128. Hexadecimal value: 0x80.)

 

Callback exit

Enables a trace that helps determine if delays occurred while SQL statements were being executed or while the DATABridge Client was waiting for data from the DATABridge Server. (Decimal value: 8. Hexadecimal value: 0x8.)

 

SQL commands

Enables a trace of SQL commands. (Decimal value: 8. Hexadecimal value: 0x8.)

 

Control table load

This is load tracing. Load tracing logs information on the DATABridge Client control tables as they are loaded from the relational database. (Decimal value: 8. Hexadecimal value: 0x8.)

 

Bulk loader data

This is a trace of the records that are written to temporary data files (or UNIX pipes) and used by the bulk loader utility during the data extraction phase of cloning. (Decimal value: 32. Hexadecimal value: 0x20.)

 

Remote console data

This is a protocol trace of the information exchange between DBClient or DBClntCfgServer and the service. The output looks like a DATABridge Server protocol trace, except for the fact that all the data is ASCII. (Decimal value: 1024. Hexadecimal value: 0x400.)

 

List config file

This option displays the configuration file parameters as they are processed. (Decimal value: 512. Hexadecimal value: 0x200.)

 

User script SQL

Temporarily enables SQL tracing when running user scripts during define and redefine commands. (Decimal value: 2048. Hexadecimal value: 0x800.)

 

Trace mask

Uses a trace mask to limit the recorded trace operations. Specify a hexadecimal value to indicate the trace mask.

Log options

Verbose

Captures all activity, which is then written to the trace file.

Note: This option should be used for troubleshooting purposes. Use care when selecting it on a production system as it will add a large volume of non-relevant output to your logs.

Related Topics

Set Up Service Log Files