Windows 2000 client logging and tracing

This topic describes the logging and tracing capabilities available on SAN File System Windows® 2000 clients.

A SAN File System Windows 2000 client provides two types of messages:
  • Log messages that provide information, warnings, and errors of general interest to administrators and support personnel.

    Log messages are written to the standard system logging interface, the Windows Event Log. In addition to the operating system messages, the Windows Event Log contains messages generated by the SAN File System.

    You can use the Event Viewer to list messages from the Event Log. If you double-click a message from the Event Viewer, you can find more detailed information about that message. You can also use the Event Viewer to filter messages by message type, source of the message, or according to a specified range of time. You can also dump events to a text file, which is useful for sending problem determination data to remote support personnel.

    The following example messages show the format of the log messages:

    4/21/2003 7:32:03 PM  Stfs  Error        None  9  N/A  WINCLIENT1  
       HSTCW0009E: Couldn't contact server at IP address <18.18.18.99:11190>
    4/21/2003 7:32:36 PM  Stfs  Information  None  8  N/A  WINCLIENT1  
       HSTCW0008I: Contacted server at IP address <18.18.18.99:11190>.
    4/21/2003 7:32:02 PM  Stfs  Information  None  1  N/A  
       WINCLIENT1  HSTCW0001I: SAN File System client started successfully.
  • Trace messages that consist of extensive low-level tracing output about client functions and internal data.

    You can use the stlog command to enable and control tracing for a client. However, you should use the stlog command with care; enabling full tracing can significantly impact the performance of the SAN File System.

    If tracing is enabled, the SAN File System writes trace messages to a file named c:\Program Files\IBM\Storage Tank\client\log\sanfs.log. This file contains tracing output only for the SAN File System client. It does not contain information for the operating system or any other applications.
    Note: By default, minimal tracing is enabled.

    Enabling detailed tracing

    To enable detailed tracing, you must provide a path and filename to a file to use for the detailed trace log:
    1. Start the Windows registry editor.
    2. Navigate to the following registry key:

      \\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Stfs\ Trace

    3. In this key there is an empty string value named FileName. Double-click on FileName and change its value in the string editor to a valid path and file name for the trace log (for example, c:\stfs.log)
    4. Click OK.
    5. Reboot for the changes to take effect.

    The following example messages show the format of trace messages:

    #E   8125026652|80BF9DA0 Reassert TStreamSocket::Disconnect:1911   
         84860B68 192.168.10.6:10290       CheckStatus failed:  
         STATUS_CONNECTION_ACTIVE (C000023B)
         8125026715|8122C9E0 ckground TBackground::Main:1301           
         F4A8EF88                Active count: 00000001
         8125026715|8122C9E0 ckground TBackground::Main:1305           
         F4A8EF88                Active work items: 00000000
         8125026715|8122C9E0 ckground TBackground::Main:1308           
         F4A8EF88                Active delayed work items: 00000000
         8125031715|8122C9E0 ckground TBackground::Main:1301           
         F4A8EF88                Active count: 00000001
         8125031715|8122C9E0 ckground TBackground::Main:1305           
         F4A8EF88                Active work items: 00000000
         8125031715|8122C9E0 ckground TBackground::Main:1308         
         F4A8EF88                Active delayed work items: 00000000
         8115545496|FE2D7020          TSc::Reference                   
         FE484008 Fil:<23456.3.1342760.0>  ReferenceCount 3, CsmHandle_Held

Parent topic: Client diagnostic tools

Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.