Returns current trace flag settings, or changes trace flag settings for the Mirror 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 Mirror Replication Agent.
When trace is invoked with no option, it returns the current settings for all Mirror 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 of the 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 point(s) identified by the flag. When set to false, tracing is disabled for the trace point(s).
Normal output from trace points is sent to the Mirror Replication Agent system log file. Use the log_system_name command to find the name and path of the Mirror Replication Agent system log file.
Output from the LTITRACELTL trace point is sent to a separate Log Transfer Language (LTL) output file named LTITRACELTL.log. If you want to view the contents of the LTITRACELTL.log file, your viewer must be capable of handling very long lines.
The LTITRACELTL.log file contains
a human-readable representation of the LTL output, not the actual
LTL sent to the Replication Server.
Table 4-6 lists Mirror Replication Agent trace flags:
Trace flag |
Description |
|---|---|
BMGRTRACE |
Traces “Bean Management” events. |
CACHETRC |
Traces internal global cache events. |
LATRC |
Traces Log Admin events. |
LATRCSQL |
Traces Log Admin conversations with primary database. |
LICTRACE |
Traces feature license check-in/checkout events. |
LOGREADTRC |
Traces ASE log-reading events. |
LRTRACE |
Traces general Log Reader events. |
LTITRACE |
Traces general Log Transfer Interface events. |
LTITRACELTL |
Records LTL output in LTITRACELTL.log file. |
LTMCI |
Traces Log Transfer Manager interface events. |
LTMHL |
Traces highlights in Log Transfer Manager execution. |
LTMSC |
Traces Mirror Replication Agent state changes. |
RACONTRC |
Traces connection and query execution. |
RACONTRCSQL |
Traces SQL statements sent to primary database. |
RASDTRC |
Traces RASD events. |
RATRACE |
Traces general Mirror Replication Agent events. |
STMTRACE |
Traces Log Transfer Manager state monitor events. |
THREADTRC |
Traces ThreadPool events. |
You cannot change the settings of SYSTEM trace flags.
Output from SYSTEM trace points is sent to the system log file. Use the log_system_name command to find the name and path of the Mirror Replication Agent system log file.
Table 4-7 lists Mirror 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 Mirror Replication Agent instance is in either Admin or Replicating state.
