How to enable debug logging for Terminal Services Licensing (305089)



The information in this article applies to:

  • Microsoft Windows 2000 Server
  • Microsoft Windows 2000 Advanced Server

This article was previously published under Q305089

SUMMARY

This article describes how to enable debug logging for Terminal Services Licensing. This may be helpful for troubleshooting purposes.

MORE INFORMATION

NOTE: To obtain more debug output, you can apply the checked version of Lserver.exe on the affected computers.
  1. Change the Terminal Services Licensing service settings in Control Panel. Click to select the Allow service to interact with desktop check box on the Log On tab.
  2. Start Registry Editor on the server that is running Terminal Services Licensing, locate and then click the following key:

    HKEY_LOCAL_MACHINE/System/CurrentControlSet/Services/TermServLicensing/Parameters

  3. Create a DWORD value named Console. Set the value to 1.
  4. Create a DWORD value named Log Level. Set the DWORD value as needed according to the following matrix:

    Set the value to FFFFFFFF for full debug information.
    
    Debug level : Bit 0 to 13 (total of 14 debug levels)
    
    Severity code : Bit 30 and 31 
     
    #define DBG_SUCCESS                     0x00
    #define DBG_INFORMATION                 0x01
    #define DBG_WARNING                     0x10
    #define DBG_ERROR                       0x11
    
    Facility code : Bit 14 - 29 
     
    #define DBG_FACILITY_JETBLUE            0x00001
    #define DBG_FACILITY_RPC                0x00002
    #define DBG_FACILITY_KEYPACK            0x00004
    #define DBG_FACILITY_LICENSED           0x00008
    #define DBG_FACILITY_KEYPACKDESC        0x00010
    #define DBG_FACILITY_ALLOCATELICENSE    0x00020
    #define DBG_FACILITY_INIT               0x00040
    #define DBG_FACILITY_LOCK               0x00080
    #define DBG_FACILITY_HANDLEPOOL         0x00100
    #define DBG_FACILITY_RETURN             0x00200
    #define DBG_FACILITY_UPGRADE            0x00400
    #define DBG_FACILITY_POLICY             0x00800
    #define DBG_FACILITY_WORKMGR            0x01000
    #define DBG_FACILITY_WKSTORAGE          0x02000
    #define DBG_FACILITY_SRVLIST            0x04000
    #define DBG_FACILITY_JOB                0x08000
    
    All levels:
     
    #define DBG_ALL_LEVEL                   0x000003FF
    
    Debug level:
     
    #define DBGLEVEL_FUNCTION_ERROR         0x0001
    #define DBGLEVEL_FUNCTION_TRACE         0x0001
    #define DBGLEVEL_FUNCTION_DETAILSIMPLE  0x0002
    #define DBGLEVEL_FUNCTION_DETAILFULL    0x0004
    #define DBGLEVEL_FUNCTION_ALL           DBG_ALL_LEVEL
    						

  5. Stop the Terminal Services Licensing service and restart it. A console window opens on the console of the server that is running Terminal Services Licensing.

    NOTE: This does not work in a Terminal Services session.

Modification Type:MinorLast Reviewed:5/3/2004
Keywords:kbhowto KB305089