Diagnostics

Use the Diagnostics property page to select the type of tracing to run on various components of IBM Spectrum Protect™ Snapshot.

When you encounter a problem, open the Diagnostics property page. Select the diagnostic mode that you want to use by clicking Normal, Complete, or Custom. Then, click Begin to start the trace. Close the property page. Re-create the problem, open the Diagnostics property page, and click End to stop the tracing and collect the data.

If you are using this property page from the Dashboard property sheet, you can run trace only for Microsoft Management Console (MMC).

Diagnostic modes

The following diagnostic mode is available in the Diagnostics property page from the Dashboard property sheet:

MMC - use this mode to set tracing for MMC only. Only MMC tracing can be completed with this mode.

The following diagnostic modes are available in the Diagnostics property page in the workload property sheets. The type of tracing that is enabled for each mode is listed in the table. Specific trace flags, and guidance on when to use each mode is also listed.

Table 1. Diagnostics modes and their usage
Mode	Components traced along with trace flags used	When to use
Normal	MMC, DP (`service`), API (`service,api_detail`)	If you are completing legacy operations, you can use this mode because it results in small output size
Complete	MMC, DP (`service`), API (`service,api_detail`), Agent (`service`)	Use for VSS operations, results in large output size
Custom	Any combination	Use if specific flags are needed

Normal

Click Normal to collect trace and log files for legacy operations. Not applicable for IBM Spectrum Protect Snapshot for Microsoft Exchange Server.

Complete

Click Complete to collect trace and log files for VSS operations.

Custom

Click Custom, then click the check mark icon to select the trace and log files that you want to collect. Use this mode only if specific trace flags are required.

Enable snap-in tracing: Select this box to enable tracing of MMC. Click Review to view the trace file.
Set Default Trace Flags: Click Set Default Trace Flags to set the most commonly requested trace flags.
Enable Data Protection tracing: Select this box to enable tracing of IBM Spectrum Protect Snapshot for Microsoft Exchange Server, IBM Spectrum Protect Snapshot for Microsoft SQL Server, and file system and custom application operations. Click Review to view the trace file. Add or update trace flags in the field.
Enable DSM Agent tracing: Select this box to enable tracing for the IBM Spectrum Protect client node. You must restart the client acceptor service before you start the trace. Click Review to view the trace file. Add or update trace flags in the field.
Enable API tracing: Select this box to enable tracing for the IBM Spectrum Protect API. Click Review to view the trace file. Add or update trace flags in the field.

Email

Select diagnostic files and click Email to send a diagnostic email to an IBM service representative with the selected files attached. You must configure your email information before you can send the data to an IBM service representative. To configure your email information, go to the Dashboard and click Properties. Then, click EMail to open the email property page.

Screenshot

This function is enabled after you click Begin. Click Screenshot to open the Diagnostic Screenshot Tool. This tool is a modeless dialog that remains open until you close it or click End or Cancel.

Click Add New Screenshot to add a screen capture to the FlashCopyManager\ProblemDetermination folder. The screen capture can be selected with other diagnostic data.