Returns current trace flag settings, or changes trace flag settings for the Replication Agent instance.
trace [flag|all, switch]
The name of the trace flag to change the setting for.
A keyword that allows you to apply a switch value to all of the trace flags at once.
A Boolean (true or false) value that enables or disables tracing for the trace point identified in the flag option.
The trace command is intended for use by Sybase Technical Support engineers when troubleshooting Replication Agent.
When trace is invoked with no option, it returns the current settings for all Replication Agent trace flags.
When trace is invoked with the flag and switch options, it changes the setting of the trace flag identified, and it returns the current (new) setting for the trace flag.
When trace is invoked with the all keyword and a switch option, it sets all Replication Agent trace flags to the value specified in the switch option, and it returns the current (new) setting for all of the trace flags.
Changes made with the trace command take effect immediately.
When a trace flag is set to true, tracing is enabled for the trace points identified by the flag. When set to false, tracing is disabled for the trace points.
Output from all trace points (except LTITRACELTL) is sent to the Replication Agent system log file. Use the log_system_name command to find the name and path of the Replication Agent system log file.
Output from the LTITRACELTL trace point is sent to a separate trace output file named LTITRACELTL.log. To view the contents of the LTITRACELTL.log file, your file viewer must be capable of handling very long lines.
The LTITRACELTL.log file contains
a human-readable representation of the LTL, not the actual LTL commands
sent to the primary Replication Server.
Table 1-9 lists Replication Agent trace flags:
Trace flag |
Description |
|---|---|
BMGRTRACE |
When set to “true,” this flag enables Bean Management event tracing. |
CACHETRC |
When set to “true,” this flag enables tracing of internal cache events. |
DBCONTEXT |
When set to “true,” this flag turns on tracing of database context events. |
LATRC |
When set to “true,” this flag traces general Log Administrator operations. |
LATRCSQL |
When set to “true,” this flag traces SQL conversations between Log Administrator and the primary database. |
LICTRACE |
When set to “true,” this flag traces feature license check-in/checkout events. |
LOGREADTRC |
When set to “true”, turns on trace of database log reading. |
LRTRACE |
When set to “true,” this flag traces general execution of the Log Reader component. |
LTITRACE |
When set to “true,” this trace flag enables tracing operations of the Log Transfer Interface component. |
LTITRACELTL |
When set to “true,” this trace flag enables LTL statement tracing in the LTITRACELTL.log file. |
LTMCI |
When set to “true,” causes tracing of LTM component interface invocations and LTM invocations of other components' interfaces. |
LTLFMTTRC |
When set to “true,” this trace flag enables tracing of the LTL formatter. |
LTMHL |
When set to “true,” causes highlights in the LTM execution path to be noted. |
LTMSC |
When set to “true,” causes tracing of all Replication Agent state changes. |
RACONTRC |
When set to “true,” causes tracing of connection and query execution. |
RACONTRCSQL |
When set to “true,” causes tracing of SQL statements to be executed. |
RASDTRC |
(For Oracle and Microsoft SQL Server) When set to “true,” turns on tracing of Replication Agent System Data Repository events. |
RATRACE |
When set to “true,” causes tracing of Replication Agent events. |
STMTRACE |
When set to “true,” causes tracing of LTM state monitor events. |
THREADTRC |
When set to “true,” logs ThreadPool trace events. |
You cannot change the settings of SYSTEM trace flags.
Table 1-10 lists Replication Agent SYSTEM trace flags:
Trace flag |
Description |
|---|---|
CONFIG |
Configuration change event logged. |
ERROR |
Serious error; manual intervention may be needed to recover. |
FATAL |
Critical error; application shut down; manual intervention required to recover. |
INFORMATION |
Information only; no action required. |
WARNING |
Minor error; operation not affected, or problem is recoverable. |
The trace command is valid when the Replication Agent instance is in either Admin or Replicating state.
