Client trace classes
The client provides individual and aggregate trace classes. Aggregate trace classes are a shortcut for enabling many related trace classes by simply specifying the aggregate trace class name. For the documented trace classes, there might be references to trace classes that are enabled as part of an aggregate trace class, but are not explicitly discussed on their own.
The trace classes in Table 1 are the trace classes
that are usually requested or used for diagnosing problems. The trace
class name must be used with the TRACEFLAG options
in the dsm.opt file.
| Trace Class | Description | Recommendation |
|---|---|---|
| ALL_BACK | Displays general backup processing information for the client. Aggregate of TXN, INCR, POLICY, and PFM trace classes and implicitly included in the SERVICE trace class. | Use this trace class for problems that are related to selective or incremental backups. |
| ALL_FILE | Displays general backup processing information for the client. Aggregate of DIROPS, FILEOPS, and FIOATTRIBS trace classes and implicitly included in the SERVICE trace class. | Use this trace class for problems that are related to reading and writing data and obtaining file attribute information. |
| ALL_IMAGE | Displays image-processing information for the client. Aggregate of several image-related trace classes and implicitly included in the SERVICE trace class. | Use this trace class for problems that are related to all aspects of volume image backup and restore operations. |
| ALL_JBB | Displays journal-based backup processing information for the client. Aggregate of several journal-based backup-related trace classes and implicitly included in the SERVICE trace class. | Use this trace class for problems that are related to all aspects of journal-based backups. |
| ALL_NAS | Displays NDMP processing information for the client. Aggregate of several NDMP-related trace classes and implicitly included in the SERVICE trace class. | Use this trace class for problems that are related to all aspects of NDMP backup and restore operations. |
| ALL_SESS | Displays all session and verb information that is sent between the client and the server. Aggregate of SESSION, VERBINFO, SESSVERB, VERBADMIN, and VERBDETAIL trace classes. All of the trace classes in this aggregate are implicitly included in the SERVICE trace class, except VERBDETAIL. | Use this trace class for problems that are related to the client and server session, such as communication timeouts, protocol violations, and instances where the client appears to be stopped and waiting for the server, or vice versa. |
| ALL_SNAPSHOT | Displays information that relates to volume snapshot operations. Aggregate of several volume snapshot-related trace classes and implicitly included in the SERVICE trace class. | Use this trace class to determine problems that are related to volume snapshots that are used in online image backup and open file-support operations. |
| ALL_WAS | Displays Web Application Server (WAS) processing information for the client. Aggregate of several WAS-related trace classes and implicitly included in the SERVICE trace class. | Use this trace class for problems that are related to all aspects of WAS backup and restore operations. |
| AUDIT | Displays auditing information for backup and restore processing. Part of the SERVICE trace aggregate. | Use this trace class to keep record of files processed, committed, and restored in a file. |
| CLIENTTYPE | Displays client type on each trace output line. | Use this trace class for tracing situations when more than one client component is involved, such as the client acceptor and the file system agent. |
| COMPRESS | Displays compression information. Part of the SERVICE trace aggregate. | Use this trace class to determine how much data is compressed on a per-file basis. |
| DELTA | Displays adaptive subfile backup processing information. Part of the SERVICE trace aggregate. | Use this trace class to determine errors in adaptive subfile backup and restore operations. |
| DIROPS | Displays directory read and write operations. Part of the SERVICE and ALL_FILE trace aggregates. | Use this trace class when problems occur in a read or write directory. |
| DOMAIN | Displays incremental domain processing information. Part of the SERVICE trace aggregates. | Use this trace class for determining how DOMAIN statements are resolved during backup processing, such as problems in resolving the ALL-LOCAL domain. |
| ENCRYPT | Displays data encryption information. Part of the SERVICE trace aggregate. | Use this trace class to determine whether a file is included for encryption processing. |
| ERROR | Displays operating system-specific error information. Part of the SERVICE trace aggregate. | Use this trace class to determine the error codes that are generated by the operating system. |
| FILEOPS | Displays file read and write operations. Part of the SERVICE and ALL_FILE trace aggregates. | Use this trace class when problems occur in a file open, read, write, or close operation. |
| FIOATTRIBS | Displays comparisons of file attributes between the local client version and the active version on the server. Part of the SERVICE, ALL_BACK, and ALL_FILE trace aggregates. | Use this trace class in determining why a file was backed up during an incremental backup. |
| INCR | Displays incremental list processing comparisons between the client and server. Part of the SERVICE and ALL_BACK trace aggregates. | Use this trace class to determine whether files are candidates for incremental backup, especially with the FIOATTRIBS trace class. |
| INCLEXCL | Displays include-exclude status for the object that is being processed. This flag is also used for the Preview function. | Use this trace class to determine which object (usually file or directory) is included or excluded during backup-archive/preview. |
| MEMORY | Displays memory allocation and free requests. This trace class writes a large amount of information into the trace file and is not included in any aggregate classes. | Use this trace class to determine memory leaks, memory spikes, and other memory-related problems. |
| OPTIONS | Displays current processing options. Part of the SERVICE trace aggregate. | Use this trace class to determine which options are in effect for the current session, and for problems in accepting processing options from server client-options sets. |
| PASSWORD | Displays password file-access information (does not show passwords). Part of the SERVICE trace aggregate. | Use this trace class to determine problems with reading the server passwords from local storage, for example, PASSWORDACCESS= GENERATE errors. |
| PID | Displays process ID on each trace statement. Part of the SERVICE trace aggregate. | Use this trace class to diagnose problems that might involve multiple processes. |
| POLICY | Displays policy information available to the backup-archive client. Part of the SERVICE and ALL_BACK trace aggregates. | Use this trace class to see which policies are available during a backup or archive operation. |
| SCHEDULER | Displays general processing information for the scheduler. An aggregate that includes most of the client trace classes that are listed in this table. Aggregate of all trace classes except MEMORY, THREAD_STATUS, and *DETAIL classes. | Useful in many cases. This trace class is used for diagnosing scheduler problems when the nature of the problem is unknown. If the SCHEDULER trace flag is used, it generally is not necessary to specify any other trace flags because it already includes most of the basic trace classes. |
| SERVICE | Displays general processing information for the client. An aggregate that includes most of the client trace classes that are listed in this table. Aggregate of all trace classes except MEMORY and *DETAIL classes. The SERVICE trace flag can generate a substantial amount of information. Consider using the TRACEMAX option with the SERVICE trace flag. | Useful in many cases. This trace class is used when the nature of the problem is unknown. If the SERVICE trace flag is used, it is not necessary to specify any other trace flags because it already includes most of the basic trace classes. |
| SESSION | Displays minimal session information between the client and the server. Part of the SERVICE and ALL_SESS trace aggregates. | Use this trace class to give session context to general processing errors, or with one of the VERB* trace classes, to determine session problems such as session timeouts and protocol violations. |
| SESSVERB | Displays additional session information between the client and the server. Part of the SERVICE and ALL_SESS trace aggregates. | Use this trace class to give session context to general processing errors, or with one of the VERB* trace classes, to determine session problems such as session timeouts and protocol violations. |
| STATS | Displays final processing statistics in the trace file. Part of the SERVICE trace aggregate. | Use this trace class for collecting final processing statistics into a file. |
| THREAD_STATUS | Displays thread status. Part of the SERVICE trace aggregate. | Use this trace class when you are diagnosing problems related to threading. |
| TXN | Displays transaction processing information. Part of the SERVICE and ALL_BACK trace aggregates. | Use this trace class when you are diagnosing problems related to transaction processing problems on the server, and for such problems as transaction stops and retries. |
| VERBDETAIL | Displays detailed verb information pertinent to client-server sessions. Part of the ALL_SESS trace aggregates. | Use this trace class to determine the contents of verbs that are sent between the client and server. |
| VERBINFO | Displays verb information pertinent to client-server sessions. Part of the SERVICE and ALL_SESS trace aggregates. | Use this trace class with the SESSION traceflag to give session context to general processing errors or to determine session problems like session timeouts and protocol violations. |
| WIN2K | Displays Windows system object or system state processing. Part of the SERVICE trace aggregates. Only valid on the Windows backup-archive client. | Use this trace class to determine errors with backup or restore of the system state information. |