How to use the Language Resource Test (Lrtest.exe) command-line tool in SharePoint Portal Server 2003 (890613)



The information in this article applies to:

  • Microsoft Office SharePoint Portal Server 2003

Important This article contains information about modifying the registry. Before you modify the registry, make sure to back it up and make sure that you understand how to restore the registry if a problem occurs. For information about how to back up, restore, and edit the registry, click the following article number to view the article in the Microsoft Knowledge Base:

256986 Description of the Microsoft Windows Registry

INTRODUCTION

This article describes how to use the Language Resource Test (Lrtest.exe) command-line tool that is included with Microsoft Office SharePoint Portal Server 2003.

The Language Resource Test tool is an unsupported tool that is located in the Support\Tools folder of the SharePoint Portal Server 2003 CD. The ToolsHowTo.txt file that is located in the Support\Tools folder contains the following information about the Language Resource Test tool:

The Language Resource Test Tool allows the loading of word breakers, stemmers, and filters so that the user can see the output of these resources given specific input.  This is helpful for:
--Word breakers and stemmers when identifying how text is broken at index time, query time, and query time with stemming. 
--Filters to view exactly what the output is from a given filter. 
To obtain help for using this tool, type lrtest ? at command prompt.

Additional information about this feature will be provided on the Web. For the latest information, see http://www.microsoft.com/SharePoint/Assistance.

Note The URL that is mentioned in the ToolsHowTo.txt file does not contain additional information about the Language Resource Test tool.

MORE INFORMATION

Warning If you use Registry Editor incorrectly, you may cause serious problems that may require you to reinstall your operating system. Microsoft cannot guarantee that you can solve problems that result from using Registry Editor incorrectly. Use Registry Editor at your own risk.
You can use the Language Resource Test tool to load word breakers, stemmers, and filters and to view information about how these components process specific text. The following is an example of how to use the Language Resource Test tool to load and to view word-breaker information:
  1. Determine the class ID (CLSID) and the name of the .dll file that you must load. To do this, follow these steps:
    1. Click Start, click Run, type regedit in the Open box, and then click OK.
    2. Locate the following registry subkey:

      HKEY_LOCAL_MACHINE\Software\Microsoft\SPSSearch\ContentIndexCommon\LanguageResources

    3. Expand Default, and then click the language that you want. For example, click English (United States).
    4. In the right pane, double-click WBreakerClass. Make a note of the CLSID that is displayed in the Value data box. For example, the following is the CLSID for the English (United States) word breaker:

      {188D6CC5-CB03-4C0 1-912E-47D21295D77E}

      Click Cancel.
    5. In the right pane, double-click WBDLLPathOverride. Make a note of the name and the path of the .dll file that is displayed in the Value data box. For example, the following is the .dll file that is displayed for the English (United States) word breaker:

      LangWrbk.dll

      Click Cancel.
    6. Quit Registry Editor.
  2. Run the Language Resource Test tool. To do this, follow these steps:
    1. Copy the Lrtest.exe file from the Support\Tools folder of the SharePoint Portal Server 2003 CD to the following folder on the server:

      Drive:\Program Files\SharePoint Portal Server\Bin

    2. Click Start, click Run, type cmd in the Open box, and then click OK.
    3. At the command prompt, switch to the following folder:

      Drive:\Program Files\SharePoint Portal Server\Bin

    4. Type the command line that you want, and then press ENTER. For more information about the syntax that Lrtest.exe uses, type lrtest /? at the command prompt, and then press ENTER. See the following examples:
      • To view information about how the word breaker processes the "1.1.4322.910" string in a query, type the following command line, and then press ENTER:

        lrtest /b /q /c:{188D6CC5-CB03-4C0 1-912E-47D21295D77E} /m:langwrbk.dll "1.1.4322.910"

        The following output is displayed:

        dll loaded: Drive:\Program Files\SharePoint Portal Server\Bin\langwrbk.dll
        
          dll version 11.0.5704.0
          file create time:  9-04-2003  6:50p
          file last write time:  9-04-2003  6:50p
          FileVersion: '11.0.5704.0'
          FileDescription: 'Microsoft Search English Word Breaker'
          CompanyName: 'Microsoft Corporation'
          ProductName: 'SharePoint Portal Server'
        Wordbreaker requires license: No
        Wordbreaker license: 'Copyright Microsoft Inc.'
        Original text: '1.1.4322.910'
        IWordSink::PutAltWord: cwcSrcLen 1, cwcSrcPos 0, cwc 1, '1'
        IWordSink::PutWord: cwcSrcLen 1, cwcSrcPos 0, cwc 3, 'NN1'
        IWordSink::PutAltWord: cwcSrcLen 1, cwcSrcPos 2, cwc 1, '1'
        IWordSink::PutWord: cwcSrcLen 1, cwcSrcPos 2, cwc 3, 'NN1'
        IWordSink::PutAltWord: cwcSrcLen 4, cwcSrcPos 4, cwc 4, '4322'
        IWordSink::PutWord: cwcSrcLen 4, cwcSrcPos 4, cwc 6, 'NN4322'
        IWordSink::PutAltWord: cwcSrcLen 3, cwcSrcPos 9, cwc 3, '910'
        IWordSink::PutWord: cwcSrcLen 3, cwcSrcPos 9, cwc 5, 'NN910'

      • To view information about how the word breaker processes the "1.1.4322.910" string during indexing, type the following command line, and then press ENTER:

        lrtest /b /c:{188D6CC5-CB03-4C01-9 12E-47D21295D77E} /m:langwrbk.dll "1.1.4322.910"

        The following output is displayed:

        dll loaded: Drive:\Program Files\SharePoint Portal Server\Bin\langwrbk.dll
          dll version 11.0.5704.0
          file create time:  9-04-2003  6:50p
          file last write time:  9-04-2003  6:50p
          FileVersion: '11.0.5704.0'
          FileDescription: 'Microsoft Search English Word Breaker'
          CompanyName: 'Microsoft Corporation'
          ProductName: 'SharePoint Portal Server'
        Wordbreaker requires license: No
        Wordbreaker license: 'Copyright Microsoft Inc.'
        Original text: '1.1.4322.910'
        IWordSink::PutAltWord: cwcSrcLen 1, cwcSrcPos 0, cwc 1, '1'
        IWordSink::PutWord: cwcSrcLen 1, cwcSrcPos 0, cwc 3, 'NN1'
        IWordSink::PutAltWord: cwcSrcLen 1, cwcSrcPos 2, cwc 1, '1'
        IWordSink::PutWord: cwcSrcLen 1, cwcSrcPos 2, cwc 3, 'NN1'
        IWordSink::PutAltWord: cwcSrcLen 4, cwcSrcPos 4, cwc 4, '4322'
        IWordSink::PutWord: cwcSrcLen 4, cwcSrcPos 4, cwc 6, 'NN4322'
        IWordSink::PutAltWord: cwcSrcLen 3, cwcSrcPos 9, cwc 3, '910'
        IWordSink::PutWord: cwcSrcLen 3, cwcSrcPos 9, cwc 5, 'NN910'

For additional information about the Language Resource Test tool and other unsupported tools that are included with SharePoint Portal Server 2003, click the following article number to view the article in the Microsoft Knowledge Base:

830316 Contents of the SharePoint Portal Server 2003 ToolsHowTo.txt file


Modification Type:MajorLast Reviewed:1/14/2005
Keywords:kbCommandLine kbhowto kbinfo KB890613 kbAudITPRO