home *** CD-ROM | disk | FTP | other *** search
/ The Developer Connection…ice Driver Kit for OS/2 3 / DEV3-D1.ISO / prodtool / sm2 / ehsa7mst.inf (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1993-08-30  |  536.9 KB  |  4,890 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Version Notice ΓòÉΓòÉΓòÉ
  3.  
  4. First Edition, September 1993 
  5.  
  6. This edition applies to Version 1 of: 
  7.  
  8. SearchManager/2 (5622-018) 
  9. SearchManager LAN Server/2 and Client/2 (5621-404) 
  10. and to all subsequent releases and modifications until otherwise indicated in 
  11. new editions or technical newsletters. 
  12.  
  13. Order publications through your IBM representative or the IBM branch office 
  14. serving your locality. Publications are not stocked at the address below. 
  15.  
  16. IBM welcomes your comments. A form for readers' comments may be provided at the 
  17. back of this publication, or you may address your comments to the following 
  18. address: 
  19.  
  20. IBM Deutschland Entwicklung GmbH 
  21. Information Development, Dept. 0446 
  22. Postfach 1380 
  23. 71003 Boeblingen 
  24. Germany 
  25.  
  26. When you send information to IBM, you grant IBM a nonexclusive right to use or 
  27. distribute the information in any way it believes appropriate without incurring 
  28. any obligation to you. 
  29.  
  30.  
  31. ΓòÉΓòÉΓòÉ 2. Notices ΓòÉΓòÉΓòÉ
  32.  
  33. References in this publication to IBM products, programs, or services do not 
  34. imply that IBM intends to make these available in all countries in which IBM 
  35. operates. Any reference to an IBM product, program, or service is not intended 
  36. to state or imply that only IBM's product, program, or service may be used. Any 
  37. functionally equivalent product, program, or service that does not infringe any 
  38. of IBM's intellectual property rights may be used instead of the IBM product, 
  39. program, or service. Evaluation and verification of operation in conjunction 
  40. with other products, except those expressly designated by IBM, is the user's 
  41. responsibility. 
  42.  
  43. IBM may have patents or pending patent applications covering subject matter in 
  44. this document. The furnishing of this document does not give you any license to 
  45. these patents. You can send license inquiries, in writing, to the IBM Director 
  46. of Commercial Relations, IBM Corporation, Purchase, NY 10577. 
  47.  
  48.  
  49. ΓòÉΓòÉΓòÉ 2.1. Trademarks and service marks ΓòÉΓòÉΓòÉ
  50.  
  51. The following terms, denoted by an asterisk (*) in this publication, are 
  52. trademarks of the IBM Corporation in the United States or other countries or 
  53. both: 
  54.  
  55. BookManager 
  56. DB2/2 
  57. IBM 
  58. Operating System/2 
  59. OS/2 
  60. Personal System/2 
  61. SearchManager/2 
  62. SearchManager LAN Server/2 and Client/2 
  63. SearchManager Client/DOS for Windows 
  64. Thesaurus End User System Toolkit/2. 
  65.  
  66. The following terms, denoted by a double asterisk (**) in this publication, are 
  67. trademarks of other companies: 
  68.  
  69. Ami Pro                  Samna Corporation 
  70. Intel                    Intel Corporation 
  71. Lotus Notes              Lotus Development Corporation 
  72. Microsoft                Microsoft Corporation 
  73. Microsoft Word           Microsoft Corporation 
  74. Novell                   Novell Inc. 
  75. NetWare                  Novell Inc. 
  76. Windows                  Microsoft Corporation 
  77. WordPerfect              WordPerfect Corporation. 
  78.  
  79.  
  80. ΓòÉΓòÉΓòÉ 3. Read this first ΓòÉΓòÉΓòÉ
  81.  
  82. This book introduces the IBM* licensed programs: 
  83.  
  84. o IBM SearchManager LAN Server/2 and Client/2* (5621-404) 
  85.  
  86. o IBM SearchManager/2* (5621-018). 
  87.  
  88. SearchManager LAN Server/2 and Client/2 is the client/server version of 
  89. SearchManager/2, for installation in a local area network (LAN). 
  90. SearchManager/2 is the single-workstation version [IBM licensed program IBM 
  91. SearchManager Client/DOS for Windows* (5622-079) is also available] . 
  92.  
  93. These SearchManager/2 products are information retrieval programs for the IBM 
  94. Operating System/2* (OS/2*). They let you search text documents without 
  95. requiring them to be structured in a particular way. Wherever there is need for 
  96. direct access to specific items in a large number of documents such as 
  97. articles, reports, contracts, laws, general directives, or abstracts of any 
  98. type of publication, SearchManager/2 can help you find and extract the relevant 
  99. documents. This applies to documents that are stored in the OS/2 file system, 
  100. or in a database, or in a library. 
  101.  
  102.  
  103. ΓòÉΓòÉΓòÉ 3.1. About this book ΓòÉΓòÉΓòÉ
  104.  
  105. You do not need previous knowledge of information-retrieval programs to work 
  106. with this book. Information is given for both novice and expert users. 
  107.  
  108. To install the SearchManager/2 products, read Installation. 
  109.  
  110. Before you can search for documents, they need to be indexed. This book is 
  111. written for two audiences: those who are interested in using SearchManager/2 to 
  112. search for information, and those who are concerned with indexing the 
  113. documents. 
  114.  
  115. To search for information, read: 
  116.  
  117. o Introducing IBM SearchManager/2. 
  118.  
  119. o Getting started, skipping the section that concerns indexing. 
  120.  
  121. o Searching for documents. 
  122.  
  123. o Working with found documents. 
  124.  
  125. To index documents, read: 
  126.  
  127. o Introducing IBM SearchManager/2. 
  128.  
  129. o Getting started. 
  130.  
  131. o Planning your document index. 
  132.  
  133. o Putting documents in the queue for indexing. 
  134.  
  135. o Administration. 
  136.  
  137. The linguistic feature of SearchManager/2 is one of the points that make it an 
  138. advanced product. SearchManager/2 uses this feature to make an "intelligent" 
  139. search for documents containing particular terms, and also in creating an 
  140. efficient document index. You can find information about this topic in 
  141. Linguistic processing. 
  142.  
  143. Thesaurus End User System Toolkit/2* (5622-081) is a separately available 
  144. product that you can install together with SearchManager/2. It provides access 
  145. to a thesaurus so that you can enrich your queries with additional search 
  146. terms. This is described in Thesaurus End User System Toolkit/2. 
  147.  
  148. Messages displayed by the SM2 command are explained in Messages displayed by 
  149. the SM2 command. 
  150.  
  151. If a problem should arise, you can find some useful hints and tips in 
  152. Troubleshooting. 
  153.  
  154.  
  155. ΓòÉΓòÉΓòÉ 3.2. Getting to know OS/2 ΓòÉΓòÉΓòÉ
  156.  
  157. Before you start working with SearchManager/2 you should be familiar with OS/2. 
  158. If you are not, refer to the OS/2 Start here object, and the introductory OS/2 
  159. Tutorial provided with the OS/2 Information object. 
  160.  
  161. You should be familiar with terms such as object, folder, pop-up menu, 
  162. pull-down menu, and window, and with working with a mouse. 
  163.  
  164.  
  165. ΓòÉΓòÉΓòÉ 3.3. Optional IBM licensed programs ΓòÉΓòÉΓòÉ
  166.  
  167. o IBM SearchManager Client/DOS for Windows (5622-079). SearchManager LAN 
  168.   Server/2 and Client/2 is intended for a client/server system in which the 
  169.   client and the server workstations are using the OS/2 operating systems. IBM 
  170.   SearchManager Client/DOS for Windows is for installation on a DOS client 
  171.   workstation to enable it to work with SearchManager LAN Server/2 installed on 
  172.   an OS/2 server workstation. 
  173.  
  174. o IBM Thesaurus End User System Toolkit/2 (5622-081) to use a thesaurus when 
  175.   you make a query. 
  176.  
  177. o IBM TCP/IP Version 1.2.1 for OS/2 (5798-RXW). If you are installing IBM 
  178.   SearchManager LAN Server/2 and Client/2, you can use this product for 
  179.   client/server communication, instead of OS/2 Named Pipes. 
  180.  
  181. o IBM DataBase 2 for OS/2 (DB2/2*) (5622-044). You can use this product to 
  182.   process the Library Services sample described in the manual IBM 
  183.   SearchManager/2: Programming Interfaces. 
  184.  
  185. o Language Dictionaries from the IBM Desktop Dictionary Series. 
  186.  
  187.   These dictionaries are available in European, Middle East, and African 
  188.   countries, order number 5604-356: 
  189.  
  190.    Danish                         Norwegian 
  191.    Dutch                          Portuguese 
  192.    French (National)              Spanish 
  193.    German                         Swedish 
  194.    Swiss German                   UK English 
  195.    Icelandic                      US English 
  196.    Italian 
  197.  
  198.   These dictionaries are available in USA, order number 5799-QBQ: 
  199.  
  200.    Danish                         Italian 
  201.    Dutch                          Norwegian 
  202.    French (National)              Portuguese 
  203.    French (Canadian)              Spanish 
  204.    German                         Swedish 
  205.  
  206.   Contact your IBM Branch Office or dealer to get information about the 
  207.   availability of the dictionaries in your country. Refer to Deciding which 
  208.   dictionaries to install. 
  209.  
  210.  
  211. ΓòÉΓòÉΓòÉ 4. Introducing IBM SearchManager/2 ΓòÉΓòÉΓòÉ
  212.  
  213. Increasing volumes of information are being handled each year, making it more 
  214. and more expensive and time-consuming to file and retrieve documents manually. 
  215. SearchManager/2 is designed to retrieve information that may be spread over 
  216. many and different kinds of documents like letters, notes, newspaper articles, 
  217. reports, contracts, and law books. In the following, the term "documents" is 
  218. used in this broad sense. 
  219.  
  220. The information that you need to find may have been stored in personal 
  221. documents, or in documents that are shared by a department or work group, or 
  222. even in enterprise-wide documents. 
  223.  
  224.  
  225. ΓòÉΓòÉΓòÉ 4.1. If you are new to retrieval ΓòÉΓòÉΓòÉ
  226.  
  227. Imagine that you work for a travel agency; the agency's contracts and 
  228. correspondence with customers are prepared using a word-processing program, 
  229. such as WordPerfect**, or Ami Pro**; internal correspondence is written in flat 
  230. ASCII files. 
  231.  
  232. Then assume that you need to search through these electronic documents to find 
  233. those that concern price increases. 
  234.  
  235. Using SearchManager/2, you specify a query consisting of two search terms price 
  236. and increase, linked by AND to indicate that you want to find documents that 
  237. contain both of these terms. 
  238.  
  239. SearchManager/2 searches and displays the names of the documents that match 
  240. your search criteria. You can then display any of these documents; the terms 
  241. that you searched for are highlighted. 
  242.  
  243. This is retrieval in its simplest form; but it applies to environments ranging 
  244. from, say, a freelance translator working at a single workstation, using only 
  245. one document type, to a large company whose employees use workstations 
  246. connected to a complex local area network, and whose documents are in many 
  247. different formats and are stored at many different workstations. 
  248.  
  249. Using a query to search for text in many documents 
  250.  
  251. SearchManager / 
  252. 2canrapidlyretrieverelevantinformationfromlargecollectionsofdocuments 
  253. ,usingcombinationsofwordsassearchterms .
  254.  
  255. Unlike database-management systems, SearchManager/2 does not require that data 
  256. be rigorously structured into interrelated files, records, and fields, before 
  257. it can be accessed. Instead, SearchManager/2 operates by building a 
  258. comprehensive index of significant words or terms that appear in a collection 
  259. of documents. Any combination of these terms can then be used to find the 
  260. documents that contain them. 
  261.  
  262. SearchManager/2 features high-performance indexing and retrieval. It can access 
  263. word-processing documents in their original native form, and offers a rich set 
  264. of retrieval capabilities including word, phrase, "wild-card", and proximity 
  265. searching using full Boolean logic. 
  266.  
  267.  
  268. ΓòÉΓòÉΓòÉ 4.2. Local area network or single workstation? ΓòÉΓòÉΓòÉ
  269.  
  270. There are two SearchManager/2 products: IBM SearchManager LAN Server/2 and 
  271. Client/2, and IBM SearchManager/2. SearchManager LAN Server/2 and Client/2 is 
  272. intended for use in local area networks. 
  273.  
  274. Finding documents using SearchManager LAN Server/2 and Client/2 
  275.  
  276. There is also a need to find information stored on a personal "stand-alone" 
  277. workstation. This is the area for which the SearchManager/2 single-workstation 
  278. version is designed. 
  279.  
  280. Finding documents using SearchManager/2 single workstation 
  281.  
  282.  
  283. ΓòÉΓòÉΓòÉ 5. Getting started ΓòÉΓòÉΓòÉ
  284.  
  285. If you are in a hurry to get started, follow the steps in this chapter; it will 
  286. help you to become familiar with SearchManager/2 quickly. More detailed 
  287. information about each step is given elsewhere in this book. 
  288.  
  289. After a brief introduction to the help system, this chapter takes you through 
  290. indexing some sample documents and then through a simple search scenario, where 
  291. you locate and then display a found document. 
  292.  
  293.      Tip If you want to get to the section on searching for documents right 
  294.      away, turn to Making your first search. Be sure, though, that documents 
  295.      have already been indexed. 
  296.  
  297.  
  298. ΓòÉΓòÉΓòÉ 5.1. Getting help when you need it ΓòÉΓòÉΓòÉ
  299.  
  300. SearchManager/2 has an extensive Help facility. 
  301.  
  302. The information line in each window: At the bottom of each window, permanently 
  303. displayed, there is a one-line information area that tells you about the field 
  304. at the current cursor position. 
  305.  
  306. Getting more help for a field: If you need more information than is shown in 
  307. the information area: 
  308.  
  309.  o Select the field for which you need information 
  310.  o Press F1, or select the Help push button. 
  311.  
  312.  A help window is displayed giving you detailed information about the field at 
  313.  the current cursor position. 
  314.  
  315.  Getting help for a window: To display help information about a particular 
  316.  window, rather than about a particular field, from any Help window you can 
  317.  press F2. 
  318.  
  319.  Other ways of getting help: Whenever you are working with a window that has a 
  320.  menu bar, select the Help choice to display the various types of help you can 
  321.  get. Simply click on each of them in turn to find out what each of them 
  322.  offers. 
  323.  
  324.  If the window does not have a menu bar, press the Help push button, or select 
  325.  Help from the system-menu symbol - the icon in the top left-hand corner of the 
  326.  window. 
  327.  
  328.  Getting more details about messages: While you are working with 
  329.  SearchManager/2, information messages are occasionally displayed. If you need 
  330.  more information about the message, select Help on the message window. 
  331.  
  332.  Moving easily through the help system: Help windows contain words that are 
  333.  highlighted in a different color. If you double-click on any of these words, a 
  334.  new help window is displayed that provides information about the highlighted 
  335.  words. 
  336.  
  337.  Viewing the online documentation: 
  338.  
  339.      Tip If this online book covers important parts of your screen, resize its 
  340.      window. The text is automatically reflowed within the new window size. 
  341.  
  342.  
  343. ΓòÉΓòÉΓòÉ 5.2. A brief look at the indexing process ΓòÉΓòÉΓòÉ
  344.  
  345. In this section, you: 
  346.  
  347.   1. Open the SearchManager/2 folder 
  348.  
  349.   2. Place the sample documents in the queue for indexing 
  350.  
  351.   3. Index the sample documents. 
  352.  
  353.  If you are working with a client/server system, the sample documents are 
  354.  installed at the server workstation. You must have access to these documents. 
  355.  
  356.  
  357. ΓòÉΓòÉΓòÉ 5.2.1. Open the SearchManager/2 folder ΓòÉΓòÉΓòÉ
  358.  
  359. The SearchManager/2 folder is an object on the OS/2 Workplace Shell desktop. 
  360.  
  361.   1. Double-click on the SearchManager/2 object. 
  362.  
  363.  Figure: The SearchManager/2 folder 
  364.  
  365.  The SearchManager/2 folder contains the following objects: 
  366.  
  367.  o A Search service object; this does the indexing and retrieval. 
  368.  
  369.  o A Retrieval and Indexing object; this is an online version of this manual. 
  370.  
  371.  o An Installation Utility object to assist you in installing components of 
  372.    SearchManager/2. 
  373.  
  374.  
  375. ΓòÉΓòÉΓòÉ 5.2.2. Place the sample documents in the queue for indexing ΓòÉΓòÉΓòÉ
  376.  
  377. The names of any documents that you want to have indexed must be placed in the 
  378. document queue. To do this: 
  379.  
  380.   1. Open the Search service folder to display the Document index object, the 
  381.      Sample documents folder, and a Query object. 
  382.  
  383.      Figure: The Search service folder 
  384.  
  385.      Sampledocumentsareprovidedfortestpurposes ;theyareinaSampledocumentsfolder 
  386.      .( Inaclient / serversystem 
  387.      ,thesampledocumentsareinstalledonlyattheserverworkstation . )
  388.  
  389.   2. Use the mouse to drag the Sample documents folder and drop it onto the 
  390.      document index object. The Add to Queue window opens. 
  391.  
  392.   3. Select Queue in the Add to Queue window. 
  393.  
  394.  The names of the sample documents are now in a queue, ready to be indexed. A 
  395.  queue is used because indexing uses a lot of processing power, and is 
  396.  typically done at a time when the workstation is not very busy. 
  397.  
  398.  
  399. ΓòÉΓòÉΓòÉ 5.2.3. Index the sample documents ΓòÉΓòÉΓòÉ
  400.  
  401. (If you are working with a client/server system, the system administrator does 
  402. this step.) 
  403.  
  404. To confirm that the document names are in the queue: 
  405.  
  406.   1. On the index object, click the right-hand mouse button to display its 
  407.      pop-up menu. 
  408.  
  409.   2. Select Administration. 
  410.  
  411.  The Administration notebook shows how many documents there are in the queue. 
  412.  To index these: 
  413.  
  414.   1. Click on the Index push button. 
  415.  
  416.   2. Click on OK in the Confirmation window. 
  417.  
  418.   3. After half a minute or so, click on the Refresh push button to see if 
  419.      indexing has finished. Repeat this until the number of documents in the 
  420.      queue becomes zero. 
  421.  
  422.  The Administration notebook now indicates how many documents there are in the 
  423.  index. The first time you index any documents, the indexed terms are placed in 
  424.  the Primary part of the document index. Therafter, the Secondary part is used. 
  425.  
  426.  o Close the Administration notebook (select Close from the system-menu symbol, 
  427.    or double-click on it). 
  428.  
  429.  
  430. ΓòÉΓòÉΓòÉ 5.3. Making your first search ΓòÉΓòÉΓòÉ
  431.  
  432. This section assumes that the previous step, indexing documents, has already 
  433. been done. 
  434.  
  435. In this section, you: 
  436.  
  437.  o Use a query object to search for documents 
  438.  o Browse one of the found documents 
  439.  o Close the query. 
  440.  
  441.  
  442. ΓòÉΓòÉΓòÉ 5.3.1. Search for documents ΓòÉΓòÉΓòÉ
  443.  
  444. Figure: A query object contains the query and the results 
  445.  
  446. Here you search for documents containing the terms cat and mouse: 
  447.  
  448.   1. Open the Query object provided in the Search service folder. The Query 
  449.      View notebook is displayed. 
  450.  
  451.   2. In the first Search terms field, type cat. 
  452.  
  453.   3. In the Operator field, click on the drop-down button to display the list 
  454.      of operators. 
  455.  
  456.   4. Select the AND operator. 
  457.  
  458.   5. In the second Search terms field, type mouse. 
  459.  
  460.   6. Select the Search push button to run the query. 
  461.  
  462.  Figure: The Query View notebook 
  463.  
  464.  The documents that contain both of these search terms are shown in the Results 
  465.  View window. If your document index contains only the sample documents, then 
  466.  only one document is found. 
  467.  
  468.  
  469. ΓòÉΓòÉΓòÉ 5.3.2. Browse the found document ΓòÉΓòÉΓòÉ
  470.  
  471.   1. Double-click on the found document object to open it and to display the 
  472.      text of the document. 
  473.  
  474.   2. In the Browser window select Next match to find the first occurrence of 
  475.      the search terms. The search terms are highlighted. 
  476.  
  477.  Figure: Browsing a document 
  478.  
  479.  
  480. ΓòÉΓòÉΓòÉ 5.3.3. Close the query ΓòÉΓòÉΓòÉ
  481.  
  482.   1. Close the Browser window. 
  483.  
  484.   2. Close the Results View of the query object. 
  485.  
  486.   3. Close the Query View of the query object. 
  487.  
  488.  The two views of a query object, the Query View and the Results View, are 
  489.  available from the object's pop-up menu as shown in the figure in Search for 
  490.  documents. From here, you can also copy the query or create another. 
  491.  
  492.  
  493. ΓòÉΓòÉΓòÉ 6. Planning your document index ΓòÉΓòÉΓòÉ
  494.  
  495. This chapter helps you to plan before you index documents for the first time. 
  496. It explains: 
  497.  
  498.  o Why documents need to be indexed 
  499.  o Which document types you can index 
  500.  o Which document libraries and file systems you can use 
  501.  o How to decide which type of index to use. 
  502.  
  503.  
  504. ΓòÉΓòÉΓòÉ 6.1. Why documents need to be indexed ΓòÉΓòÉΓòÉ
  505.  
  506. A fast information retrieval system does not sequentially scan through 
  507. documents; this would take too long. Instead, it operates on a previously built 
  508. document index. You can think of a document index as consisting of terms 
  509. extracted from the documents, stored together with the document names. 
  510.  
  511. The retrieval system searches through the index for the terms requested, and 
  512. finds the names of the documents containing those terms. 
  513.  
  514. Figure: Rapid retrieval by indexing only meaningful terms 
  515.  
  516. Before starting to search for and retrieve information, you must create an 
  517. index from the documents to be processed. Because indexing can be a lengthy 
  518. process, it is done in two steps: 
  519.  
  520.   1. First, you place the names of the documents to be indexed in the document 
  521.      queue. 
  522.  
  523.   2. Then, usually when the workstation is not busy with other activites, you 
  524.      index the documents listed in the queue. 
  525.  
  526.  Figure: Indexing is a two-step process 
  527.  
  528.  A document index contains only relevant information; insignificant information 
  529.  (stop words), like conjunctions and prepositions are not indexed. 
  530.  SearchManager/2 uses a list of these stop words to prevent them from being 
  531.  indexed. 
  532.  
  533.  
  534. ΓòÉΓòÉΓòÉ 6.2. Document types that can be indexed ΓòÉΓòÉΓòÉ
  535.  
  536. Here is a list of the types of documents that you can index: 
  537.  
  538.  o Flat ASCII 
  539.  o Ami Pro Architecture Version 4 
  540.  o IBM Final Form Text (FFT): Document Content Architecture 
  541.  o IBM Revisable Form Text (RFT): Document Content Architecture 
  542.  o IBM SearchManager/2 Text format (for more information, see IBM 
  543.    SearchManager/2: Programming Interfaces) 
  544.  o Microsoft** Rich Text Format (RTF), Version 1 
  545.  o WordPerfect (OS/2 and Windows**), Versions 5.0, 5.1, and 5.2 
  546.  o Microsoft Word**, Versions 5.0 and 5.5 
  547.  o Microsoft Word for Windows, Versions 1.0, 1.1, and 2.0 
  548.  o IBM SearchManager/370 Editable Condensed Text Format (ECTF); each document 
  549.    must be specified in CCSID 4946 (code page 850) as a separate OS/2 file. 
  550.  
  551.  When indexing a document from the OS/2 file system, SearchManager/2 can detect 
  552.  its type automatically. But SearchManager/2 also needs to know what language 
  553.  the document is written in, and its Coded Character Set Identifier (CCSID). 
  554.  For this, SearchManager/2 uses information that you specify in the Rules 
  555.  section of the index Administration notebook. See Defining indexing rules for 
  556.  OS/2 document types. 
  557.  
  558.  When SearchManager/2 indexes documents from a Lotus Notes** library system, 
  559.  these can be in plain text or in RTF format. If they are in RTF format, 
  560.  SearchManager/2 extracts plain text from them. 
  561.  
  562.  
  563. ΓòÉΓòÉΓòÉ 6.3. Libraries and file systems ΓòÉΓòÉΓòÉ
  564.  
  565. Using SearchManager/2, you can index and search for documents in: 
  566.  
  567.  o The OS/2 file system 
  568.  
  569.  o Lotus Notes Version 3 
  570.  
  571.  o Other text libraries or applications, using the user exit library services 
  572.    described in IBM SearchManager/2: Programming Interfaces. 
  573.  
  574.    Note:  The names of documents or document groups differ depending on the 
  575.    library used. When using a library other than the OS/2 file system, only 
  576.    Browse and Add to queue are available for documents contained in a result. 
  577.  
  578.  o Databases, such as the IBM Database 2 for OS/2, supported by the library 
  579.    services sample. 
  580.  
  581.  The examples in this book refer to the OS/2 file system. 
  582.  
  583.      Tip For each file system or library system, a separate SearchManager LAN 
  584.      Server/2 installation is required. Each has to be installed on a separate 
  585.      server. 
  586.  
  587.  
  588. ΓòÉΓòÉΓòÉ 6.4. Deciding which type of document index to use ΓòÉΓòÉΓòÉ
  589.  
  590. You can choose one of three index types: 
  591.  
  592.  o Linguistic 
  593.  o Precise 
  594.  o Dual. 
  595.  
  596.  This section summarizes the index types. If you need a more detailed 
  597.  description of how each type affects linguistic processing in SearchManager/2, 
  598.  read Linguistic processing. Specifying properties for the document index 
  599.  describes how you can specify which index type you want to have. 
  600.  
  601.      Tip Choosing an index type is a critical decision for an administrator; 
  602.      changing to or from a linguistic index type involves clearing the index 
  603.      and indexing all documents again. 
  604.  
  605.  
  606. ΓòÉΓòÉΓòÉ 6.4.1. Linguistic index ΓòÉΓòÉΓòÉ
  607.  
  608. If you choose to create a linguistic index, then, during indexing, linguistic 
  609. processing is applied while analyzing the documents' text. 
  610.  
  611. For a query, SearchManager/2 then applies the same linguistic processing to the 
  612. search terms before searching in the document index. The result is that any 
  613. form of a search term matches any other form occurring in one of the indexed 
  614. documents. 
  615.  
  616. For example, the search term mouse matches the document terms mouse, mice, MICE 
  617. (capital letters), and so on. Similarly, the search term Mice matches the same 
  618. document terms. 
  619.  
  620. The advantage of this type of index is that more documents are likely to be 
  621. found (increased "recall"). 
  622.  
  623. This index type requires the least amount of disk space. However, indexing and 
  624. searching may take longer than for the precise index. 
  625.  
  626. The linguistic processing used to index documents for a linguistic index are: 
  627.  
  628.  o Word and sentence separation. 
  629.  
  630.  o Changing terms to a standard form, in which there are no capital letters, 
  631.    and accented letters like ╨æ are changed to a form without accents 
  632.    ("normalization"). For example, Gr╨æ╤üe is indexed as gruesse. 
  633.  
  634.  o Reducing terms to their base form ("lemmatization"). For example, bought is 
  635.    indexed as buy, mice as mouse. 
  636.  
  637.  o Word decomposition, where compound words like the German Wetterbericht 
  638.    (weather report) are indexed not only as wetterbericht, but also as wetter 
  639.    and bericht. 
  640.  
  641.  o Stop-word filtering in which only the relevant terms are extracted for 
  642.    indexing. A report about all animals is indexed as report and animal. 
  643.  
  644.  o Part-of-speech filtering, which is similar to stop-word filtering; only 
  645.    nouns, verbs, and adjectives are indexed. I drive my car quickly is indexed 
  646.    as drive and car. The words I and my are removed as stop words, but 
  647.    additionally the word quickly is removed. 
  648.  
  649.  The first two of these linguistic processes, that is, word and sentence 
  650.  separation, and normalization, are possible without having dictionaries 
  651.  installed. 
  652.  
  653.      Tip Even word fragments (words masked with global characters) are compared 
  654.      to the base forms in the index. For example, a document containing the 
  655.      text 
  656.  
  657.              I swum
  658.  
  659.      being searched for all words beginning with 
  660.  
  661.              swu
  662.  
  663.      using the word fragment 
  664.  
  665.              swu*
  666.  
  667.      is not found, because the index contains only the term 
  668.  
  669.              swim
  670.  
  671.      So the query should be 
  672.  
  673.              swi*
  674.  
  675.      instead. 
  676.  
  677.  The table in Linguistic processing for indexing summarizes how terms are 
  678.  extracted for indexing when you are using a linguistic index. 
  679.  
  680.  
  681. ΓòÉΓòÉΓòÉ 6.4.2. Precise index ΓòÉΓòÉΓòÉ
  682.  
  683. In a precise index, linguistic processes are used only to determine word and 
  684. sentence boundaries. The terms in the documents are indexed in exactly the same 
  685. form as they occur in the document. 
  686.  
  687. For example, the search term mouse matches only the document term mouse and 
  688. not, for example, MICE. 
  689.  
  690. The advantage of this type of index is that the search is more precise (reduced 
  691. recall); also indexing and retrieval is faster. Since each different form and 
  692. spelling of every term is indexed, more disk space is needed. 
  693.  
  694. The linguistic processes used to index documents for a precise index are: 
  695.  
  696.  o Word and sentence separation 
  697.  o Sentence-begin processing 
  698.  o Stop-word filtering. 
  699.  
  700.  These are explained in Linguistic index,and you can find more details in 
  701.  Linguistic processing. Linguistic processing for indexing gives some examples 
  702.  of how terms are extracted from document text for indexing when you are using 
  703.  a precise index. 
  704.  
  705.  In a query, the same processing is applied to the query terms, which are then 
  706.  compared with the terms found in the index. 
  707.  
  708.  This means that only the same form or inflection of a search term is found. 
  709.  Generally, the search in a precise index is case sensitive. 
  710.  
  711.  
  712. ΓòÉΓòÉΓòÉ 6.4.3. Dual index ΓòÉΓòÉΓòÉ
  713.  
  714. The dual index is a precise index with linguistic support. This is the most 
  715. flexible index type, because it allows you to decide for each search term 
  716. whether to search linguistically or precisely. 
  717.  
  718. This index type needs the most disk space, however, and indexing and searching 
  719. are slower than for a linguistic index. 
  720.  
  721. A dual index contains the normalized form (standard form in lowercase letters, 
  722. and without accents), the lemmatized form (base form, such as the infinitives 
  723. of verbs), and the original form of each term. 
  724.  
  725. In a query, you can choose the processing that is applied to the query terms: 
  726.  
  727.  o Linguistic search (Inflected forms option selected); any form and any case 
  728.    matches any other form and any other case. 
  729.  
  730.  o Precise search (Inflected forms not selected); only the exact form and exact 
  731.    case matches are searched for. 
  732.  In a dual index, word fragments are always looked for precisely; matching for 
  733.  word fragments is case sensitive. 
  734.  
  735.  
  736. ΓòÉΓòÉΓòÉ 7. Putting documents in the queue for indexing ΓòÉΓòÉΓòÉ
  737.  
  738. Indexing is a two-step process. The first step is to put the names of the 
  739. documents to be indexed into a queue; this is covered in this chapter. The 
  740. second step, often done later, is to index those documents named in the queue. 
  741.  
  742. Removing terms from an index follows the same two-step process. You would do 
  743. this when, for example, you intend to delete documents from your library. 
  744.  
  745. The concept of indexing is described in Why documents need to be indexed, and 
  746. how to do it is described in Administration. 
  747.  
  748. You can place individual documents or document groups (folders) in the document 
  749. queue for indexing. There are several ways to do this: 
  750.  
  751.  o By double-clicking on the index object 
  752.  o By dragging folders or individual documents to the index object 
  753.  o By using the pop-up menu of documents in a result 
  754.  o Automatically, by having documents indexed periodically. 
  755.  
  756.  In each case, you can choose whether to have the documents' terms added to the 
  757.  index (Add), or, if the documents have already been indexed, to have the 
  758.  documents' terms removed from the index (Remove). 
  759.  
  760.  The final section in this chapter describes queuing Lotus Notes databases. 
  761.  
  762.      Tip If you are using a client/server system, be sure that the client and 
  763.      the server workstations have access to documents marked for indexing. 
  764.  
  765.  
  766. ΓòÉΓòÉΓòÉ 7.1. Queuing by double-clicking on the index object ΓòÉΓòÉΓòÉ
  767.  
  768. The first method of queuing documents is to double-click on the Index object to 
  769. display the Add to queue window. 
  770.  
  771. Then specify what is to be placed in the document queue by selecting the 
  772. document groups and their documents displayed on the Add to Queue window. 
  773. Double-click on a document group to display its subgroups. 
  774.  
  775. Figure: The Add to Queue window 
  776.  
  777.  
  778. ΓòÉΓòÉΓòÉ 7.2. Queuing by dragging folders or documents to the index object ΓòÉΓòÉΓòÉ
  779.  
  780. An alternative method of queuing documents is to select documents or document 
  781. groups, then use the mouse to drag them and drop them onto the Index object. 
  782.  
  783. The selected documents and the documents contained in the selected document 
  784. groups are then displayed in a document list on the Add to Queue window for 
  785. further processing. 
  786.  
  787.  
  788. ΓòÉΓòÉΓòÉ 7.3. Queuing using the pop-up menu of documents in a result ΓòÉΓòÉΓòÉ
  789.  
  790. On occasions, you may decide that a document that you have found by a search 
  791. needs to be indexed again, either because the indexed version is out of date, 
  792. or because you want the document's terms to be removed from the index. 
  793.  
  794. To place this document in the queue for indexing: 
  795.  
  796.  o In the Results View, select the Add to queue choice in the pop-up menu of 
  797.    the Document (described in Working with documents in the Result View). 
  798.  
  799.  
  800. ΓòÉΓòÉΓòÉ 7.4. Automatic queuing using periodic indexing ΓòÉΓòÉΓòÉ
  801.  
  802. The methods described so far are useful when you want to index particular 
  803. documents at a particular time. But periodic indexing is likely to be the 
  804. method you will use most. 
  805.  
  806. This method lets you forget about indexing; it happens automatically. Typically 
  807. the documents in which you want to search are located in document groups or 
  808. folders, and these documents are continually changing or being added to. 
  809.  
  810. Using periodic indexing, you simply specify which document groups you want to 
  811. have indexed, and at which intervals. At the required time, SearchManager/2 
  812. automatically places these document groups in the queue for indexing and 
  813. immediately afterwards indexes them. How to do this is described in Indexing 
  814. documents periodically. 
  815.  
  816.      Tip If you intend to index periodically, you should do it from the 
  817.      beginning, because the first time you index periodically, all the 
  818.      documents in a document group are indexed, even if they have been indexed 
  819.      before. 
  820.  
  821.  
  822. ΓòÉΓòÉΓòÉ 7.5. Queuing Lotus Notes databases ΓòÉΓòÉΓòÉ
  823.  
  824. To put Lotus Notes databases in the document queue for indexing, use the index 
  825. object as described in Queuing by double-clicking on the index object. In the 
  826. Add to Queue window, the Groups list shows servers, subdirectories, and 
  827. databases; the Documents list shows a list of symbolic document names 
  828. corresponding to the Lotus Notes naming convention. 
  829.  
  830. Lotus Notes documents are typically small, so it is not reasonable to index 
  831. them individually; select all the documents listed. 
  832.  
  833. You can also have these databases placed in the queue automatically. Indexing 
  834. documents periodically describes how to do this. 
  835.  
  836.  
  837. ΓòÉΓòÉΓòÉ 8. Administration ΓòÉΓòÉΓòÉ
  838.  
  839. Before you read this chapter, you should be familiar with Why documents need to 
  840. be indexed. This chapter describes how you can speed up indexing and retrieval; 
  841. it introduces the two parts of a document index and the concepts of Merge and 
  842. Cleanup. 
  843.  
  844. This chapter then covers the following index administration activities: 
  845.  
  846.  o Tailoring the document index: telling SearchManager/2 how to distinguish 
  847.    among various document types, specifying which stop-word list to use, and 
  848.    which type of index this is. 
  849.  
  850.  o Document index administration: indexing, merging, and cleaning up the index. 
  851.    These last two activities make indexing and retrieval faster, and reduce the 
  852.    amount of storage space needed by the index. 
  853.  
  854.  o Periodic document index administration: indexing, merging, and cleaning up 
  855.    the index automatically at intervals. 
  856.  
  857.  o Displaying and changing the status of SearchManager/2 activities. 
  858.  
  859.      Tip If you are working with SearchManager LAN Server/2 and Client/2, only 
  860.      the LAN administrator can work with the document index; you can do this at 
  861.      either a client or the server workstation. 
  862.  
  863.  The three index-administration activities that you do most are: 
  864.  
  865.  Indexing documents 
  866.  Merging the two parts of the document index 
  867.  Cleaning up the document index. 
  868.  
  869.      Tip Searching can still continue while these administration activities are 
  870.      being carried out. Administration is mostly concerned with maintaining the 
  871.  document index. In a client/server system, however, the administrator is also 
  872.  responsible for starting and stopping the search service, the part of 
  873.  SearchManager/2 that handles indexing and retrieval. 
  874.  
  875.  
  876. ΓòÉΓòÉΓòÉ 8.1. Starting and stopping a search service ΓòÉΓòÉΓòÉ
  877.  
  878. The SearchManager/2 search service usually starts automatically when you search 
  879. for documents or start any administration task. For this reason, your first 
  880. query, for example, may take a little longer than usual. However, if you are 
  881. working with a client/server system, the system administrator must start the 
  882. SearchManager/2 search service at the server workstation so that it can be used 
  883. by the client workstations. 
  884.  
  885.      Tip If you do administration periodically, then, to be sure that the 
  886.      search service is always started, start it automatically using either the 
  887.      STARTUP.CMD method, or the Startup folder method. 
  888.  
  889.  You start a search service, at the workstation on which it is installed, in 
  890.  one of the following ways: 
  891.  
  892.  o Using the Search service folder. To start the search service immediately, 
  893.    select Start on the pop-up menu of the Search service folder. 
  894.  
  895.  o Using the SM2 command. Start the search service in an OS/2 session by 
  896.    entering the command 
  897.  
  898.    sm2 start servicename 
  899.  
  900.    at the OS/2 prompt. 
  901.  
  902.    servicename is the name specified in the Definitions page of the search 
  903.    service object. 
  904.  
  905.  o Using the STARTUP.CMD file. To start the search service automatically at 
  906.    system startup, place the statement 
  907.  
  908.    sm2 start servicename 
  909.  
  910.    in the STARTUP.CMD batch file. 
  911.  
  912.  o Using the OS/2 Startup folder. An alternative way to start the search 
  913.    service automatically at system startup is to create a program object for 
  914.    SM2.EXE, having the parameters 
  915.  
  916.    start and servicename 
  917.  
  918.    Then place this object in the Startup folder of your OS/2 system. 
  919.  
  920.  Similarly, you can stop a search service in one of the following ways: 
  921.  
  922.  o Using the Search service folder. Select Stop on the pop-up menu of the 
  923.    Search service folder 
  924.  
  925.  o Using the SM2 command. In an OS/2 session, enter the command 
  926.  
  927.    sm2 stop servicename 
  928.  
  929.  
  930. ΓòÉΓòÉΓòÉ 8.1.1. Displaying the status of a search service ΓòÉΓòÉΓòÉ
  931.  
  932. To display the status of a search service, whether or not it is running, 
  933. display the pop-up menu of the Search service folder. If the Stop choice is 
  934. available, then the search service is running. If the Start choice is 
  935. available, then the search service is not running. 
  936.  
  937. Alternatively, you can enter the following OS/2 command: 
  938.  
  939. sm2 status servicename 
  940.  
  941.  
  942. ΓòÉΓòÉΓòÉ 8.2. Speeding up indexing and retrieval ΓòÉΓòÉΓòÉ
  943.  
  944. This section introduces the two parts of a document index, and describes how 
  945. merge and cleanup can keep the index tuned for maximum efficiency, and help you 
  946. to save disk space. 
  947.  
  948.  
  949. ΓòÉΓòÉΓòÉ 8.2.1. The two parts of an index ΓòÉΓòÉΓòÉ
  950.  
  951. A document index has a primary part and a secondary part; it is designed this 
  952. way to speed up indexing. During a search, SearchManager/2 looks in both parts 
  953. of the index to find a match. 
  954.  
  955. The way you handle these parts can affect how fast your documents are indexed 
  956. and how long a search takes. 
  957.  
  958. Figure: The two parts of a document index 
  959.  
  960.  
  961. ΓòÉΓòÉΓòÉ 8.2.2. Speeding up indexing ΓòÉΓòÉΓòÉ
  962.  
  963. Each time you index documents, the indexed terms are stored in the secondary 
  964. part of the document index. As the secondary part grows, indexing becomes less 
  965. efficient, so from time to time, you move (merge) the indexed terms from the 
  966. secondary part to the primary part. 
  967.  
  968. After a time, you have the situation shown in The two parts of an index where 
  969. the primary index has grown large and the secondary index remains small. 
  970. Indexing continues to be efficient. 
  971.  
  972. You can merge the secondary part into the primary part at irregular intervals 
  973. when you explicitly request it (see Merging the document index parts), or you 
  974. may find it more convenient to automatically merge the index parts periodically 
  975. (see Merging the index parts periodically). Whichever method you choose, you 
  976. should plan to merge frequently enough to prevent the secondary part of the 
  977. index reaching a size that significantly slows down indexing. 
  978.  
  979. When the primary index is relatively small, always aim to keep the secondary 
  980. part smaller than the primary part. As the primary index grows, you will gain 
  981. experience and will be able to judge for yourself when merging the indexes 
  982. significantly improves the speed of indexing. 
  983.  
  984.  
  985. ΓòÉΓòÉΓòÉ 8.2.3. Speeding up retrieval ΓòÉΓòÉΓòÉ
  986.  
  987. This section applies only if you are using the OS/2 file system. 
  988.  
  989. Before you delete a document from your library, you can add it to the document 
  990. queue to have its terms removed from the document index. 
  991.  
  992. But removing terms in this way is not always convenient; often it is easier to 
  993. clean up  the document index from time to time after the documents have been 
  994. deleted, removing those terms that belong to documents that you have deleted. 
  995. During cleanup SearchManager/2 checks for each term whether the document that 
  996. it belonged to still exists. If the document does not exist, SearchManager/2 
  997. removes the term from the index. (If the search service no longer has access to 
  998. a particular resource, and therefore cannot determine whether documents have 
  999. been deleted, cleanup is not done for those documents.) 
  1000.  
  1001. Cleanup reduces the size of your index making retrieval faster and, of course, 
  1002. saving disk space. 
  1003.  
  1004. You can clean up the index at irregular intervals when you explicitly request 
  1005. it (see Cleaning up the document index), or you can do it automatically (see 
  1006. Cleaning up periodically). 
  1007.  
  1008.  
  1009. ΓòÉΓòÉΓòÉ 8.3. Opening the Administration notebook ΓòÉΓòÉΓòÉ
  1010.  
  1011. To display the Administration notebook, select Administration in the pop-up 
  1012. menu of the Index object. 
  1013.  
  1014. Figure: The Administration notebook 
  1015.  
  1016.  
  1017. ΓòÉΓòÉΓòÉ 8.4. Tailoring the document index ΓòÉΓòÉΓòÉ
  1018.  
  1019. This section tells you how to specify: 
  1020.  
  1021.  o The rules that enable SearchManager/2 to distinguish among various types of 
  1022.    documents of the OS/2 file system and the language in which they are 
  1023.    written. 
  1024.  
  1025.  o The stop words used when indexing. 
  1026.  
  1027.  o The properties of the index, including the index type: precise, linguistic, 
  1028.    or dual. 
  1029.  
  1030.      Tip You should tailor the document index with care before you index any 
  1031.      documents. Once the document index contains terms, it can be difficult to 
  1032.      change these tailoring parameters without completely clearing the document 
  1033.      index first. 
  1034.  
  1035.  To tailor the document index: 
  1036.  
  1037.   1. Open the search service folder. 
  1038.  
  1039.   2. On the pop-up menu of the Index object, select Administration. 
  1040.  This displays the Administration notebook, which has sections for specifying 
  1041.  the indexing rules, stop words, and properties of the document index. 
  1042.  
  1043.  
  1044. ΓòÉΓòÉΓòÉ 8.4.1. Defining indexing rules for OS/2 document types ΓòÉΓòÉΓòÉ
  1045.  
  1046. When indexing an OS/2 document, SearchManager/2 needs to know: 
  1047.  
  1048.  o Which type of document it is; if it is a WordPerfect document, for example, 
  1049.    or a flat ASCII file. There is a list of document types that SearchManager/2 
  1050.    can work with in Document types that can be indexed. 
  1051.  
  1052.  o Which language is the document written in. 
  1053.  
  1054.  o Which Coded Character Set Identifier (CCSID) is used. 
  1055.  
  1056.  SearchManager/2 can detect most of the listed document types automatically. If 
  1057.  for some reason automatic recognition is not possible, then SearchManager/2 
  1058.  needs to refer to rules (or file-naming conventions) that you establish to 
  1059.  relate document types to file extensions. 
  1060.  
  1061.  For example, you could assign the extension .SAE to Ami Pro documents written 
  1062.  in English using the international CCSID 850, and you could assign the 
  1063.  extension .SAF to Ami Pro documents written in French using the same CCSID. 
  1064.  
  1065.  You establish these rules in the Rules section of the index Administration 
  1066.  notebook. 
  1067.  
  1068.      Tip These rules are also used to determine which documents are indexed 
  1069.      during periodic indexing (in addition to other parameters that you 
  1070.      specify). Establish these rules thoroughly before running periodic 
  1071.      indexing; this can prevent unwanted documents being indexed. 
  1072.  
  1073.  To define the indexing rules: 
  1074.  
  1075.  o Select the Rules section. 
  1076.  
  1077.  Figure: The Rules section 
  1078.  
  1079.  New rule: Here you can specify: 
  1080.  
  1081.  o Which files are not to be indexed, such as files with EXE or OBJ file 
  1082.    extensions. 
  1083.  
  1084.      Tip Many document extensions have already been set up. Check that these 
  1085.      match the extensions used by your documents and make any changes 
  1086.      necessary. 
  1087.  
  1088.  o Which language, format, and CCSID applies for the specified document type. 
  1089.    Here is a list of CCSIDs: 
  1090.  
  1091.     37        USA, Canada, and others 
  1092.     273       Austria, Germany 
  1093.     277       Denmark, Norway 
  1094.     278       Finland, Sweden 
  1095.     280       Italy 
  1096.     284       Spain, Latin America 
  1097.     285       United Kingdom 
  1098.     297       France 
  1099.     437       USA 
  1100.     500       International Latin-1 
  1101.     819       Latin-1 
  1102.     850       Latin-1 
  1103.     860       Portugal 
  1104.     861       Iceland 
  1105.     863       Canada 
  1106.     865       Denmark, Norway 
  1107.     871       Iceland 
  1108.     4946      Latin-1 (Codepage 850) 
  1109.  
  1110.  Default rule: Which format, language, and CCSID that SearchManager/2 is to 
  1111.  assume if the document extension is none of those specified. This format is 
  1112.  used only if SearchManager/2 cannot detect this automatically. 
  1113.  
  1114.      Tip If your documents are all the same type, are all in the same language, 
  1115.      and all use the same CCSID, specify only a default rule. But consider also 
  1116.      setting up rules to exclude programs and other files that are not 
  1117.      documents. 
  1118.  
  1119.  
  1120. ΓòÉΓòÉΓòÉ 8.4.2. Defining indexing rules for Lotus Notes ΓòÉΓòÉΓòÉ
  1121.  
  1122. For Lotus Notes documents, define only a default rule: 
  1123.  
  1124.  Format        ASCII. 
  1125.  Language      Set according to the installed version of Lotus Notes, or to the 
  1126.                language in which the documents are written. One language is 
  1127.                supported. 
  1128.  CCSID         850, the default for Lotus Notes. 
  1129.  
  1130.  
  1131. ΓòÉΓòÉΓòÉ 8.4.3. Specifying stop words for document indexing ΓòÉΓòÉΓòÉ
  1132.  
  1133. Stop words are irrelevant words that you do not want to store in the document 
  1134. index. This not only reduces the size of the index and reduces the time it 
  1135. takes to search through it, it can also increase the precision of your search. 
  1136. For more information, refer to Stop-word filtering. 
  1137.  
  1138. Each dictionary that you have installed for use with SearchManager/2 provides a 
  1139. list of stop words. But you can add stop words to and delete stop words from 
  1140. these lists. 
  1141.  
  1142. If you are using SearchManager LAN Server/2 and Client/2, you store and change 
  1143. the stop-word lists while you are working at the workstation on which the 
  1144. search service is installed; it cannot be done from a remote client. 
  1145.  
  1146. To select a stop word list, or to add and remove words in the list: 
  1147.  
  1148.  o Select the Stop words section of the Administration notebook. 
  1149.  
  1150.  o Select Language to choose which dictionary's stop-word list you want to work 
  1151.    with. 
  1152.  
  1153.  Figure: The Stop words section 
  1154.  
  1155.      Tip Consider extending the list of stop words with common words from your 
  1156.      business area that are likely to appear in many documents, but are 
  1157.      unlikely to be searched for. This reduces the size of your index, and 
  1158.      leads to faster searches. 
  1159.  
  1160.  Here are some points to consider if you add or remove stop words after some 
  1161.  documents have been indexed: 
  1162.  
  1163.  o When you add stop words, documents that have already been indexed behave 
  1164.    during a search like those that you index later using the changed stop-word 
  1165.    list. It is true that any occurrences of the new stop words will have been 
  1166.    indexed earlier, but the stop-word list now prevents these words from being 
  1167.    found. 
  1168.  
  1169.  o When you remove stop words, you should consider indexing all your documents 
  1170.    again. This is because documents that have already been indexed behave 
  1171.    differently during a search from those that you index later using the 
  1172.    changed stop-word list. The fact that stop words have been removed means 
  1173.    that now you can find these words in documents that you index thereafter. 
  1174.    But these words will not have been indexed for any documents that you 
  1175.    indexed before this time; so a search does not find them in those documents. 
  1176.  
  1177.  
  1178. ΓòÉΓòÉΓòÉ 8.4.4. Specifying properties for the document index ΓòÉΓòÉΓòÉ
  1179.  
  1180. These are the index properties: 
  1181.  
  1182.  o The index type: linguistic, precise, or dual 
  1183.  
  1184.  o The programs to use for the type of library system or file system you are 
  1185.    using. 
  1186.  
  1187.  To define the document index properties: 
  1188.  
  1189.  o Select the Properties section of the Administration notebook. 
  1190.  
  1191.  Figure: The Properties section 
  1192.  
  1193.  
  1194.  Index types 
  1195.  
  1196.  The index types are: linguistic, precise, and dual. These are described in 
  1197.  Deciding which type of document index to use. Here is a summary: 
  1198.  
  1199.  Linguistic index 
  1200.            Any inflected form of a search term matches any other inflected form 
  1201.            occurring in one of the indexed documents. For example, the search 
  1202.            term mouse matches the document terms mouse, mice, MICE, and so on. 
  1203.            The search term mice matches the same terms. 
  1204.  Precise index 
  1205.            The terms in the documents are indexed in exactly the same form as 
  1206.            they occur in the document. For example, the search term mouse 
  1207.            matches only the document term mouse and no other variations, like 
  1208.            Mouse. 
  1209.  Dual index 
  1210.            The dual index is a combination of the other two types. At the time 
  1211.            of making your search, you can choose whether you want 
  1212.            SearchManager/2 to search for inflected forms or not. 
  1213.  
  1214.  Changing the document index type: Once you have set the index type you can 
  1215.  change it, but when changing to or from a linguistic index type, the index 
  1216.  must first be cleared. 
  1217.  
  1218.  A change from precise to dual or the other way around can be done without 
  1219.  clearing the index. The change occurs the next time you merge the index parts. 
  1220.  
  1221.  Figure: Changing the index type 
  1222.  
  1223.  
  1224.  Library services 
  1225.  
  1226.  In the Library services field, you specify which interface programs are used 
  1227.  by SearchManager/2 to work with the library or file system you intend to use. 
  1228.  These programs are in the form of dynamic link libraries (DLLs). 
  1229.  
  1230.  When SearchManager/2 is first installed, these fields contain the names of the 
  1231.  DLLs for the OS/2 file system: 
  1232.  
  1233.   Client: EHSLSCFS
  1234.   Server: EHSLSSFS
  1235.  
  1236.  SearchManager/2 also provides library service DLLs which support Lotus Notes 
  1237.  Version 3. If you are using Lotus Notes, enter the following DLL names: 
  1238.  
  1239.   Client: EHSLSCLN
  1240.   Server: EHSLSSLN
  1241.  
  1242.  If you intend to use a different library system, however, you can write your 
  1243.  own DLLs. For details refer to the manual IBM SearchManager/2: Programming 
  1244.  Interfaces. 
  1245.  
  1246.  If you decide to change to a different library system, that is, if you change 
  1247.  the DLLs, clear the document index and then index the new library's documents. 
  1248.  
  1249.  For a server workstation: If you are setting up the library services as part 
  1250.  of the installation of SearchManager LAN Server/2 on a server workstation, any 
  1251.  subsequent clients that you install will automatically have the correct 
  1252.  Library services settings. Of course, if you are using your own library 
  1253.  services, you must install your client DLLs at the client workstations. 
  1254.  
  1255.  If, however, you have previously installed Client/2 on client workstations, a 
  1256.  message informs you that the Library service settings have changed, and they 
  1257.  are automatically updated the next time you use the search service, such as 
  1258.  when you make a query. 
  1259.  
  1260.  
  1261. ΓòÉΓòÉΓòÉ 8.5. Document index administration ("Explicit") ΓòÉΓòÉΓòÉ
  1262.  
  1263. You can index documents either at irregular intervals (that is, when you 
  1264. explicitly request it) or at regular intervals (periodically). 
  1265.  
  1266. To index documents immediately, select the Explicit section of the 
  1267. Administration notebook. 
  1268.  
  1269. Figure: The Explicit section 
  1270.  
  1271. This section shows the number of documents in the document queue and in the 
  1272. primary and secondary parts of the document index. The indicators below the 
  1273. number show the size of each relative to the largest. 
  1274.  
  1275.  
  1276. ΓòÉΓòÉΓòÉ 8.5.1. Adding and removing documents in the document index ΓòÉΓòÉΓòÉ
  1277.  
  1278. Select Index to process the documents named in the document queue; that is, to 
  1279. add their terms to the index, or to remove them, whichever you indicated when 
  1280. you placed the documents in the queue. 
  1281.  
  1282. If the Index push button is unavailable: 
  1283.  
  1284.  o The document queue is already empty 
  1285.  o Indexing is already running 
  1286.  o Indexing is locked 
  1287.  o Merge or cleanup is running. 
  1288.  
  1289.  Check the Status section of the Administration notebook for more information. 
  1290.  
  1291.  Occassionally, while SearchManager/2 is indexing documents, a merge occurs. 
  1292.  This can happen if the document queue is particularly large; indexing is 
  1293.  interrupted and a merge takes place, then indexing is resumed. 
  1294.  
  1295.  
  1296. ΓòÉΓòÉΓòÉ 8.5.2. Clearing the document queue ΓòÉΓòÉΓòÉ
  1297.  
  1298. Select Clear to empty the document queue. The documents are not indexed. 
  1299.  
  1300. You will probably not use Clear very often, but it can be useful while you are 
  1301. trying out the system after installation. 
  1302.  
  1303. If the Clear push button is unavailable: 
  1304.  
  1305.  o The document queue is already empty 
  1306.  o Indexing is running 
  1307.  o Cleanup is running. 
  1308.  
  1309.  Check the Status section of the Administration notebook for more information. 
  1310.  
  1311.  
  1312. ΓòÉΓòÉΓòÉ 8.5.3. Merging the document index parts ΓòÉΓòÉΓòÉ
  1313.  
  1314. Select Merge to merge the indexed terms contained in the secondary part of the 
  1315. document index with those in the primary part of the document index. (If you 
  1316. are not yet familiar with these terms, turn to Speeding up indexing.) The 
  1317. secondary part of the document index is then cleared. 
  1318.  
  1319. If the Merge push button is unavailable: 
  1320.  
  1321.  o The secondary part of the document index is empty 
  1322.  o Indexing, cleanup, or merge is running (or locked). 
  1323.  
  1324.  Check the Status section of the Administration notebook for more information. 
  1325.  
  1326.  
  1327. ΓòÉΓòÉΓòÉ 8.5.4. Cleaning up the document index ΓòÉΓòÉΓòÉ
  1328.  
  1329. This section applies only if you are using the OS/2 file system. 
  1330.  
  1331. Whenever you delete documents that have previously been indexed, you can remove 
  1332. their terms from the index: 
  1333.  
  1334.  o Before deleting the documents, by placing the documents' names for removal 
  1335.    in the document queue (see Putting documents in the queue for indexing) 
  1336.  
  1337.  o After deleting the documents, by using cleanup. 
  1338.  
  1339.  Select Cleanup to ensure that the document index contains only terms for 
  1340.  existing documents. When cleanup is finished, SearchManager/2 starts document 
  1341.  indexing, that is, it processes the documents in the queue. 
  1342.  
  1343.      Tip If you have temporarily archived or moved documents, and do not want 
  1344.      their indexed terms removed from the document index, do not do cleanup 
  1345.      until you have replaced the documents again. 
  1346.  
  1347.  If the Cleanup push button is unavailable: 
  1348.  
  1349.  o The document index is empty 
  1350.  o Indexing or merge is running 
  1351.  o Cleanup is already running 
  1352.  o The status of Add to queue is locked. 
  1353.  
  1354.  Check the Status section of the Administration notebook for more information. 
  1355.  
  1356.  
  1357. ΓòÉΓòÉΓòÉ 8.5.5. Clearing the document index ΓòÉΓòÉΓòÉ
  1358.  
  1359. Select Clear to remove all indexed terms from the primary and secondary parts 
  1360. of the document index. 
  1361.  
  1362.      Caution The only way to undo this action is to index all the documents 
  1363.      again. 
  1364.  
  1365.  Like Clear for the document queue, Clear for the index is a function that you 
  1366.  probably will not use very often, but it can be useful while you are trying 
  1367.  out the system after installation, or if you decide to change the index type. 
  1368.  
  1369.  If the Clear push button is unavailable: 
  1370.  
  1371.  o The document index is empty 
  1372.  o Indexing, merge, or cleanup is running. 
  1373.  
  1374.  Check the Status section of the Administration notebook for more information. 
  1375.  
  1376.  
  1377. ΓòÉΓòÉΓòÉ 8.6. Document index administration ("Periodic") ΓòÉΓòÉΓòÉ
  1378.  
  1379. Instead of manually carrying out the administration tasks Indexing, Merging, 
  1380. and Cleanup, you can use periodic administration to automate them so that they 
  1381. occur at regular intervals. 
  1382.  
  1383. This section describes: 
  1384.  
  1385.  o Starting and stopping periodic administration 
  1386.  o Indexing documents periodically 
  1387.  o Merging the index parts periodically 
  1388.  o Cleaning up periodically. 
  1389.  
  1390.  To do index administration periodically, select the Periodic section of the 
  1391.  administration notebook. 
  1392.  
  1393.  Figure: The Periodic administration section 
  1394.  
  1395.  
  1396. ΓòÉΓòÉΓòÉ 8.6.1. Starting and stopping periodic administration ΓòÉΓòÉΓòÉ
  1397.  
  1398. Periodic administration lets you do document indexing, index merging, and index 
  1399. cleanup, at specified intervals. You set up the three periodic administration 
  1400. tasks using the Index, Merge, and Cleanup pages of the Periodic section of the 
  1401. Administration notebook. 
  1402.  
  1403.      Tip Points to keep in mind: 
  1404.  
  1405.      o The three aspects of periodic administration (indexing, merge, and 
  1406.        cleanup) are active only if periodic administration has been started. 
  1407.  
  1408.      o The search service must be running at those times that you schedule 
  1409.        periodic administration to occur. (Consider starting the search service 
  1410.        automatically, and leaving it running during the periods that you have 
  1411.        set for administration to occur.) 
  1412.  
  1413.  To begin or end periodic administration: 
  1414.  
  1415.  o Select Start or Stop. 
  1416.  
  1417.  
  1418. ΓòÉΓòÉΓòÉ 8.6.2. When periodic administration is locked ΓòÉΓòÉΓòÉ
  1419.  
  1420. In the unlikely event that an error occurs during periodic administration, the 
  1421. Status field indicates that the administrative actions are locked. In this 
  1422. case, select Unlock to display information about why the action was stopped. 
  1423.  
  1424.  
  1425. ΓòÉΓòÉΓòÉ 8.6.3. Indexing documents periodically ΓòÉΓòÉΓòÉ
  1426.  
  1427. At the bottom of the notebook are the three subsections for periodic 
  1428. administration. Select the Indexing section to define periodic indexing. 
  1429.  
  1430. Figure: The Periodic indexing section 
  1431.  
  1432.      Tip You can define rules to prevent documents having a particular 
  1433.      extension, such as .EXE, being inadvertently indexed. See Defining 
  1434.      indexing rules for OS/2 document types. 
  1435.  
  1436.  Select whether to process the document queue or to process selected document 
  1437.  groups and the document queue. 
  1438.  
  1439.  o Document queue only 
  1440.  
  1441.    Specify the time interval and the maximum size for the document queue. As 
  1442.    soon as the specified time or queue size has been reached, the document 
  1443.    queue is processed; that is, indexing is started. 
  1444.  
  1445.    Use this choice if documents are added to the document queue at irregular 
  1446.    intervals rather than periodically. 
  1447.  
  1448.      Tip If you want to index documents at some time in the future, but only 
  1449.      once rather than periodically, specify the date and time, and then an 
  1450.      interval of zero, and a queue size of zero. 
  1451.  
  1452.  o Document groups 
  1453.  
  1454.    If you index documents periodically, you will find indexing document groups 
  1455.    more convenient than indexing individual documents. If you are continually 
  1456.    changing the content of documents in a particular document group, for 
  1457.    example, you can have that folder indexed periodically; you do not have to 
  1458.    remember to add the changed documents to the document queue. 
  1459.  
  1460.    Select Add to choose which document groups to process periodically. 
  1461.  
  1462.    You can specify the starting date, time, and the interval, for each document 
  1463.    group individually. 
  1464.  
  1465.      Tip As with indexing the document queue, if you specify only date and 
  1466.      time, and an interval of zero, periodic indexing is done only once, not 
  1467.      periodically. 
  1468.  
  1469.  To avoid unnecessary indexing, SearchManager/2 checks if the corresponding 
  1470.  document group contains documents that have been added, or if it contains 
  1471.  documents that have been updated since the last time this document group was 
  1472.  indexed. Only these documents are then added to the document queue for 
  1473.  indexing at the specified time. 
  1474.  
  1475.      Tip This check can be made only if you have previously done periodic 
  1476.      indexing of a particular document group. If you previously indexed 
  1477.      "explicitly", then all the documents in this group are indexed again. So 
  1478.      if you intend to index periodically, you should do it from the beginning. 
  1479.  
  1480.  As soon as the specified time is reached, the names of the new or changed 
  1481.  documents contained in the document groups are added to the document queue and 
  1482.  the queue is processed immediately. If there are other document names in the 
  1483.  queue, these documents are also processed. 
  1484.  
  1485.  If SearchManager/2 finds that there are no documents to add to the queue, that 
  1486.  is, no documents have been added to or changed in the document groups, any 
  1487.  documents that are already in the document queue are nevertheless indexed. 
  1488.  
  1489.  SearchManager/2 does not check if documents have been deleted from a document 
  1490.  group. To remove obsolete indexed terms of deleted documents, refer to 
  1491.  Cleaning up periodically. 
  1492.  
  1493.  
  1494. ΓòÉΓòÉΓòÉ 8.6.4. Merging the index parts periodically ΓòÉΓòÉΓòÉ
  1495.  
  1496. To define periodic merge, select the Periodic section of the Administration 
  1497. notebook, then, at the bottom, select the Merge subsection. 
  1498.  
  1499. Figure: The Periodic merge section 
  1500.  
  1501. Ifyouchoosetouseperiodicmerge 
  1502. ,youcanpreventtheindexpartsfrommergingwhenthereareinsufficienttermsinthesecondarypart 
  1503. .( Ifyouarenotyetfamiliarwiththepartsofthedocumentindex 
  1504. ,turntoSpeedingupindexing . )
  1505.  
  1506. The primary and secondary parts of the document index are merged only if the 
  1507. following prerequisites are both fulfilled: 
  1508.  
  1509.  o The time interval set for merging is reached. 
  1510.  
  1511.    Specify the starting date, time, and the interval at which you want merging 
  1512.    to be done. 
  1513.  
  1514.  o The size specified for the secondary part of the document index is reached. 
  1515.  
  1516.    Specify the size below which you want merging prevented. The merge process 
  1517.    starts only if the secondary part of the document index contains more 
  1518.    documents than specified. 
  1519.  
  1520.      Tip To merge the database parts only once (rather than periodically), at a 
  1521.      particular time in the future, set the interval and the number of 
  1522.      documents to zero. 
  1523.  
  1524.  
  1525. ΓòÉΓòÉΓòÉ 8.6.5. Cleaning up periodically ΓòÉΓòÉΓòÉ
  1526.  
  1527. This section applies only if you are using the OS/2 file system. 
  1528.  
  1529. Whenever documents are deleted from your library or file system, you should 
  1530. remove the indexed terms for these documents from the index; it improves the 
  1531. speed of retrieval and reduces the amount of storage space taken by the index. 
  1532.  
  1533. Cleanup checks if all indexed terms refer to existing documents. If there are 
  1534. indexed terms that do not refer to a document, these indexed terms are removed 
  1535. from the document index. In addition, cleanup starts document indexing by 
  1536. processing the documents in the document queue. 
  1537.  
  1538.      Tip If you have temporarily archived or moved documents, and do not want 
  1539.      their indexed terms removed, stop periodic cleanup until you have replaced 
  1540.      the documents again. 
  1541.  
  1542.  To define periodic cleanup, select the Periodic section of the Administration 
  1543.  notebook, then, at the bottom, select the Cleanup subsection. 
  1544.  
  1545.  Figure: The Periodic cleanup section 
  1546.  
  1547.  Specifythestartingdate ,time ,andtheintervalforperiodiccleanup 
  1548.  .Ifyouspecifyonlyadateandtime ,periodiccleanupisdoneonlyonce .
  1549.  
  1550.  
  1551. ΓòÉΓòÉΓòÉ 8.7. Displaying and changing status information ΓòÉΓòÉΓòÉ
  1552.  
  1553. Figure: The Status section 
  1554.  
  1555. To control the status of administration tasks, select the Statusc section of 
  1556. the Administration notebook. This section lets you control the following 
  1557. activities and display their status information: 
  1558.  
  1559.  o Searching 
  1560.  o Adding documents to queue 
  1561.  o Indexing 
  1562.  o Merge 
  1563.  o Cleanup. 
  1564.  
  1565.  If any of the Status fields indicates that the process is locked, then an 
  1566.  error has occurred. In this case, select Unlock to display information about 
  1567.  the error. 
  1568.  
  1569.  
  1570. ΓòÉΓòÉΓòÉ 8.7.1. Preventing searching ΓòÉΓòÉΓòÉ
  1571.  
  1572. Select Prevent to temporarily prevent users from searching for documents; for 
  1573. example, when you intend to clear the index. 
  1574.  
  1575. To allow searching to resume, select Permit. 
  1576.  
  1577.  
  1578. ΓòÉΓòÉΓòÉ 8.7.2. Preventing documents being added to the queue ΓòÉΓòÉΓòÉ
  1579.  
  1580. Select Prevent to temporarily prevent users from adding document names to the 
  1581. queue; for example, when you intend to clear the queue. 
  1582.  
  1583. To allow queuing to resume, select Permit. 
  1584.  
  1585.  
  1586. ΓòÉΓòÉΓòÉ 8.7.3. Monitoring the status of indexing ΓòÉΓòÉΓòÉ
  1587.  
  1588. Select Indexing to check the current status of indexing and when it was last 
  1589. done. 
  1590.  
  1591. The status can be Queuing, Running, Not running, or Locked. 
  1592.  
  1593.  
  1594. ΓòÉΓòÉΓòÉ 8.7.4. Monitoring the status of merge and cleanup ΓòÉΓòÉΓòÉ
  1595.  
  1596. Select Merge or Cleanup to check their current status and when it was last 
  1597. done. 
  1598.  
  1599. The status can be Running, Not running, or Locked. 
  1600.  
  1601.  
  1602. ΓòÉΓòÉΓòÉ 8.7.5. Processing indexing messages ΓòÉΓòÉΓòÉ
  1603.  
  1604. Indexing messages occur when, for example: 
  1605.  
  1606.  o Documents cannot be indexed 
  1607.  o Documents are indexed but a problem occurs 
  1608.  o A dictionary cannot be found. 
  1609.  
  1610.  The Indexing messages field shows the number of messages that occurred. 
  1611.  
  1612.  o Select Show to display the Indexing Messages window. This window lists 
  1613.    documents that could not be indexed. 
  1614.  
  1615.  o Select a document from this list to display the reason why the document 
  1616.    could not be indexed. 
  1617.  
  1618.  o Once you have read the reason, you can select Remove selected (or Remove 
  1619.    all) to remove that entry from the list. 
  1620.  
  1621.  
  1622. ΓòÉΓòÉΓòÉ 9. Searching for documents ΓòÉΓòÉΓòÉ
  1623.  
  1624. You search for documents by specifying which terms you want to look for. You 
  1625. specify these terms in a query. 
  1626.  
  1627. In SearchManager/2, each query is an object having two main views: 
  1628.  
  1629.  o A Query view: A notebook where you specify the search terms 
  1630.  
  1631.  o A Results view: A folder that contains the documents found by the query. 
  1632.  
  1633.  The steps in making a query are: 
  1634.  
  1635.   1. Open a search service folder 
  1636.   2. Create a query object 
  1637.   3. Open its query view 
  1638.   4. Type the search terms 
  1639.   5. Start the search. 
  1640.  
  1641.  This chapter describes these steps, including how to link search terms 
  1642.  together using operators, and how to enrich your search by using synonyms. It 
  1643.  also describes how you can restrict a search to selected folders in the OS/2 
  1644.  file system. 
  1645.  
  1646.  
  1647. ΓòÉΓòÉΓòÉ 9.1. Opening a search service folder ΓòÉΓòÉΓòÉ
  1648.  
  1649. When you initially open a Search service folder, it contains an index object 
  1650. and one query object. 
  1651.  
  1652. To open a search service folder: 
  1653.  
  1654.  o Double-click on the folder object. 
  1655.  
  1656.  The open Search service folder is shown in Place the sample documents in the 
  1657.  queue for indexing. 
  1658.  
  1659.  The following objects are typically contained in the Search service folder: 
  1660.  
  1661.  Object    Description 
  1662.  Index     Use the pop-up menu of the Index object to: 
  1663.  
  1664.     o Create a new query. 
  1665.  
  1666.     o Start administration. This choice is available only for the LAN 
  1667.       administrator and on a single-workstation system. 
  1668.  
  1669.     o Add documents to the document queue. 
  1670.  
  1671.  
  1672.  Query     Query objects are those in which you write a query's search text and 
  1673.            view the query's result. 
  1674.  
  1675.            In a client/server environment, you may be working with several 
  1676.            search services. If so, each query is associated with a particular 
  1677.            search service, so it makes sense to keep the query objects, 
  1678.            together with the index object, in the Search service folder. But 
  1679.            you can organize your query objects into other folders, if it is 
  1680.            more convenient for you. 
  1681.  
  1682.            Use the pop-up menu of the Query object to: 
  1683.  
  1684.     o Open a query to specify your search criteria 
  1685.  
  1686.     o View the result. 
  1687.  
  1688.  
  1689. ΓòÉΓòÉΓòÉ 9.2. Creating a query object ΓòÉΓòÉΓòÉ
  1690.  
  1691. When SearchManager/2 is first installed, a query object is provided in the 
  1692. Search service folder. To create additional Query objects, you can do one of 
  1693. the following: 
  1694.  
  1695.  o Select Create another or Copy from the query's pop-up menu 
  1696.  
  1697.  o Select New query from the pop-up menu of the Index object 
  1698.  
  1699.  o Drag a new query object from the New query template that SearchManager/2 has 
  1700.    placed in your OS/2 Templates folder. 
  1701.  
  1702.      Tip Create your own query "template". To do this: 
  1703.  
  1704.       1. Create a query object. 
  1705.  
  1706.       2. Set up its defaults (see Setting defaults for a query and Sorting the 
  1707.          results of a query). 
  1708.  
  1709.       3. In the General section of the query's Settings notebook, select 
  1710.          Template. 
  1711.  
  1712.       4. Close the Settings notebook. 
  1713.  
  1714.      You have now created a query template that you can use by dragging new 
  1715.      query objects from it. Each new query has the settings that you specified. 
  1716.  
  1717.      One useful setting is the sort sequence of the query's result. See Sorting 
  1718.      the results of a query. 
  1719.  
  1720.  
  1721. ΓòÉΓòÉΓòÉ 9.3. Searching ΓòÉΓòÉΓòÉ
  1722.  
  1723. (If you are working in a client/server system, you need to be logged on to the 
  1724. LAN before searching.) 
  1725.  
  1726. You make a query by entering your search text in a query notebook. 
  1727.  
  1728. To open a query notebook: 
  1729.  
  1730.  o Double-click on the Query object. 
  1731.  
  1732.  Figure: The Query section of the Query View notebook 
  1733.  
  1734.  Each query notebook has two sections: a Query section and a Defaults section. 
  1735.  The Query section is displayed when you open the notebook. To display the 
  1736.  Defaults section, select the Defaults tab at the bottom left-hand side of the 
  1737.  notebook. 
  1738.  
  1739.  
  1740. ΓòÉΓòÉΓòÉ 9.3.1. Specifying search terms ΓòÉΓòÉΓòÉ
  1741.  
  1742. You can specify the following information in the Search terms fields: 
  1743.  
  1744.  o A single word or a phrase, such as network 
  1745.  
  1746.  o Fragments of a word or phrase using global characters, like this: net* 
  1747.  Refer to Using global characters for more information. 
  1748.  
  1749.  
  1750. ΓòÉΓòÉΓòÉ 9.3.2. Selecting operators to link search terms ΓòÉΓòÉΓòÉ
  1751.  
  1752. Select operators to specify the relation between search terms. The operators 
  1753. are or, and, and not: . 
  1754.  
  1755.  or    Retrieves documents that contain either of the search terms specified. 
  1756.        For example: 
  1757.  
  1758.                    sugar
  1759.               or   salt
  1760.  
  1761.        looks for documents that contain either sugar or salt, or both. 
  1762.  and   Retrieves documents that contain both the search terms specified. For 
  1763.        example: 
  1764.  
  1765.                    sugar
  1766.               and  salt
  1767.  
  1768.        looks for documents that contain both sugar and salt. 
  1769.  not   Retrieves documents that contain the first search term, but not the 
  1770.        second. For example: 
  1771.  
  1772.                    sugar
  1773.               not  salt
  1774.  
  1775.        looks for documents that contain sugar, but leaves out documents that, 
  1776.        in addition, contain salt. 
  1777.  
  1778.  If you use more than one operator, SearchManager/2 processes the and and the 
  1779.  not operators first (in the sequence that they are given), and then it 
  1780.  processes the or operators. 
  1781.  
  1782.  For example: 
  1783.  
  1784.        price
  1785.   and  increase
  1786.   or   foreign
  1787.   and  airline
  1788.  
  1789.  looks for documents that contain both price and increase, and it also looks 
  1790.  for documents that contain both foreign and airline. It can be thought of like 
  1791.  this: 
  1792.  
  1793.   (price and increase) or (foreign and airline).
  1794.  
  1795.  
  1796. ΓòÉΓòÉΓòÉ 9.3.3. Using global characters ΓòÉΓòÉΓòÉ
  1797.  
  1798. Global characters, otherwise known as "wild-card" characters, offer a simple 
  1799. way to make a search more flexible. They increase "recall", the number of 
  1800. documents found by a search. 
  1801.  
  1802. To set the default global characters for all queries, select Defaults in the 
  1803. pop-up menu of the SearchManager/2 folder. Any queries created subsequently 
  1804. from the Index object have the specified default global characters. Existing 
  1805. queries remain unchanged. 
  1806.  
  1807. To change the global characters for one query, use the Defaults section of its 
  1808. Query View notebook. 
  1809.  
  1810. These are the global characters provided when SearchManager/2 is first 
  1811. installed. . 
  1812.  
  1813.  *  An asterisk represents optional characters at the front, middle, or end of 
  1814.     a search term. Here is an example of an asterisk at the front of a word: 
  1815.  
  1816.         *text
  1817.  
  1818.     finds documents containing: 
  1819.  
  1820.         text
  1821.         context
  1822.         hypertext
  1823.         teletext
  1824.  
  1825.     An asterisk can also represent a whole word: 
  1826.  
  1827.         annual * report
  1828.  
  1829.     finds documents containing: 
  1830.  
  1831.         annual budget report
  1832.         annual sales report
  1833.         annual report
  1834.  
  1835.  ?  A question mark represents exactly one character in a search term: 
  1836.  
  1837.         M?ll?r
  1838.  
  1839.     finds documents containing: 
  1840.  
  1841.         Miller
  1842.         Myller
  1843.         Millar
  1844.  
  1845.     The question mark cannot represent a blank, nor can it stand alone to 
  1846.     represent a single-character word. For example: 
  1847.  
  1848.         m?ll?
  1849.  
  1850.     does not find documents containing: 
  1851.  
  1852.         mill
  1853.  
  1854.  
  1855. ΓòÉΓòÉΓòÉ 9.3.4. Searching for terms in any sequence ΓòÉΓòÉΓòÉ
  1856.  
  1857. If you are using a precise index, SearchManager/2 searches for the terms in the 
  1858. sequence that you type them. 
  1859.  
  1860. If you are using a linguistic or a dual index however, you can select Any 
  1861. sequence; this increases recall, the number of documents likely to be found. 
  1862.  
  1863.      Tip If you are using a dual index, select Inflected forms to activate the 
  1864.      Any sequence choice. 
  1865.  
  1866.  Multiple-word search terms: If you enter more than one word in a search term 
  1867.  field, the terms are found in any sequence as long as they are in the same 
  1868.  sentence. If you enter: 
  1869.  
  1870.   annual report guideline
  1871.  
  1872.  the search locates documents that contain: 
  1873.  
  1874.   guidelines for writing annual reports
  1875.  
  1876.  Compound search terms: If the search term belongs to a Germanic language, 
  1877.  SearchManager/2 breaks a compound into its parts, and uses the parts to search 
  1878.  as it would for a group of words. If you enter: 
  1879.  
  1880.   Jahresbericht
  1881.  
  1882.  meaning yearly report, the search locates documents that contain: 
  1883.  
  1884.   Bericht f╨ær das Jahr
  1885.  
  1886.  meaning report for the year. 
  1887.  
  1888.  
  1889. ΓòÉΓòÉΓòÉ 9.3.5. Searching for other (inflected) forms of terms ΓòÉΓòÉΓòÉ
  1890.  
  1891. If you are using a precise index, SearchManager/2 searches for the terms 
  1892. exactly as you type them. 
  1893.  
  1894. If you are using a linguistic index, (the Inflected forms box contains a check 
  1895. mark), SearchManager/2 searches also for other forms of the terms, such as 
  1896. singular, plural, or a different tense. 
  1897.  
  1898. The term: 
  1899.  
  1900. drive
  1901.  
  1902. finds documents that contain: 
  1903.  
  1904. drive
  1905. drives
  1906. driving
  1907. drove
  1908. driven.
  1909.  
  1910. If you are using a dual index, you can choose to search for inflected forms or 
  1911. not. 
  1912.  
  1913.  
  1914. ΓòÉΓòÉΓòÉ 9.3.6. Providing synonyms for a search term ΓòÉΓòÉΓòÉ
  1915.  
  1916. You can set up a synonym list for each search term. SearchManager/2 then 
  1917. searches for documents using not only the search term, but also the synonyms as 
  1918. alternative search terms. The synonyms are associated with a search term using 
  1919. an assumed OR operator. 
  1920.  
  1921. To associate synonyms to a particular search term: 
  1922.  
  1923.  o Select Synonyms. 
  1924.  
  1925.  o Select which synonyms you need for this search, then select OK. 
  1926.  
  1927.  The synonyms that you selected for the specified search term are now displayed 
  1928.  in the synonym list of the Query section. 
  1929.  
  1930.  These synonyms are associated with the currently selected search term; you can 
  1931.  select another search term and choose different synonyms for that term. 
  1932.  
  1933.  Figure: The Synonyms for ... window 
  1934.  
  1935.  Ifyoudonotfindaparticularsynonyminthelist ,youcanaddyourown 
  1936.  .Theseadditionalsynonymsarekeptwiththequery 
  1937.  ;theyarenotaddedtothepermanentlistofsynonyms .
  1938.  
  1939.      Tip If you have associated synonyms with a particular search term, but 
  1940.      want to make them temporarily ineffective without deleting them, simply 
  1941.      type a blank after the search term. The list of synonyms associated with 
  1942.      this term is now empty. 
  1943.  
  1944.      Remove the blank, and the synonyms return. 
  1945.  
  1946.      If you change a search term in any way, its synonyms are cleared on the 
  1947.      screen, but stored; when you reset the term, the synonyms reappear. 
  1948.  
  1949.  
  1950. ΓòÉΓòÉΓòÉ 9.3.7. Adding synonyms to the synonym list ΓòÉΓòÉΓòÉ
  1951.  
  1952. To add synonyms to the list permanently so that they appear each time you 
  1953. display the Synonyms for window, select Permanent. 
  1954.  
  1955. The Term field contains the base form of the selected search term. If the term 
  1956. is ambiguous, that is, if there are several base forms, then these are included 
  1957. in this field. 
  1958.  
  1959. Examples: 
  1960.  
  1961.  o If the search term is: 
  1962.  
  1963.       lay
  1964.  
  1965.    the Term list contains: 
  1966.  
  1967.       lay
  1968.       lie
  1969.  
  1970.    where lay can be the past tense of to lay or to lie. 
  1971.  
  1972.  o If the search term is: 
  1973.  
  1974.       building
  1975.  
  1976.    the Term list contains: 
  1977.  
  1978.       building
  1979.       build
  1980.    where building can be the noun or an inflection of the verb build. 
  1981.  
  1982.  To specify synonyms for a term, select it in the Term list, and add your 
  1983.  synonyms to the Permanent User Synonyms list. 
  1984.  
  1985.  Figure: The Permanent User Synonyms window 
  1986.  
  1987.  
  1988. ΓòÉΓòÉΓòÉ 9.3.8. An example of the use of synonyms ΓòÉΓòÉΓòÉ
  1989.  
  1990. In the Search terms fields specified: 
  1991.  
  1992.          price
  1993.   AND    increase
  1994.  
  1995. Select Synonyms for price, and choose the synonyms: 
  1996.  
  1997.  charge 
  1998.  tab 
  1999.  
  2000.  Then select Synonyms for increase, and choose the synonyms: 
  2001.  
  2002.  increment 
  2003.  raise 
  2004.  
  2005.  This is how SearchManager/2 now evaluates the search terms: 
  2006.  
  2007.          (price    OR charge    OR tab  )
  2008.     AND  (increase OR increment OR raise)
  2009.  
  2010.  
  2011. ΓòÉΓòÉΓòÉ 9.3.9. Selecting a language for a search term ΓòÉΓòÉΓòÉ
  2012.  
  2013. SearchManager/2 uses a dictionary to "tune" its search to a particular 
  2014. language. Dictionaries are provided in US English and in your local language. 
  2015. See Optional IBM licensed programs for a list of other dictionaries available. 
  2016.  
  2017. You can specify a different language for each search term in the query. Select 
  2018. it from the Language drop-down list. 
  2019.  
  2020. Initially this list displays the language currently used for the query (see 
  2021. Setting defaults for a query). SearchManager/2 assumes that any synonyms 
  2022. selected for a search term are in the same language as the search term. 
  2023.  
  2024.  
  2025. ΓòÉΓòÉΓòÉ 9.3.10. Using a thesaurus for a search term ΓòÉΓòÉΓòÉ
  2026.  
  2027. If Thesaurus End User System Toolkit/2 has been installed, there is a Thesaurus 
  2028. push button in the Query section of your Query notebook. Select Thesaurus to 
  2029. display the Thesaurus window. Here you can choose the thesaurus terms. 
  2030.  
  2031. Each term that you select from the thesaurus becomes an additional search term 
  2032. that you can link as you would any other search term using operators, like OR 
  2033. or AND. This is in contrast to synonyms, which are associated only with a 
  2034. particular search term (using an assumed OR operator). 
  2035.  
  2036. Refer to Thesaurus End User System Toolkit/2 for more information. 
  2037.  
  2038.  
  2039. ΓòÉΓòÉΓòÉ 9.4. Starting the search ΓòÉΓòÉΓòÉ
  2040.  
  2041. When you have specified your query, select Search to start searching. 
  2042.  
  2043. SearchManager/2 displays the Results View window listing the documents found. 
  2044. For more information refer to Working with found documents. 
  2045.  
  2046. If the result contains more than 1000 documents, you are asked if you want 
  2047. SearchManager/2 to continue processing. If you answer Yes, it can nevertheless 
  2048. occur that the result displayed to you is less than 1000. This happens if you 
  2049. cannot access some documents, or if some documents have been deleted but their 
  2050. terms are still indexed. 
  2051.  
  2052.  
  2053. ΓòÉΓòÉΓòÉ 9.5. Closing a query ΓòÉΓòÉΓòÉ
  2054.  
  2055. To close a query, double-click on the system menu symbol. You can do this 
  2056. whether or not you have run the query to make a search. 
  2057.  
  2058. Once a query has been closed, you can still view its result by selecting 
  2059. Results view from the pop-up menu of the Query object. 
  2060.  
  2061.      Tip Organize your Query objects into folders, or, if you find it more 
  2062.      convenient, move them directly onto the OS/2 desktop. 
  2063.  
  2064.  
  2065. ΓòÉΓòÉΓòÉ 9.6. Setting defaults for a query ΓòÉΓòÉΓòÉ
  2066.  
  2067. Select the Defaults section of the Query View notebook to set default 
  2068. definitions for the query being processed. (To specify global defaults for all 
  2069. queries refer to Specifying standard settings (global defaults).) 
  2070.  
  2071. Figure: Query defaults 
  2072.  
  2073. Thedefaultsare :
  2074.  
  2075.  Search service 
  2076.      The search service to be used; this is the one associated with the index 
  2077.      that you want to search. There could be more than one to choose from if 
  2078.      you are using SearchManager LAN Server/2 and Client/2 in a multiple-server 
  2079.      network. To use a query for searching in several indexes, copy the query 
  2080.      object and change the name specified for the search service. 
  2081.  
  2082.  
  2083.  Search the entire index 
  2084.      Whether to search the entire index or only the indexed terms for selected 
  2085.      document groups. If you are using the OS/2 file system, you can restrict 
  2086.      the search to documents contained in document groups (including subgroups) 
  2087.      using the Add Document Groups window. 
  2088.  
  2089.  
  2090.  Language 
  2091.      The language to appear initially in the Options area of the Query section 
  2092.      for each search term. For all index types, SearchManager/2 uses this 
  2093.      information to do some basic linguistic processing; for linguistic indexes 
  2094.      (and for dual indexes when Inflected forms is selected), SearchManager/2 
  2095.      uses it to determine which dictionary to use for its advanced linguistic 
  2096.      processing (described in Linguistic processing). 
  2097.  
  2098.      You can override this language setting for each search term, in the 
  2099.      Options area of the Query section. 
  2100.  
  2101.  
  2102.  Global characters 
  2103.      The global characters for the selected query. These are described in Using 
  2104.      global characters. 
  2105.  
  2106.  
  2107.  Display first 
  2108.      How many documents can be scrolled through at one time in the Results View 
  2109.      window. The maximum allowed is 300. 
  2110.  
  2111.      If very many documents are found, SearchManager/2 lets you limit the 
  2112.      number of document names it should process at one time. This limit ensures 
  2113.      that you do not have to wait for a large result list to be displayed; the 
  2114.      complete list of found documents is displayed, but in batches. 
  2115.  
  2116.  
  2117.  Show progress 
  2118.      Whether to display a progress indicator window during a search. The 
  2119.      progress indicator lets you know how long a search is likely to take. It 
  2120.      also includes a push button that lets you interrupt the search. This is 
  2121.      useful when a search takes a particularly long time, and you want to 
  2122.      interrupt the search so that you can repeat your query using more specific 
  2123.      search terms. If you decide to use the progress indicator, keep in mind 
  2124.      that the indicator itself uses system resources and can make a search take 
  2125.      somewhat longer. 
  2126.  
  2127.  
  2128. ΓòÉΓòÉΓòÉ 10. Working with found documents ΓòÉΓòÉΓòÉ
  2129.  
  2130. This section describes how to work with the results of a query, and how to use 
  2131. the Browser to display a found document, highlighting the terms that match the 
  2132. search criteria. 
  2133.  
  2134.  
  2135. ΓòÉΓòÉΓòÉ 10.1. Working with the results of a query ΓòÉΓòÉΓòÉ
  2136.  
  2137. When you make a query, and there are documents that match the search terms, 
  2138. SearchManager/2 displays the Results View window showing the documents found. 
  2139. The status line shows the number of documents displayed. 
  2140.  
  2141. To view the result of a closed query, select Results view in the pop-up menu of 
  2142. the Query object. 
  2143.  
  2144. Figure: The Results View of a query 
  2145.  
  2146. Ifyouneedtonarrowthesearchandspecifyamoredetailedquery 
  2147. ,maketheQueryViewwindowactiveagain ,byclickingonitusingthemouse 
  2148. .Ifthiswindowiscurrentlynotvisible 
  2149. ,selectQueryViewonthesystemmenuoftheResultsViewwindow 
  2150. .TheQuerysectionofthequerynotebookisdisplayedforyoutospecifythenewormodifiedsearchcriteria .
  2151.  
  2152. Use the menu bar of the Results View window to process the result or use the 
  2153. pop-up menu of the Document objects to process selected documents. 
  2154.  
  2155. Note:  Depending on your system setup, you can edit, print, and mail the 
  2156. documents contained in the result. 
  2157.  
  2158.  
  2159. ΓòÉΓòÉΓòÉ 10.1.1. Sorting the results of a query ΓòÉΓòÉΓòÉ
  2160.  
  2161. To sort the results of a query, select the right arrow in the Sort choice of 
  2162. the system menu. A menu of sort choices is displayed. These choices are 
  2163. provided by OS/2 for sorting the contents of a folder, but not all of them 
  2164. apply to a Results folder, whose attributes are: 
  2165.  
  2166.  Title 
  2167.  Location 
  2168.  Description 
  2169.  Last write date 
  2170.  Last write time. 
  2171.  
  2172.  To adjust this list for a Results View: 
  2173.  
  2174.   1. In the system menu of the query object (the object itself, or any of its 
  2175.      views) select Open and then Settings. 
  2176.  
  2177.   2. In the Settings notebook, select the Sort section. 
  2178.  
  2179.   3. In the Object type list, select Found document. Now, in the Sort by 
  2180.      attribute list are the attributes by which you can sort a Results folder. 
  2181.  
  2182.   4. Select all the attributes. 
  2183.  
  2184.   5. Close the Settings notebook. 
  2185.  
  2186.  The next time you select Sort from the system menu of a query object, the 
  2187.  correct attributes are listed. 
  2188.  
  2189.      Tip To make this setting valid for all future queries, use this query as a 
  2190.      "model" for others; create new queries by copying this one. 
  2191.  
  2192.  
  2193. ΓòÉΓòÉΓòÉ 10.1.2. Printing the results of a query ΓòÉΓòÉΓòÉ
  2194.  
  2195. Select Print in the Results menu to print the list of documents resulting from 
  2196. the query. The result is printed as shown in the Details view of the Results 
  2197. View window. 
  2198.  
  2199.  
  2200. ΓòÉΓòÉΓòÉ 10.1.3. Viewing the results of a query ΓòÉΓòÉΓòÉ
  2201.  
  2202. Use the View menu to change the view from Icon to Details view. 
  2203.  
  2204. If very many documents are found, you may notice that you cannot display all of 
  2205. their names by scrolling through the list. This is because SearchManager/2 lets 
  2206. you set a limit to the number of document names it should process at one time. 
  2207. This limit ensures that you do not have to wait for a large result list to be 
  2208. displayed. (How to specify this limit is described in Setting defaults for a 
  2209. query.) 
  2210.  
  2211. So a large number of document names are displayed to you in batches. You can 
  2212. display the next or the previous batch using the menu choices of the View menu. 
  2213.  
  2214. To see how many documents are found, display the final batch. 
  2215.  
  2216.  
  2217. ΓòÉΓòÉΓòÉ 10.2. Working with documents in the Result View ΓòÉΓòÉΓòÉ
  2218.  
  2219. There are two ways to work with documents that have been found by a query: 
  2220.  
  2221.  o Drag document objects to other objects on the OS/2 desktop. This is direct 
  2222.    manipulation. 
  2223.  
  2224.  o Use a document's pop-up menu. 
  2225.  
  2226.  Drag/drop works only with OS/2 files. 
  2227.  
  2228.  
  2229. ΓòÉΓòÉΓòÉ 10.2.1. Direct manipulation (drag/drop) ΓòÉΓòÉΓòÉ
  2230.  
  2231. Documents that have been found by a search can be dragged to these objects: 
  2232.  
  2233.  o To an Index object. This opens the Add to queue window and lets you place 
  2234.    the document in the document queue for indexing, or for removal from the 
  2235.    index. 
  2236.  
  2237.  o To a Printer object, for printing the document. 
  2238.  
  2239.  o To an open application window that accepts dropped objects, such as OS/2's 
  2240.    Enhanced Editor, or WordPerfect for OS/2. 
  2241.  
  2242.  o To any Program object. 
  2243.  
  2244.  
  2245. ΓòÉΓòÉΓòÉ 10.2.2. Using a document's pop-up menu ΓòÉΓòÉΓòÉ
  2246.  
  2247. Using normal OS/2 selection methods, you can select one or several documents 
  2248. from the result and display its pop-up menu. If the document is an OS/2 file, 
  2249. its pop-up menu contains not only the usual choices, but also the following 
  2250. additional choices provided for SearchManager/2. 
  2251.  
  2252.  Open - Browser 
  2253.      Select this choice to browse each document in a separate window. You may 
  2254.      find this choice more convenient when you want to study and perhaps 
  2255.      compare several documents at the same time. Caution is needed here, 
  2256.      because each open window uses up your system's resources. 
  2257.  
  2258.  
  2259.  Open - Common browser 
  2260.      Select this choice to open only one window for browsing one document after 
  2261.      the other. This is faster than Browser, and you may, therefore, find it 
  2262.      more convenient when you want to look briefly at many documents, or save 
  2263.      your system's resources. 
  2264.  
  2265.  
  2266.  Add to queue 
  2267.      Use this choice to add the document to the document queue for indexing or 
  2268.      for removal from the index. 
  2269.  
  2270.      To index several documents from the results, you have two possibilities, 
  2271.      though one has a distinct disadvantage. Select the documents you want to 
  2272.      have indexed, then: 
  2273.  
  2274.     o Use the mouse to drag the documents to the document index object. This is 
  2275.       the preferred method. 
  2276.  
  2277.     o Choose Add to queue from the pop-up menu of the selected documents. This 
  2278.       method is not recommended because, for each document selected, a separate 
  2279.       window is opened. 
  2280.  
  2281.  
  2282.  Locate original 
  2283.      The document objects shown in the Results View behave like shadows of the 
  2284.      original document objects. Use this choice to locate the original document 
  2285.      object. This choice applies only if the document is in the OS/2 file 
  2286.      system. 
  2287.  
  2288.  
  2289.  Copy name 
  2290.      There may be occasions when you want to use the name of a found document 
  2291.      in a report, for example, or in a File - Open dialog. This choice lets you 
  2292.      copy the fully qualified name of the document to the clipboard. 
  2293.  
  2294.  You can use OS/2 to associate programs, such as Mail with document objects. 
  2295.  You then see also these programs offered as choices in the pop-up menu of 
  2296.  documents in the query result. 
  2297.  
  2298.      Tip Browser choices are not available in the pop-up menu of documents in 
  2299.      the result of a closed query. 
  2300.  
  2301.      To browse these documents, either repeat the query (the browser choices 
  2302.      are then available), or use an editor. 
  2303.  
  2304.  
  2305. ΓòÉΓòÉΓòÉ 10.3. Choosing the default Browse action ΓòÉΓòÉΓòÉ
  2306.  
  2307. To browse a document found in the result, you can display its pop-up menu and 
  2308. select whether you want to use the Common browser or the Browser. 
  2309.  
  2310. A faster method is to double-click on the document. Initially, the default 
  2311. action for a double-click on a document in a Results view is determined by 
  2312. OS/2. However, the Options choice in the menu bar (see Working with the results 
  2313. of a query) lets you set the default to one of the two SearchManager/2 browse 
  2314. actions. 
  2315.  
  2316.  
  2317. ΓòÉΓòÉΓòÉ 10.4. Closing the Result View ΓòÉΓòÉΓòÉ
  2318.  
  2319. To close the result, double-click on the window's system menu symbol. The 
  2320. information contained in the result is stored in the query object. 
  2321.  
  2322.  
  2323. ΓòÉΓòÉΓòÉ 10.5. Browsing found documents ΓòÉΓòÉΓòÉ
  2324.  
  2325. Figure: Browsing a document 
  2326.  
  2327. When you browse a document, any text that matches the specified search criteria 
  2328. is highlighted. You can only view the document; you cannot change it. To change 
  2329. a document, you must use your own editor. 
  2330.  
  2331.      Tip If you are using a monochrome monitor, and are having difficulty 
  2332.      seeing highlighting, change the color settings through the Options choice 
  2333.      in the menu bar. 
  2334.  
  2335.  
  2336. ΓòÉΓòÉΓòÉ 10.5.1. Copying text to the clipboard ΓòÉΓòÉΓòÉ
  2337.  
  2338. To copy text to the clipboard: 
  2339.  
  2340.   1. Mark the text. Do this using either the mouse or keyboard, or using one of 
  2341.      the Edit menu choices. 
  2342.  
  2343.   2. Select Copy on the Edit menu. 
  2344.  
  2345.  
  2346. ΓòÉΓòÉΓòÉ 10.5.2. Displaying an explanation of why text is highlighted ΓòÉΓòÉΓòÉ
  2347.  
  2348. When searching for documents in a linguistic or a dual index, it might not 
  2349. always be obvious why a particular term matches the search criteria and is 
  2350. therefore highlighted. (For more information refer to Extended matching.) 
  2351.  
  2352. To display an explanation of why text is highlighted: 
  2353.  
  2354.   1. Place the cursor on the highlighted text. 
  2355.  
  2356.   2. Select Explain on the Edit menu, or select the Explain push button. 
  2357.  
  2358.  
  2359. ΓòÉΓòÉΓòÉ 10.5.3. Using extended matching ΓòÉΓòÉΓòÉ
  2360.  
  2361. Terms that match your search criteria are highlighted in the document by the 
  2362. browser. To determine which terms to highlight, the browser makes a linguistic 
  2363. analysis of the document, in much the same way as when documents are indexed. 
  2364. This analysis occurs very quickly, and in most cases it is sufficient to find 
  2365. all occurrences of the search term. 
  2366.  
  2367. Very occasionally, there can be circumstances when the browser cannot find a 
  2368. particular term to highlight; it needs to extend its matching ability by using 
  2369. a dictionary. You can read more about this in Linguistic processing, in 
  2370. particular Extended matching. 
  2371.  
  2372. If your index is the linguistic type, this extended matching occurs 
  2373. automatically without you realizing it. First, the browser displays the 
  2374. document and highlights the matches it finds immediately; then, while you are 
  2375. reading the document, the browser makes an extensive search for more matches. 
  2376. If the browser does find further matches, a message in the information line 
  2377. informs you. 
  2378.  
  2379. To now display all matches, including those found by extended matching: 
  2380.  
  2381. Select Extended matching 
  2382.  
  2383. Extended matching is a particularly thorough process and takes time. How long 
  2384. it takes depends on factors like the size of the document, the language in 
  2385. which the document is written, and the speed of your workstation; it can range 
  2386. from a few seconds to many minutes. 
  2387.  
  2388.  
  2389. ΓòÉΓòÉΓòÉ 10.5.4. Processing hypermedia references ΓòÉΓòÉΓòÉ
  2390.  
  2391. Documents can contain hypermedia references. These are points in a document 
  2392. from which other information, such as graphics, images, audio, or video, can be 
  2393. called. 
  2394.  
  2395. For example, a document could include a hypermedia reference to a piece of 
  2396. music. By selecting the reference, you could play the music using a CD player 
  2397. attached to the workstation. 
  2398.  
  2399. SearchManager/2 includes an application programming interface (API) that makes 
  2400. it possible for you to write the programs that process whatever media your 
  2401. documents contain. This API is described in IBM SearchManager/2: Programming 
  2402. Interfaces. 
  2403.  
  2404. An example of how you could implement hypermedia references is included in the 
  2405. sample documents. One of these documents contains a reference to a picture of a 
  2406. hot-air balloon: 
  2407.  
  2408.   1. Search in the sample documents for the term hot air. 
  2409.  
  2410.   2. Browse the found document. 
  2411.  
  2412.   3. Place the cursor on the hypermedia reference. 
  2413.  
  2414.   4. Select Hypermedia on the Edit menu, or select the Hypermedia push button. 
  2415.  
  2416.  To set the color in which hypermedia references are displayed, use the Options 
  2417.  choice in the menu bar. 
  2418.  
  2419.  
  2420. ΓòÉΓòÉΓòÉ 10.5.5. Locating words while browsing a document ΓòÉΓòÉΓòÉ
  2421.  
  2422. While you are browsing a document, you can move easily from match to match, 
  2423. find a particular word, or even find the next occurrence of a term that you 
  2424. have selected in the text. 
  2425.  
  2426. To do this, use the Next match and Previous match push buttons, or the choices 
  2427. in the Locate menu in the menu bar. 
  2428.  
  2429.  
  2430. ΓòÉΓòÉΓòÉ 10.5.6. Setting fonts and colors ΓòÉΓòÉΓòÉ
  2431.  
  2432. To set fonts and colors for the Browser window, use the Options menu. The fonts 
  2433. are monospaced. 
  2434.  
  2435.  
  2436. ΓòÉΓòÉΓòÉ 11. Installation ΓòÉΓòÉΓòÉ
  2437.  
  2438. SearchManager/2 is designed for an OS/2 local area network (LAN) client/server 
  2439. environment, and for OS/2 single-workstation systems. In a typical LAN 
  2440. environment, a SearchManager/2 installation comprises a server workstation (or 
  2441. possibly several) on which SearchManager/2's "search service" program is 
  2442. installed, and several client workstations with access to the search service. 
  2443.  
  2444. The IBM SearchManager LAN Server/2 and Client/2 product includes not only the 
  2445. software for installation at the server workstation, but also the software for 
  2446. client workstations. 
  2447.  
  2448. The SearchManager/2 single-workstation product contains the software for 
  2449. installation on a single workstation; the search service program and the 
  2450. "client" program are installed together in one workstation. 
  2451.  
  2452. This chapter tells you: 
  2453.  
  2454.  o How to plan for the installation 
  2455.  
  2456.  o What hardware and software you need 
  2457.  
  2458.  o How to install SearchManager LAN Server/2 and Client/2 
  2459.  
  2460.  o How to install the SearchManager/2 single-workstation product 
  2461.  
  2462.  o How to automate the installation if you need to carry it out at several 
  2463.    workstations. 
  2464.  
  2465.  Before you start installation: Read the READ.ME file provided on the 
  2466.  Installation diskette to find out the latest information available after this 
  2467.  book was written. 
  2468.  
  2469.  
  2470. ΓòÉΓòÉΓòÉ 11.1. Installation planning ΓòÉΓòÉΓòÉ
  2471.  
  2472. This section helps you to plan: 
  2473.  
  2474.  o For good performance 
  2475.  o Access to documents 
  2476.  o For working with Lotus Notes 
  2477.  o Which dictionaries to install 
  2478.  o Using SearchManager LAN Server/2 and Client/2 in a Novell** NetWare** 
  2479.    network. 
  2480.  
  2481.  
  2482. ΓòÉΓòÉΓòÉ 11.1.1. Planning for performance ΓòÉΓòÉΓòÉ
  2483.  
  2484. In a system where large volumes of data are being indexed or searched, good 
  2485. system performance is particularly important. Here are some general points to 
  2486. help you ensure that SearchManager/2 operates quickly and efficiently: 
  2487.  
  2488.  o Processor: You can install SearchManager/2 on workstations having an Intel** 
  2489.    386 processor, but you may not be satisfied with its processing speed in a 
  2490.    client/server system. A server workstation, in particular, should have a 
  2491.    powerful processor; recommended is at least a 486 processor, running at 25 
  2492.    Mhz. 
  2493.  
  2494.  o Disk speed: If possible, the hard disk should have an average access time of 
  2495.    at least 12 ms. 
  2496.  
  2497.  o Memory and size of hard disk: This depends on the number, size and type of 
  2498.    documents you have in your library system. Read the sections Hardware for 
  2499.    SearchManager LAN Server/2 and Client/2 and Hardware for SearchManager/2, in 
  2500.    particular the information concerning memory, permanent disk space, and 
  2501.    temporary disk space. 
  2502.  
  2503.  o Other applications: For single-workstation systems, and for server 
  2504.    workstations in a client/server system, be cautious about running additional 
  2505.    applications simultaneously. This increases the system load and disk 
  2506.    input/output, which in turn slows down all applications running on that 
  2507.    workstation. If possible, distribute applications to other server 
  2508.    workstations. 
  2509.  
  2510.  o Environment: When you install SearchManager/2 you can choose where to 
  2511.    install its various components. In a client/server system, prefer to install 
  2512.    executable files locally. If you install them on remote drives, it increases 
  2513.    the traffic that has to be handled by the local area network, and can 
  2514.    therefore have an adverse effect on the time taken for loading DLLs and 
  2515.    other required data, like temporary work files. 
  2516.  
  2517.  
  2518. ΓòÉΓòÉΓòÉ 11.1.2. Planning access to documents ΓòÉΓòÉΓòÉ
  2519.  
  2520. For a single-workstation installation, there is no restriction on where 
  2521. documents are located. 
  2522.  
  2523. For a client/server installation, the only restriction on the location of 
  2524. documents is that they must be accessible by the SearchManager/2 client for 
  2525. retrieval, and by the SearchManager/2 server for indexing. 
  2526.  
  2527. If SearchManager LAN Server/2 is installed on a file server, and the documents 
  2528. on this file server are to be indexed at the file server, then you must connect 
  2529. to the documents using the NET USE command. In this way, you ensure that 
  2530. Universal Naming Convention (UNC) names are used, so that the clients can 
  2531. retrieve the documents even if they are connected to them using different drive 
  2532. letters. (If documents on the file server are indexed from a remote client, UNC 
  2533. names are used automatically.) 
  2534.  
  2535.  
  2536. ΓòÉΓòÉΓòÉ 11.1.3. Planning to work with Lotus Notes ΓòÉΓòÉΓòÉ
  2537.  
  2538. These are points to take into consideration if you intend to work with Lotus 
  2539. Notes documents: 
  2540.  
  2541.  o OS/2 file system: If you plan to work with Lotus Notes documents and OS/2 
  2542.    file system documents, each system requires its own installation of 
  2543.    SearchManager LAN Server/2 on a separate server workstation. 
  2544.  
  2545.  o Client: A Lotus Notes Version 3 client must be installed. 
  2546.  
  2547.    The access authorization of this client must have the highest priority 
  2548.    needed to satisfy all database requests, such as reading all relevant 
  2549.    databases, views, forms, and documents. 
  2550.  
  2551.    The client must be in the Access Control Lists of the databases to be 
  2552.    indexed. 
  2553.  
  2554.  o Password: Lotus Notes initialization routines ask for a password to be 
  2555.    entered, if required by the Lotus Notes user ID. This can cause a 
  2556.    password-prompt window to open at an unattended server workstation. 
  2557.  
  2558.    To avoid this: 
  2559.  
  2560.     - Provide a Lotus Notes user ID for the SearchManager/2 server workstation, 
  2561.       without a password (password cleared). Ensure that this user ID is 
  2562.       assigned an access level of at least Editor. 
  2563.  
  2564.     - To maintain security, install (or enable) a keyboard-protection program, 
  2565.       such as OS/2's Lockup. 
  2566.  
  2567.  
  2568. ΓòÉΓòÉΓòÉ 11.1.4. Deciding which dictionaries to install ΓòÉΓòÉΓòÉ
  2569.  
  2570. Dictionaries are used to support the linguistic processing of documents in 
  2571. different languages during indexing and retrieval. 
  2572.  
  2573. SearchManager/2 provides two dictionaries, one for US English and one for your 
  2574. local language. 
  2575.  
  2576.      Tip You should install at least one dictionary for the main language of 
  2577.      the documents to be searched. If you do this: 
  2578.  
  2579.      o You are able to use all the linguistic functions described in Linguistic 
  2580.        processing. 
  2581.  
  2582.      o Irrelevant words ("stop words") are excluded from the index. 
  2583.  
  2584.      o You have a synonym list from which you can choose additional search 
  2585.        terms. 
  2586.  
  2587.  If you initially decide not to install dictionaries, but then install 
  2588.  dictionaries later, for consistent search results you will need to index all 
  2589.  documents again. This is true regardless of the index type; even in a precise 
  2590.  index, dictionaries are used for processing stop words. 
  2591.  
  2592.  If you need dictionaries in addition to those that are included in the 
  2593.  SearchManager/2 package, refer to Optional IBM licensed programs. 
  2594.  
  2595.  
  2596. ΓòÉΓòÉΓòÉ 11.1.5. Deciding where to install dictionaries ΓòÉΓòÉΓòÉ
  2597.  
  2598. In a single-workstation system, this question does not arise, because the 
  2599. dictionaries can be stored only on that workstation. 
  2600.  
  2601. In a client/server installation, if the server workstation on which 
  2602. SearchManager LAN Server/2 is installed is a file server, you could save space 
  2603. by installing the dictionaries only at the server workstation; the client can 
  2604. make use of the server's dictionaries by defining a path to them. You could 
  2605. also install dictionaries on a file server that is neither a SearchManager/2 
  2606. client or server workstation. 
  2607.  
  2608. However, you are recommended to install dictionaries at the server workstation, 
  2609. and at each client workstation. Installing dictionaries locally can result in a 
  2610. substantial improvement in performance. 
  2611.  
  2612. Dictionaries installed at the server workstation are used by the search service 
  2613. while indexing and searching. They are used for: 
  2614.  
  2615.  o Reduction to base form 
  2616.  o Decomposition 
  2617.  o Stop-word filtering 
  2618.  o Part-of-speech filtering 
  2619.  o Dehyphenation. 
  2620.  
  2621.  Dictionaries installed at the client workstation are used for: 
  2622.  
  2623.  o Finding synonyms when making a query 
  2624.  o Extended matching to find obscure matches. 
  2625.  
  2626.  
  2627. ΓòÉΓòÉΓòÉ 11.1.6. Defining a search service when you have no network ΓòÉΓòÉΓòÉ
  2628.  
  2629. SearchManager LAN Server/2 and Client/2 normally requires a network of course, 
  2630. but, for test purposes, you could install the client and the server components 
  2631. on a single workstation without networking software. In this case, these are 
  2632. the parameters you must specify when defining the search service: 
  2633.  
  2634.  o Service name: SM2 
  2635.  
  2636.  o Machine name: SM2 
  2637.  
  2638.  o Communication type: OS/2 named pipes. 
  2639.  
  2640.  
  2641. ΓòÉΓòÉΓòÉ 11.1.7. Using SearchManager/2 in a Novell NetWare network ΓòÉΓòÉΓòÉ
  2642.  
  2643. SearchManager LAN Server/2 and Client/2 can be used in a Novell NetWare 3.11 
  2644. network using named pipes. All workstations in the network must be configured 
  2645. as NetWare requesters for OS/2. In this case the SearchManager LAN Server/2 
  2646. workstation need not be configured as an OS/2 LAN Server (using IBM OS/2 LAN 
  2647. Server 2.0 or 3.0), but it must be configured as a NetWare named pipes server. 
  2648.  
  2649. These are the points to consider if you are planning to use SearchManager LAN 
  2650. Server/2 and Client/2 in a Novell NetWare network without IBM OS/2 LAN Server. 
  2651.  
  2652. No remote administration: Administration can be carried out only at the 
  2653. workstation where SearchManager LAN Server/2 has been installed. Remote 
  2654. administration can be carrried out only by an administrator of IBM OS/2 LAN 
  2655. Server. 
  2656.  
  2657. If documents are on a NetWare file server: If the documents to be indexed are 
  2658. on a NetWare file server and you are using the OS/2 library services (OS/2 file 
  2659. system) provided with SearchManager/2: 
  2660.  
  2661.  o To enable SearchManager/2 clients to find the documents that have been 
  2662.    indexed, SearchManager LAN Server/2 and its clients must use identical drive 
  2663.    letters when drives are mapped to directories on a NetWare file server. 
  2664.  
  2665.  o Documents cannot be added to the queue from a remote SearchManager/2 client 
  2666.    workstation, because drives that are mapped to directories on a NetWare file 
  2667.    server are treated like local drives. 
  2668.  
  2669.  o For the same reason, only the whole document index can be searched from a 
  2670.    remote SearchManager/2 client workstation, that is, a search cannot be 
  2671.    restricted to document groups. 
  2672.  
  2673.  o On the workstation where SearchManager LAN Server/2 has been installed, the 
  2674.    document group windows (Add to queue, restrict search to document groups) 
  2675.    show not only mapped drives and their subdirectories, but also the documents 
  2676.    that are located on a mapped drive and in its subdirectories. 
  2677.  
  2678.  
  2679. ΓòÉΓòÉΓòÉ 11.1.8. Using SearchManager/2 in a TCP/IP network ΓòÉΓòÉΓòÉ
  2680.  
  2681. You can use SearchManager/2 in a TCP/IP network in conjuction with IBM OS/2 LAN 
  2682. server 2.0 or 3.0. However, these are the points to consider if you are 
  2683. planning to use TCP/IP without IBM OS/2 LAN Server. 
  2684.  
  2685. No remote administration: Administration can be carried out only at the 
  2686. workstation where SearchManager LAN Server/2 has been installed. Remote 
  2687. administration can be carrried out only by an administrator of IBM OS/2 LAN 
  2688. Server. 
  2689.  
  2690. If documents are on a Network File System server: If the documents to be 
  2691. indexed are on a Network File System (NFS) server, and you are using the OS/2 
  2692. library services (OS/2 file system) provided with SearchManager/2: 
  2693.  
  2694.  o To enable SearchManager/2 clients to find the documents that have been 
  2695.    indexed, SearchManager LAN Server/2 and its clients must mount directories 
  2696.    on an NFS server using identical drive letters. 
  2697.  
  2698.  o Documents cannot be added to the queue from a remote client workstation, 
  2699.    because mounted directories on an NFS server are treated like local drives. 
  2700.  
  2701.  o For the same reason, only the whole document index can be searched from a 
  2702.    remote SearchManager/2 client workstation, that is, a search cannot be 
  2703.    restricted to document groups. 
  2704.  
  2705.  
  2706. ΓòÉΓòÉΓòÉ 11.2. Installing IBM SearchManager LAN Server/2 and Client/2 ΓòÉΓòÉΓòÉ
  2707.  
  2708. This section describes how to install SearchManager LAN Server/2 and Client/2. 
  2709. If you are installing the SearchManager/2 single-workstation system, refer to 
  2710. Installing IBM SearchManager/2 single workstation. 
  2711.  
  2712. If the SearchManager/2 single-workstation system is already installed, then you 
  2713. must delete it before proceeding; SearchManager LAN Server/2 and 
  2714. SearchManager/2 single-workstation cannot be installed together on the same 
  2715. workstation. Remember to save your index files before doing so; Deleting 
  2716. components of SearchManager/2 describes how to do this. 
  2717.  
  2718.      Tip Before proceeding, check that you have the diskettes for SearchManager 
  2719.      LAN Server/2 and Client/2, and not those for the SearchManager/2 
  2720.      single-workstation system. 
  2721.  
  2722.  Follow these steps to install the server AND the client components on the 
  2723.  server workstation, and then repeat them to install the client component at 
  2724.  each client workstation. 
  2725.  
  2726.  If you need to install components of SearchManager LAN Server/2 and Client/2 
  2727.  on several workstations, you may want to do the installation from the LAN, or 
  2728.  even automate the installation. If so, refer to Installing SearchManager/2 
  2729.  without diskettes. 
  2730.  
  2731.  
  2732. ΓòÉΓòÉΓòÉ 11.2.1. Installation configurations for LAN systems ΓòÉΓòÉΓòÉ
  2733.  
  2734. The following figure illustrates a client/server system having one server. 
  2735.  
  2736. Figure: SearchManager/2 in a single-server network 
  2737.  
  2738. The search service, installed on the server workstation, handles the indexing 
  2739. and retrieval tasks. The document index must be located on the same server 
  2740. workstation on which the search service is installed. Each client has a search 
  2741. service object through which it accesses the search service installed at the 
  2742. server. 
  2743.  
  2744. The documents themselves could be installed at the server workstation, or at a 
  2745. file server to which the server workstation and the clients have access. 
  2746.  
  2747. If the documents are located at several file servers, the server workstation at 
  2748. which the search service is installed needs access to all the file servers. The 
  2749. clients need access to those file servers that contain the documents they are 
  2750. authorized to work with. 
  2751.  
  2752. The following figure illustrates a client/server system having more than one 
  2753. server. A search service is installed at each server workstation. Each search 
  2754. service handles the indexing and retrieval tasks for one document index. Each 
  2755. client has one search service object for each document index that it needs to 
  2756. work with. 
  2757.  
  2758. Figure: SearchManager/2 in a two-server network 
  2759.  
  2760.  
  2761. ΓòÉΓòÉΓòÉ 11.2.2. Hardware for SearchManager LAN Server/2 and Client/2 ΓòÉΓòÉΓòÉ
  2762.  
  2763. This is the hardware that you need to install SearchManager LAN Server/2 and 
  2764. Client/2. 
  2765.  
  2766. For a server workstation: 
  2767.  
  2768.  o IBM Personal System/2* or equivalent with an Intel 386 processor (or 
  2769.    equivalent) or higher 
  2770.  
  2771.  o VGA, 8514, XGA or SVGA (IBM) display adapter 
  2772.  
  2773.  o 4MB main storage, in addition to the memory needed for the operating system 
  2774.    and any other active applications 
  2775.  
  2776.  o Diskette drive: 1.44MB, 3.5" 
  2777.  
  2778.  o Disk space: 
  2779.  
  2780.     Server program          6.5MB 
  2781.     and client program 
  2782.     Each dictionary         between 0.5MB and 3.0MB 
  2783.  
  2784.     Toolkit and             0.5MB 
  2785.     programming samples 
  2786.     Online manual           0.5MB 
  2787.  
  2788.     Document index          See below. 
  2789.  
  2790.  o Mouse (recommended). 
  2791.  
  2792.  Disk space for indexing: 
  2793.  
  2794.  You need permanent disk space for the document index, plus temporary disk 
  2795.  space for merging the index parts and temporary disk space for indexing. The 
  2796.  temporary disk space requirement is not additive, because merging and indexing 
  2797.  do not run at the same time. 
  2798.  
  2799.  Unfortunately, the disk space calculation is not straight forward, so take 
  2800.  time to understand it, and avoid running into disk space problems later. 
  2801.  
  2802.  o Permanent disk space for the document index 
  2803.  
  2804.    This depends on many factors, such as the number of graphics that your 
  2805.    documents contain; the more graphics there are, the less space you need for 
  2806.    the index. 
  2807.  
  2808.    It depends on the type of documents you index; documents from Ami Pro and 
  2809.    similar word-processing products need relatively less space because much of 
  2810.    their content consists of control characters rather than text. 
  2811.  
  2812.    It also depends on the number of unique words or numbers that your documents 
  2813.    contain; documents containing lists of sequential numbers take up relatively 
  2814.    more space because each number is unique and is indexed separately. 
  2815.  
  2816.    Lastly, it depends, of course, on the number and size of your documents. 
  2817.  
  2818.    As a guideline, reserve disk space for about 0.7 times the size of the 
  2819.    documents to be indexed. For example, you would need about 7MB of disk space 
  2820.    for a document index for 10MB of documents. Then experiment by indexing a 
  2821.    sample batch of typical documents. 
  2822.  
  2823.  o Temporary disk space for merging 
  2824.  
  2825.    For merging, reserve about 2.5 times the size of the primary part and the 
  2826.    secondary part of the document index. 
  2827.  
  2828.  o Temporary disk space for indexing 
  2829.  
  2830.    As with permanent disk space, the amount of temporary disk space that you 
  2831.    need for indexing can vary widely. It depends on the size of your secondary 
  2832.    index, and on the size of the documents to be indexed. 
  2833.  
  2834.    Calculate it as follows: 
  2835.  
  2836.      1. Take the current size of the secondary part of the document index. 
  2837.  
  2838.      2. Add about 0.7 times the size of the documents to be indexed. 
  2839.  
  2840.      3. Add to this again about 0.7 times the documents to be indexed. If this 
  2841.         last calculation comes to more that 10MB, then use the figure 10MB. 
  2842.  
  2843.  For a client workstation: 
  2844.  
  2845.  o IBM Personal System/2 or equivalent with an Intel 386 processor (or 
  2846.    equivalent) or higher 
  2847.  
  2848.  o VGA, 8514, XGA or SVGA (IBM) display adapter 
  2849.  
  2850.  o 2MB main storage, in addition to the memory needed for the operating system 
  2851.    and any other active applications 
  2852.  
  2853.  o Diskette drive: 1.44MB, 3.5" 
  2854.  
  2855.  o Disk space: 
  2856.  
  2857.     Client program          5MB 
  2858.     Each dictionary         between 0.5MB and 3.0MB 
  2859.  
  2860.     Toolkit and             0.5MB 
  2861.     programming samples 
  2862.     Online manual           0.5MB 
  2863.  
  2864.  o Mouse (recommended). 
  2865.  
  2866.  
  2867. ΓòÉΓòÉΓòÉ 11.2.3. Software for SearchManager LAN Server/2 and Client/2 ΓòÉΓòÉΓòÉ
  2868.  
  2869. This is the software that you need to install SearchManager LAN Server/2 and 
  2870. Client/2. 
  2871.  
  2872. For a server workstation: 
  2873.  
  2874.  o IBM OS/2 Version 2 (5621-077), CSD level XR06055, or above. 
  2875.  o IBM OS/2 LAN Server Version 2.0, CSD level IP06030 or Version 3.0 
  2876.    (5621-253). 
  2877.  
  2878.    You can use OS/2 LAN Server alone, or together with one of these: 
  2879.  
  2880.     - IBM TCP/IP Version 1.2.1 for OS/2 (5798-RXW) 
  2881.  
  2882.     - Novell NetWare Version 3.11. 
  2883.  
  2884.    If you use OS/2 LAN Server alone, the workstation on which SearchManager LAN 
  2885.    Server/2 is installed must be configured as a LAN server. 
  2886.  
  2887.    It is also possible to use TCP/IP or Novell NetWare without OS/2 LAN Server. 
  2888.    See Using SearchManager/2 in a TCP/IP network and Using SearchManager/2 in a 
  2889.    Novell NetWare network for details. 
  2890.  
  2891.  For a client workstation: 
  2892.  
  2893.  o IBM OS/2 Version 2 (5621-077), CSD level XR06055 or above. 
  2894.  o IBM OS/2 Requester from IBM OS/2 LAN Server Version 2.0 CSD level XR06030, 
  2895.    or Version 3.0 (5621-253). 
  2896.  o IBM TCP/IP Version 1.2.1 for OS/2 (5798-RXW), optional. 
  2897.  
  2898.  The workstation on which Client/2 is installed must be configured as a LAN 
  2899.  requestor if you are using OS/2 LAN Server at the server workstation. 
  2900.  
  2901.  
  2902. ΓòÉΓòÉΓòÉ 11.2.4. Starting the client and server installation ΓòÉΓòÉΓòÉ
  2903.  
  2904.      Essential steps Installation consists not only in running the installation 
  2905.      program to install the software; there are also some configuration steps. 
  2906.  
  2907.      Use this checklist to ensure that you carry out all the installation 
  2908.      steps. 
  2909.  
  2910.       1. Read the section that describes installation planning, in particular 
  2911.          Planning access to documents. 
  2912.  
  2913.       2. At the server workstation, install both the server and the client 
  2914.          components. 
  2915.  
  2916.          Be sure that your documents are located on a LAN file server that is 
  2917.          accessible by all clients. 
  2918.  
  2919.          During installation, install the sample documents to a path that 
  2920.          client workstations can access. 
  2921.  
  2922.       3. Set up the SearchManager/2 global defaults. 
  2923.  
  2924.       4. Set up the search service. 
  2925.  
  2926.       5. At the client workstations, install the client component. 
  2927.  
  2928.       6. At each client workstation, create a search service object through 
  2929.          which the client can access the search service installed at the server 
  2930.          workstation. 
  2931.  
  2932.       7. When you have finished the installation at a particular workstation, 
  2933.          verify the installation. 
  2934.  
  2935.       8. Index your documents. If you plan to use periodic indexing, do your 
  2936.          initial indexing using periodic indexing. 
  2937.  
  2938.  If you have already installed SearchManager LAN Server/2 or Client/2, the 
  2939.  installation program recognizes this and presents suitable options for update 
  2940.  or reinstallation. A delete option is also available. 
  2941.  
  2942.  The following components can be installed: 
  2943.  
  2944.  IBM SearchManager Client/2 
  2945.            The client component for working with the IBM SearchManager LAN 
  2946.            Server/2 server component. You must install the client component 
  2947.            also on the server workstation. 
  2948.  
  2949.  
  2950.  SearchManager LAN Server/2 
  2951.            The server component and sample documents for installation on a 
  2952.            server workstation. Install these on a LAN server or on a TCP/IP 
  2953.            workstation. The sample documents are used in verifying the 
  2954.            installation. 
  2955.  
  2956.  
  2957.  Online Documentation 
  2958.            This book, IBM SearchManager/2: Retrieval and Indexing, is included 
  2959.            not only as a manual, but also as online information. You can view 
  2960.            it by double-clicking on the Retrieval and Indexing object in the 
  2961.            SearchManager/2 folder. 
  2962.  
  2963.  
  2964.  Dictionaries 
  2965.            Monolingual dictionaries and stop-word lists for two languages. 
  2966.  
  2967.  
  2968.  Toolkit and programming samples 
  2969.            Files for the SearchManager/2 Library Services sample, and for the 
  2970.            SearchManager/2 Retrieval API sample. These are described in IBM 
  2971.            SearchManager/2: Programming Interfaces. 
  2972.  
  2973.  Figure: Components of SearchManager LAN Server/2 and Client/2 
  2974.  
  2975.  To install SearchManager LAN Server/2 and Client/2: 
  2976.  
  2977.   1. Start an OS/2 session. 
  2978.  
  2979.   2. Insert the Installation diskette into a diskette drive. 
  2980.  
  2981.   3. Make sure that the current drive is the drive containing the installation 
  2982.      program; for example, A: if you install the program from drive A. 
  2983.  
  2984.   4. Type SM2INST at the OS/2 command prompt and press Enter. 
  2985.  
  2986.   5. Follow the instructions on the screens; select Help for more details. 
  2987.  
  2988.   6. When you have finished, restart your operating system. 
  2989.  
  2990.   7. Double-click on the Initialize SearchManager/2 object to start the process 
  2991.      that completes the installation. 
  2992.  
  2993.  
  2994. ΓòÉΓòÉΓòÉ 11.2.5. How SearchManager LAN Server/2 and Client/2 modifies your CONFIG.SYS ΓòÉΓòÉΓòÉ
  2995.  
  2996. These are the changes that SearchManager/2 makes to your CONFIG.SYS file: 
  2997.  
  2998.  o The directory in which the dynamic link libraries (DLLs) are installed is 
  2999.    added to: 
  3000.  
  3001.     LIBPATH 
  3002.  
  3003.  o The directory in which the product is installed is added to: 
  3004.  
  3005.     SET PATH 
  3006.     SET DPATH 
  3007.     SET HELP 
  3008.  
  3009.  o The following environment variables are added: 
  3010.  
  3011.     EHSDATA: directory for the SearchManager/2 data files (on a server 
  3012.     workstation also for the index files) 
  3013.     EHSWORK: directory for temporary files 
  3014.     EHSNLPS: directory for dictionaries 
  3015.     TMP (if not already present): for temporary files, pointing to the same 
  3016.     directory as EHSWORK. 
  3017.  
  3018.  
  3019. ΓòÉΓòÉΓòÉ 11.2.6. Specifying standard settings (global defaults) ΓòÉΓòÉΓòÉ
  3020.  
  3021. Once you have installed SearchManager/2, set up the Global defaults. These are 
  3022. the settings that you want to apply to all queries. Changing them affects only 
  3023. new queries and existing queries that you open after making the change. 
  3024.  
  3025. You can set: 
  3026.  
  3027.  o The language used on windows. 
  3028.  
  3029.  o The language used for queries. 
  3030.  
  3031.    You can change the language selection for individual search terms and 
  3032.    queries. Refer to Selecting a language for a search term, and Setting 
  3033.    defaults for a query. 
  3034.  
  3035.  o Global ("wild-card") characters used when specifying queries. 
  3036.  
  3037.  You can also select global characters for individual queries. Refer to Setting 
  3038.  defaults for a query. 
  3039.  
  3040.  To set the global defaults: 
  3041.  
  3042.  o Select Defaults on the pop-up menu of the SearchManager/2 folder. 
  3043.  
  3044.  
  3045. ΓòÉΓòÉΓòÉ 11.2.7. Defining the local search service at the server ΓòÉΓòÉΓòÉ
  3046.  
  3047. The SearchManager/2 search service provides you with indexing and retrieval 
  3048. services, such as starting a search, and adding documents to the queue for 
  3049. indexing. At the workstation where the search service is installed, it also 
  3050. handles the indexing of documents. 
  3051.  
  3052. On a client/server system, the search service is installed at the server 
  3053. workstation, but each client can use the service through the search service 
  3054. object in the SearchManager/2 folder. 
  3055.  
  3056. Figure: A search service in a client/server system 
  3057.  
  3058. If a client is connected to more than one server workstation, it can have one 
  3059. search service object for each server on which SearchManager LAN Server/2 is 
  3060. installed. Installation configurations for LAN systems shows a possible 
  3061. configuration. 
  3062.  
  3063. In a client/server system, you set up the search service to ensure that it runs 
  3064. most efficiently for your system, and that the client and the server work 
  3065. together using the same parameters. 
  3066.  
  3067. To set up the server's search service: 
  3068.  
  3069.   1. Open the SearchManager/2 folder. 
  3070.  
  3071.   2. Select Settings on the pop-up menu of the Search service folder. 
  3072.  
  3073.   3. Select the Definitions section. 
  3074.  
  3075.  Figure: Defining a search service 
  3076.  
  3077.      Tip Changes to the search service settings are active only the next time 
  3078.      you start it. To activate new settings immediately, stop the search 
  3079.      service, then restart it. 
  3080.  
  3081.  In the Definitions section of the Search service folder you set up: 
  3082.  
  3083.  o The name of the service 
  3084.  o The name of the server workstation and the communication type 
  3085.  o Some service parameters. 
  3086.  
  3087.  Search service name: This is the name that you want to give to the local 
  3088.  search service. It is needed also by the client to access the search service. 
  3089.  It does not have to be the same name that you give to the search service 
  3090.  object on the OS/2 desktop. 
  3091.  
  3092.  Define search service: 
  3093.  
  3094.  Machine name 
  3095.            This is the identification of the server workstation where the 
  3096.            search service is installed. It is dependent on the communication 
  3097.            type: 
  3098.  
  3099.            Named pipes: Enter the LAN address of this workstation. You can 
  3100.            display this by entering 
  3101.  
  3102.                       net name
  3103.  
  3104.            in an OS/2 session. 
  3105.  
  3106.            TCP/IP: Enter the TCP/IP host name of this workstation if the name 
  3107.            is not longer than 15 characters. Otherwise, enter the TCP/IP dotted 
  3108.            decimal address of this workstation. 
  3109.  
  3110.  
  3111.  Communication type 
  3112.            OS/2 named pipes, or TCP/IP. 
  3113.  
  3114.  
  3115.  Port 
  3116.            Required for TCP/IP only. 
  3117.  
  3118.  Service parameters: These are tuning parameters for making your system work 
  3119.  more efficiently. 
  3120.  
  3121.  Max. parallel service tasks 
  3122.            The maximum number of tasks to be handled at the same time by the 
  3123.            search service. Service tasks are, for example, starting a search, 
  3124.            adding documents to the queue, or administration tasks. 
  3125.  
  3126.            The higher you set this value, the slower your system becomes. On 
  3127.            the other hand, if you set this value too low, then, at busy times, 
  3128.            some clients may not be able to search. 
  3129.  
  3130.            The value set initially is 6. 
  3131.  
  3132.      Tip If the server has, say, 30 clients that are not likely to be searching 
  3133.      at the same time, try setting this value to about 10. 
  3134.  
  3135.  
  3136.  Service tasks kept available 
  3137.            The number of search service tasks to be kept available. This is the 
  3138.            number of tasks started in advance to handle future requests. 
  3139.  
  3140.            For good performance, a client making a request should always find a 
  3141.            service task ready to handle its request. However, having too many 
  3142.            service tasks open unnecessarily means making inefficient use of the 
  3143.            service. 
  3144.  
  3145.            The specified number must be lower or equal to the number of search 
  3146.            service tasks accepted. 
  3147.  
  3148.            The value set initially is 3. 
  3149.  
  3150.  
  3151.  Time limit seconds 
  3152.            The time that a search service task is allowed to run. After this 
  3153.            time, the service task assigned to handle a specific request, like a 
  3154.            search, is terminated. 
  3155.  
  3156.            Set this value to the longest reasonable search time. It prevents 
  3157.            unreasonably long searches from reducing the overall system 
  3158.            performance. 
  3159.  
  3160.            It also terminates inactive tasks, such as when a query notebook is 
  3161.            left open after a search. 
  3162.  
  3163.            The recommended minimum value is 1200 seconds, which is the value 
  3164.            set initially. 
  3165.  
  3166.  
  3167.  Task cleanup every ms 
  3168.            How frequently you want SearchManager/2 to check whether new tasks 
  3169.            have to be started to handle future requests, or to check whether to 
  3170.            remove surplus tasks to ease the system load. 
  3171.  
  3172.            It is best not to change the initial value which is 500ms. 
  3173.  
  3174.  
  3175. ΓòÉΓòÉΓòÉ 11.2.8. Defining a search service in a Novell NetWare network ΓòÉΓòÉΓòÉ
  3176.  
  3177. These are the points to note when setting up the search service for a server in 
  3178. a Novell NetWare network. 
  3179.  
  3180.  o Machine name: Enter the name of the NetWare named pipes server workstation. 
  3181.    If you are using Novell NetWare in addition to IBM OS/2 LAN Server 2.0 or 
  3182.    3.0, then this field initially shows the machine name of the IBM OS/2 LAN 
  3183.    Server. 
  3184.  
  3185.  o Communication method: Set the communication method to OS/2 Named Pipes 
  3186.  
  3187.  
  3188. ΓòÉΓòÉΓòÉ 11.2.9. Accessing a remote search service from a client ΓòÉΓòÉΓòÉ
  3189.  
  3190. When you install Client/2 on a client workstation, a New remote search service 
  3191. object is created in the in the SearchManager/2 folder. 
  3192.  
  3193. You must set up the client's Search service object to contain the server's name 
  3194. and address. 
  3195.  
  3196. To set up a search service object for a client: 
  3197.  
  3198.   1. Open the Settings view of the New remote search service object. 
  3199.  
  3200.   2. Select the Definitions section. 
  3201.  
  3202.  In the Definitions section of the Search service folder you set up: 
  3203.  
  3204.  o The name of the remote search service 
  3205.  o The address of the search service. 
  3206.  
  3207.  These parameters must be identical to those specified at the server 
  3208.  workstation. 
  3209.  
  3210.  Service name: The name of the remote search service you want to work with. 
  3211.  
  3212.      Tip Be sure that this name is identical in every way to the name specified 
  3213.      at the server workstation. 
  3214.  
  3215.  (It does not have to be the same name that you give to the search service 
  3216.  object on the OS/2 desktop.) 
  3217.  
  3218.  Service address: 
  3219.  
  3220.  Machine name 
  3221.            The identification of the server workstation where the search 
  3222.            service is installed. 
  3223.  
  3224.  
  3225.  Communication type 
  3226.            The communication type of the server workstation where the search 
  3227.            service is installed (OS/2 named pipes, or TCP/IP). 
  3228.  
  3229.  
  3230.  Port 
  3231.            The same as on the server workstation (required for TCP/IP only). 
  3232.  
  3233.  
  3234. ΓòÉΓòÉΓòÉ 11.2.10. Creating additional search service objects for a client ΓòÉΓòÉΓòÉ
  3235.  
  3236. If additional search services are installed on other server workstations, then, 
  3237. at the client workstation, you can create more search service objects to 
  3238. provide access to each search service. 
  3239.  
  3240. To create an additional search service object for a client: 
  3241.  
  3242.   1. Click on the SearchManager/2 folder using the right-hand mouse button to 
  3243.      display its pop-up menu. 
  3244.  
  3245.   2. Select New remote service. A new remote service object appears in the 
  3246.      SearchManager/2 folder. 
  3247.  
  3248.   3. Open the Settings view of the new remote search service object. 
  3249.  
  3250.   4. Select the Definitions section. 
  3251.  
  3252.   5. Follow the steps described in Accessing a remote search service from a 
  3253.      client. 
  3254.  
  3255.  
  3256. ΓòÉΓòÉΓòÉ 11.2.11. Verifying the SearchManager LAN Server/2 and Client/2 installation ΓòÉΓòÉΓòÉ
  3257.  
  3258. When you have finished installing, you should verify the installation by 
  3259. indexing the sample documents and then carrying out a simple search. 
  3260.  
  3261. For a server workstation: Installation verification consists of the following 
  3262. steps: 
  3263.  
  3264.   1. Place sample documents in the document queue for indexing 
  3265.   2. Index the sample documents 
  3266.   3. Search for terms contained in the documents 
  3267.   4. Browse documents to see the terms found. 
  3268.  
  3269.  Follow the description of these steps in Getting started, beginning at A brief 
  3270.  look at the indexing process. 
  3271.  
  3272.  For a client workstation: Installation verification consists of the following 
  3273.  steps: 
  3274.  
  3275.  o Search for terms contained in the documents 
  3276.  o Browse documents to see terms found. 
  3277.  
  3278.  Follow the description of these steps in Getting started, beginning at Making 
  3279.  your first search. 
  3280.  
  3281.  
  3282. ΓòÉΓòÉΓòÉ 11.3. Installing IBM SearchManager/2 single workstation ΓòÉΓòÉΓòÉ
  3283.  
  3284. This section describes installing SearchManager/2 on a single workstation. If 
  3285. you are installing SearchManager LAN Server/2 and Client/2 (client/server 
  3286. system), turn to Installing IBM SearchManager LAN Server/2 and Client/2. 
  3287.  
  3288. If SearchManager LAN Server/2 is already installed, then you must delete it 
  3289. before proceeding; SearchManager LAN Server/2 and the SearchManager/2 
  3290. single-workstation system cannot be installed on the same workstation. Remember 
  3291. to save your index files before doing so, Deleting components of 
  3292. SearchManager/2 describes how to do this. 
  3293.  
  3294.      Tip Before proceeding, check that you have the diskettes for 
  3295.      SearchManager/2 single-workstation, and not those for SearchManager LAN 
  3296.      Server/2 and Client/2. 
  3297.  
  3298.  
  3299. ΓòÉΓòÉΓòÉ 11.3.1. Hardware for SearchManager/2 ΓòÉΓòÉΓòÉ
  3300.  
  3301.  o IBM Personal System/2 or equivalent with Intel processor 80386 or 
  3302.    equivalent/higher 
  3303.  
  3304.  o VGA, 8514, XGA or SVGA (IBM) display adapter 
  3305.  
  3306.  o 4MB main storage, in addition to the memory needed for the operating system 
  3307.    and any other active applications 
  3308.  
  3309.  o Diskette drive: 1.44MB, 3.5" 
  3310.  
  3311.  o Disk space: 
  3312.  
  3313.     SearchManager/2 program            6.0MB 
  3314.     Each dictionary                    between 0.5MB and 3MB 
  3315.  
  3316.     Toolkit and                        0.5MB 
  3317.     programming samples 
  3318.     Online manual                      0.5MB 
  3319.  
  3320.     Document index                     See Hardware for SearchManager LAN 
  3321.                                        Server/2 and Client/2 
  3322.  
  3323.  
  3324. ΓòÉΓòÉΓòÉ 11.3.2. Software for SearchManager/2 ΓòÉΓòÉΓòÉ
  3325.  
  3326.  o IBM OS/2 Version 2 (5621-077), CSD level XR06055 or above. 
  3327.  
  3328.  
  3329. ΓòÉΓòÉΓòÉ 11.3.3. Starting the SearchManager/2 installation ΓòÉΓòÉΓòÉ
  3330.  
  3331. An installation program guides you and prompts you for the components to be 
  3332. installed and other relevant details. If you have already installed 
  3333. SearchManager/2, the installation program recognizes this and presents suitable 
  3334. options for update or reinstallation. A delete option is also available. 
  3335.  
  3336.      Essential steps Installation consists not only in running the installation 
  3337.      program to install the software; there are also some configuration steps. 
  3338.  
  3339.      Use this checklist to ensure that you carry out all the installation 
  3340.      steps. 
  3341.  
  3342.       1. Read the section that describes installation planning. 
  3343.  
  3344.       2. Install the SearchManager/2 single-workstation system. 
  3345.  
  3346.       3. Set up the SearchManager/2 global defaults. 
  3347.  
  3348.       4. Set up the search service. 
  3349.  
  3350.       5. Verify the installation. 
  3351.  
  3352.       6. Index your documents. If you plan to use periodic indexing, do your 
  3353.          initial indexing using periodic indexing. 
  3354.  
  3355.  The following components can be installed: 
  3356.  
  3357.  SearchManager/2 
  3358.            The SearchManager/2 single-workstation component and sample 
  3359.            documents used in verifying the installation. 
  3360.  
  3361.  
  3362.  Online Documentation 
  3363.            This book, IBM SearchManager/2: Retrieval and Indexing, is included 
  3364.            not only as a manual, but also as online information so that you can 
  3365.            view it by double-clicking on the Retrieval and Indexing object in 
  3366.            the SearchManager/2 folder. 
  3367.  
  3368.  
  3369.  Dictionaries 
  3370.            Monolingual dictionaries and stop-word lists for two languages. 
  3371.  
  3372.  
  3373.  Toolkit and programming samples 
  3374.            Files for the SearchManager/2 Library Services sample, and for the 
  3375.            SearchManager/2 Retrieval API sample. These are described in IBM 
  3376.            SearchManager/2: Programming Interfaces. 
  3377.  
  3378.  To install the SearchManager/2 single-workstation system: 
  3379.  
  3380.   1. Start an OS/2 session. 
  3381.  
  3382.   2. Insert the Installation diskette into a diskette drive. 
  3383.  
  3384.   3. Make sure that the current drive is the drive containing the installation 
  3385.      program. For example, A: if you install the program from drive A. 
  3386.  
  3387.   4. Type SM2INST at the OS/2 command prompt and press Enter. 
  3388.  
  3389.   5. Follow the instructions on the windows; select Help for more details. The 
  3390.      main installation panel is similar to the one shown in Starting the client 
  3391.      and server installation. 
  3392.  
  3393.   6. When you have finished, restart your operating system. 
  3394.  
  3395.   7. Double-click on the Initialize SearchManager/2 object to start the process 
  3396.      that completes the installation. 
  3397.  
  3398.  
  3399. ΓòÉΓòÉΓòÉ 11.3.4. How SearchManager/2 modifies your CONFIG.SYS ΓòÉΓòÉΓòÉ
  3400.  
  3401. These are the changes that SearchManager/2 makes to your CONFIG.SYS file: 
  3402.  
  3403.  o The directory in which the dynamic link libraries (DLLs) are installed is 
  3404.    added to: 
  3405.  
  3406.     LIBPATH 
  3407.  
  3408.  o The directory in which the product is installed is added to: 
  3409.  
  3410.     SET PATH 
  3411.     SET DPATH 
  3412.     SET HELP 
  3413.  
  3414.  o The following environment variables are added: 
  3415.  
  3416.     EHSDATA: directory for the index and other data files 
  3417.     EHSWORK: directory for temporary files 
  3418.     EHSNLPS: directory for dictionaries 
  3419.     TMP (if not already present): for temporary files, pointing to the same 
  3420.     directory as EHSWORK. 
  3421.  
  3422.  
  3423. ΓòÉΓòÉΓòÉ 11.3.5. Specifying standard settings (global defaults) ΓòÉΓòÉΓòÉ
  3424.  
  3425. Once you have installed SearchManager/2, set up the Global defaults. These are 
  3426. the settings that you want to apply to all queries. 
  3427.  
  3428. Changing them affects only new queries and existing queries that you open after 
  3429. making the change. 
  3430.  
  3431. You can set: 
  3432.  
  3433.  o The language used for queries. 
  3434.  
  3435.    You can change the language selection for individual search terms and 
  3436.    queries. Refer to Selecting a language for a search term, and Setting 
  3437.    defaults for a query. 
  3438.  
  3439.  o Global ("wild-card") characters used when specifying queries. 
  3440.  
  3441.  You can also select global characters for individual queries. Refer to Setting 
  3442.  defaults for a query. 
  3443.  
  3444.  To set the global defaults: 
  3445.  
  3446.  o Select Defaults on the pop-up menu of the SearchManager/2 folder. 
  3447.  
  3448.  
  3449. ΓòÉΓòÉΓòÉ 11.3.6. Setting up the search service for a single-workstation ΓòÉΓòÉΓòÉ
  3450.  
  3451. The SearchManager/2 search service provides you with indexing and retrieval 
  3452. services, such as starting a search, and adding documents to the queue for 
  3453. indexing. It also handles the indexing of documents. You set up a search 
  3454. service so that it runs most efficiently for your system. 
  3455.  
  3456. Figure: The search service on a single-workstation system 
  3457.  
  3458. To set up the search service: 
  3459.  
  3460.   1. Open the SearchManager/2 folder. 
  3461.  
  3462.   2. Select Settings on the pop-up menu of the Search service folder. 
  3463.  
  3464.   3. Select the Definitions section (shown in Defining the local search service 
  3465.      at the server.) 
  3466.  
  3467.  In the Definitions section of the Search service folder you set up the name 
  3468.  and the service parameters of the search service. 
  3469.  
  3470.  Service parameters: Setting up the service parameters for a single-workstation 
  3471.  system is the same as for the server in a client/server system. Refer to 
  3472.  Defining the local search service at the server. The initial values for a 
  3473.  single workstation are: 
  3474.  
  3475.  Max. parallel service tasks:              4 
  3476.  Service tasks kept available:             3 
  3477.  Time limit seconds:                       3600 
  3478.  Task cleanup every ms:                    500. 
  3479.  
  3480.  
  3481. ΓòÉΓòÉΓòÉ 11.3.7. Verifying the SearchManager/2 installation ΓòÉΓòÉΓòÉ
  3482.  
  3483. During installation, you installed several sample documents. Installation 
  3484. verification consists of the following steps: 
  3485.  
  3486.   1. Place sample documents in the document queue for indexing 
  3487.   2. Index the sample documents 
  3488.   3. Search for terms contained in the documents 
  3489.   4. Browse documents to see terms found. 
  3490.  
  3491.  Follow the description of these steps in Getting started, beginning at A brief 
  3492.  look at the indexing process. 
  3493.  
  3494.  
  3495. ΓòÉΓòÉΓòÉ 11.4. Installing dictionaries ΓòÉΓòÉΓòÉ
  3496.  
  3497. You can install the supplied dictionaries while you install SearchManager/2, 
  3498. or, if you decide to do this later, you can install them from the 
  3499. SearchManager/2 installation diskettes. The installation package includes 
  3500. dictionaries for US English and for your local language. 
  3501.  
  3502. Dictionaries for other languages are also available (see Optional IBM licensed 
  3503. programs). 
  3504.  
  3505. To install a dictionary from the SearchManager/2 diskettes: 
  3506.  
  3507.   1. Start an OS/2 session. 
  3508.  
  3509.   2. Insert the first installation diskette into the diskette drive. 
  3510.  
  3511.   3. Make sure that the current drive is the drive containing the installation 
  3512.      program; for example, drive A: if you install from drive A. 
  3513.  
  3514.   4. Type sm2inst at the OS/2 command prompt and press Enter. 
  3515.  
  3516.   5. Follow the instructions on the screen and select the appropriate language 
  3517.      component. Only components not yet installed will be enabled for 
  3518.      installation. 
  3519.  
  3520.      Tip The dictionaries are installed in the path pointed to by the EHSNLPS 
  3521.      environment variable in the CONFIG.SYS file. 
  3522.  
  3523.   6. Press Install... to start the installation. 
  3524.  
  3525.  If you buy additional dictionaries: Install additional dictionaries to the 
  3526.  directory pointed to by the EHSNLPS environment variable in your CONFIG.SYS 
  3527.  file. 
  3528.  
  3529.  If you do not install dictionaries at a client workstation: Deciding where to 
  3530.  install dictionaries describes the possiblity of saving disk space in a 
  3531.  client/server system by installing dictionaries only at the server 
  3532.  workstation. 
  3533.  
  3534.  To ensure that the client can access the file server's dictionaries: 
  3535.  
  3536.  o After installing the Client/2 component, change the EHSNLPS environment 
  3537.    variable in the  client's CONFIG.SYS file to point to the path on which the 
  3538.    dictionaries are installed, then restart your operating system. 
  3539.  
  3540.  If you install dictionaries at a separate file server: Deciding where to 
  3541.  install dictionaries also describes the possiblity of installing the 
  3542.  dictionaries on a file server, rather than at either the client or server 
  3543.  SearchManager/2 workstations. 
  3544.  
  3545.  To ensure that the client and the server can access the file server's 
  3546.  dictionaries: 
  3547.  
  3548.  o After installing both components, change the EHSNLPS environment variable in 
  3549.    the  client's and in the server's CONFIG.SYS file to point to the path on 
  3550.    which the dictionaries are installed. 
  3551.  
  3552.  
  3553. ΓòÉΓòÉΓòÉ 11.5. Installing SearchManager/2 without diskettes ΓòÉΓòÉΓòÉ
  3554.  
  3555. If you have a license to install a component of SearchManager LAN Server/2 and 
  3556. Client/2 on several workstations, you may find it more convenient to do so 
  3557. without using diskettes. 
  3558.  
  3559. These are the steps: 
  3560.  
  3561.   1. Copy the diskettes to a directory on a LAN file server to which all the 
  3562.      workstations have access. 
  3563.  
  3564.   2. At the workstation on which the product is to be installed, access this 
  3565.      directory and enter the command 
  3566.  
  3567.      SM2INST 
  3568.  The installation process then runs the same way as described in Starting the 
  3569.  client and server installation. 
  3570.  
  3571.  You can also automate this process by using SM2INST with a response file. The 
  3572.  steps are the same as above except that when you run the SM2INST program, you 
  3573.  specify parameters including the name of a response file. The response file 
  3574.  contains the data that you would normally enter manually if you were 
  3575.  installing from diskette. This specific response file can include other 
  3576.  general response files. 
  3577.  
  3578.  Here is an example of an SM2INST call, showing all of its parameters. In the 
  3579.  example, SearchManager/2 is being installed from a LAN drive L: to the 
  3580.  workstation's D: drive. The parameters are described in SM2INST.EXE 
  3581.  parameters. 
  3582.  
  3583.   SM2INST options
  3584.  
  3585.   where options are:
  3586.      /A:I                         Install action
  3587.      /C:C:\SM2\EHSINLEN.ICF       Catalog file name
  3588.      /G:L:\SM2                    Path for general response files
  3589.      /L1:C:\SM2\ERROR.LOG         Error log file
  3590.      /L2:C:\SM2\HISTORY.LOG       History log file
  3591.      /P:"SearchManager"           Product name
  3592.      /O:DRIVE                     Source is on disk (origin)
  3593.      /R:L:\SM2\RESPONSE.DAT       Specific response file
  3594.      /S:L:\SM2                    Location of source files
  3595.      /T:D:\SM2                    Target directory
  3596.      /TU:C:\                      Target directory to update CONFIG.SYS
  3597.      /X                           Process non-interactively (log errors)
  3598.  
  3599.  Here is an example of a response file, showing some of its keywords. Refer to 
  3600.  Response files for a description of all the keywords. 
  3601.  
  3602.   * Directory for programs
  3603.   FILE = D:/SM2
  3604.  
  3605.   * Directory for SearchManager/2 data
  3606.   WORK = D:/SM2/DATA
  3607.  
  3608.   * Directory for temporary files
  3609.   AUX1 = D:/SM2/TEMP
  3610.  
  3611.   * Directory for sample documents (SearchManager LAN Server/2 only)
  3612.   AUX2 = D:/SM2/DOCS
  3613.  
  3614.   * Component name
  3615.   COMP = IBM SearchManager Client/2
  3616.  
  3617.   * Component name
  3618.   COMP = Online documentation
  3619.  
  3620.   * Component name
  3621.   COMP = IBM SearchManager LAN Server/2
  3622.  
  3623.   * Update CONFIG.SYS automatically
  3624.   CFGUPDATE = AUTO
  3625.  
  3626.   * Overwrite files
  3627.   OVERWRITE = NO
  3628.  
  3629.  
  3630. ΓòÉΓòÉΓòÉ 11.5.1. SM2INST.EXE parameters ΓòÉΓòÉΓòÉ
  3631.  
  3632. These are the SM2INST command line parameters: 
  3633.  
  3634.  /A:<action> 
  3635.    Required. Specifies the action to be performed, where action is: 
  3636.  
  3637.     D         Delete 
  3638.     I         Install 
  3639.     R         Restore 
  3640.     U         Update 
  3641.  
  3642.    If you specify this parameter, you must also specify the /P parameter. 
  3643.  
  3644.  
  3645.  /C:<catalog file name> 
  3646.    Required. Specifies the name and location of the catalog file that you want 
  3647.    to be opened automatically. A catalog file contains information about the 
  3648.    installed SearchManager/2 components. 
  3649.  
  3650.    These are the catalog file names: 
  3651.  
  3652.       ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3653.       Γöé LANGUAGE    Γöé SEARCHMANAGER LAN SERVER/2   Γöé SEARCHMANAGER/2        Γöé
  3654.       Γöé        Γöé AND CLIENT/2          Γöé                Γöé
  3655.       Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3656.       Γöé English    Γöé "EHSINLEN.ICF"         Γöé "EHSINSEN.ICF"        Γöé
  3657.       Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3658.       Γöé French     Γöé "EHSINLFR.ICF"         Γöé "EHSINSFR.ICF"        Γöé
  3659.       Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3660.       Γöé German     Γöé "EHSINLGE.ICF"         Γöé "EHSINSGE.ICF"        Γöé
  3661.       Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3662.       Γöé Italian    Γöé "EHSINLIT.ICF"         Γöé "EHSINSIT.ICF"        Γöé
  3663.       Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3664.       Γöé Spanish    Γöé "EHSINLSP.ICF"         Γöé "EHSINSSP.ICF"        Γöé
  3665.       ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3666.    A drive and directory must precede the catalog file name. Example: 
  3667.  
  3668.          /C:L:\SM2\EHSINLEN.ICF
  3669.  
  3670.  /G:<include path> 
  3671.    Optional. Specifies the drive and directory of the general response files 
  3672.    that are included by the specific response file. 
  3673.  
  3674.    Example: 
  3675.  
  3676.          /G:L:\SM2
  3677.  
  3678.  /L1:<error log> 
  3679.    Optional. Specifies the drive, path, and file name of the error log file. 
  3680.  
  3681.    If this parameter is not specified, errors are logged to a file called 
  3682.    EHSINSTS.OUT. 
  3683.  
  3684.    Example: 
  3685.  
  3686.          /L1:C:\SM2\ERROR.LOG
  3687.  
  3688.  /L2:<history log> 
  3689.    Optional. Specifies the drive, path, and file name of the history log file. 
  3690.  
  3691.    If drive and path are not specified, the drive and path where EHSINSTS.EXE 
  3692.    is running is used. 
  3693.  
  3694.    If this parameter is not specified, no history log is maintained. 
  3695.  
  3696.    Example: 
  3697.  
  3698.          /L2:C:\SM2\HISTORY.LOG
  3699.  
  3700.  /O:<source environment> 
  3701.    Required. Specifies the source environment (O for origin) of the 
  3702.    installation. 
  3703.  
  3704.    Always set this parameter to DRIVE. 
  3705.  
  3706.  
  3707.  /P:<product name> 
  3708.    Specifies the name of the product. 
  3709.  
  3710.    <product name> must match the value of the NAME keyword of the PACKAGE entry 
  3711.    in the catalog file. See parameter /C. 
  3712.  
  3713.    Example: 
  3714.  
  3715.          /P:"SearchManager LAN Server/2"
  3716.  
  3717.  /R:<response file> 
  3718.    Optional. Specifies the drive, path, and file name of the specific response 
  3719.    file. If /R: is not specified, no response files are used. 
  3720.  
  3721.    The following search order is used to find the response files. 
  3722.  
  3723.      1. The fully qualified file specification 
  3724.      2. The current directory 
  3725.      3. The file name together with the /G: invocation parameter 
  3726.      4. Each directory in the PATH environment variable 
  3727.      5. Each directory in the DPATH environment variable. 
  3728.  
  3729.    Example: 
  3730.  
  3731.          /R:L:\SM2\RESPONSE.DAT
  3732.  
  3733.  /S:<source location> 
  3734.    Optional. Specifies the drive and path that contain the source files to be 
  3735.    installed. 
  3736.  
  3737.    Example: 
  3738.  
  3739.          /S:L:\SM2
  3740.  
  3741.  /T:<target install directory> 
  3742.    Optional. Specifies the drive and path that the product files are to be 
  3743.    installed into. 
  3744.  
  3745.    This parameter determines the directory to be used for installing the 
  3746.    SearchManager program files. If you specify this parameter, the target 
  3747.    install directory specified in the FILE paths of the response files and the 
  3748.    package files is overridden. 
  3749.  
  3750.    Example: 
  3751.  
  3752.          /T:C:\SM2
  3753.  
  3754.  /TU:<update target CONFIG.SYS directory> 
  3755.    Optional. Specifies the drive and path of the target CONFIG.SYS to be 
  3756.    updated. 
  3757.  
  3758.    If you do not specify this parameter, the CONFIG.SYS file on the "boot" 
  3759.    drive is updated. 
  3760.  
  3761.    Example: 
  3762.  
  3763.          /TU:C:\
  3764.  
  3765.  /X 
  3766.    Optional. Specifies that the action is noninteractive. 
  3767.  
  3768.    No progress indicator is shown. Errors caused, for example, by missing 
  3769.    installation information, are logged in the EHSINSTS.OUT file. Specify the 
  3770.    location of this error log file using the /L1 parameter. 
  3771.  
  3772.    If you do not specify this parameter, a progress indicator is shown and 
  3773.    error messages are displayed. You are prompted for any information needed to 
  3774.    complete the action. 
  3775.  
  3776.  
  3777. ΓòÉΓòÉΓòÉ 11.5.2. Response files ΓòÉΓòÉΓòÉ
  3778.  
  3779. Response files are used to provide data that would normally be entered manually 
  3780. when installing from diskette. 
  3781.  
  3782. You can create several response files to cover various installation 
  3783. requirments. Each of these specific response files can be made to include 
  3784. general response files containing common installation data. 
  3785.  
  3786. Each line in a response file has a maximum line length of 255 bytes. 
  3787. Keyword-value pairs used in a response file can be in any order. Keywords are 
  3788. not case-sensitive. 
  3789.  
  3790. Here is list of the response file keywords: 
  3791.  
  3792.  AUX1 
  3793.         Required. Specifies an auxiliary path for installation, in this case 
  3794.         for temporary files. The path for the SearchManager/2 program files is 
  3795.         specified using the FILE keyword. 
  3796.  
  3797.  
  3798.  AUX2 
  3799.         Required. Specifies the path for sample documents (SearchManager LAN 
  3800.         Server/2 only). 
  3801.  
  3802.  
  3803.  CFGUPDATE 
  3804.         Required. Specifies whether the CONFIG.SYS file is automatically 
  3805.         updated. Values for this keyword are: 
  3806.  
  3807.         AUTO: Automatically updates CONFIG.SYS 
  3808.  
  3809.         MANUAL: Does not update CONFIG.SYS 
  3810.  
  3811.  
  3812.  COMP 
  3813.         Required. Specifies the unique name of a component of the product for 
  3814.         which passed information applies. 
  3815.  
  3816.         Note:  Do not use quotes around the component name. 
  3817.  
  3818.  
  3819.  DELETEBACKUP 
  3820.         Required. Specifies whether to delete only the backup versions of the 
  3821.         product or to delete the entire product. If you do not have a backup 
  3822.         version, specify NO. If you have a backup version, specify YES. 
  3823.  
  3824.  
  3825.  FILE 
  3826.         Required. Provides the path for the directory in which the 
  3827.         SearchManager/2 programs are to be installed. 
  3828.  
  3829.  
  3830.  INCLUDE 
  3831.         Specifies which general response files to include with a specific 
  3832.         response file. The format of this keyword is: 
  3833.  
  3834.                   INCLUDE = filespec
  3835.  
  3836.         where filespec is the path and file name of the general response file 
  3837.         to be included. If the file specification contains any global 
  3838.         characters (* or ?), the first file found that matches the 
  3839.         specification is included. 
  3840.  
  3841.         The following search order is used to find the general response files 
  3842.         specified. 
  3843.  
  3844.      1. The fully qualified file specification, if specified with filespec 
  3845.      2. The current directory 
  3846.      3. The file name together with the /G: invocation parameter 
  3847.      4. Each directory in the PATH environment variable 
  3848.      5. Each directory in the DPATH environment variable. 
  3849.  
  3850.  
  3851.  OVERWRITE 
  3852.         Specifies whether to automatically overwrite files during installation. 
  3853.         Values for this keyword are YES and NO. 
  3854.  
  3855.  
  3856.  SAVEBACKUP 
  3857.         Specifies whether to save a backup version of the product when it is 
  3858.         updated. Valid values for this keyword are YES and NO. 
  3859.  
  3860.  
  3861.  WORK 
  3862.         Required. Specifies the path for the data directory for 
  3863.         SearchManager/2's data files. 
  3864.  
  3865.  
  3866. ΓòÉΓòÉΓòÉ 11.6. Deleting components of SearchManager/2 ΓòÉΓòÉΓòÉ
  3867.  
  3868. This section describes how to remove components of SearchManager/2 from your 
  3869. workstation. You are strongly recommended to use the procedure described here 
  3870. rather than trying to delete the product files manually. 
  3871.  
  3872.      Tip Saving index files 
  3873.  
  3874.      When you remove SearchManager LAN Server/2 and Client/2, or the 
  3875.      SearchManager/2 single-workstation system, the document index files are 
  3876.      also deleted. If you want to keep them, save all files having the 
  3877.      extensions DAT and IDX by copying them to a different location. These 
  3878.      files are located in the directory that is pointed to by the EHSDATA 
  3879.      environment variable in your CONFIG.SYS. 
  3880.  
  3881.      After reinstalling, copy the saved index files back to the EHSDATA 
  3882.      directory. 
  3883.  
  3884.   1. Double-click on the Installation utility object in the SearchManager/2 
  3885.      window. 
  3886.  
  3887.   2. Select Delete from the Action menu in the menu bar. 
  3888.  
  3889.   3. Select the component(s) to be deleted. 
  3890.  
  3891.   4. Click on the Delete pushbutton. 
  3892.  
  3893.   5. Follow the instructions on the screen until the message Delete successful 
  3894.      is displayed. 
  3895.  
  3896.   6. Having deleted the component(s), you may have to restart your 
  3897.      workstation's operating system to automatically remove files that were 
  3898.      previously in use. 
  3899.  
  3900.  
  3901. ΓòÉΓòÉΓòÉ 11.7. Moving index files ΓòÉΓòÉΓòÉ
  3902.  
  3903. Sometimes an index grows to the point where it must be moved to a different 
  3904. disk. This section describes how to move the index files. The EHSDATA 
  3905. environment variable in your CONFIG.SYS file points to the directory where the 
  3906. index files are currently installed. 
  3907.  
  3908.  o Create a directory on the disk to which you intend to move the index files. 
  3909.  
  3910.  o The index files are located in the directory pointed to by the EHSDATA 
  3911.    environment variable in your CONFIG.SYS file. Move the entire contents of 
  3912.    this directory to the new directory. 
  3913.  
  3914.  o Change the EHSDATA environment variable to point to the new directory. 
  3915.  
  3916.  o Restart your operating system. 
  3917.  
  3918.  
  3919. ΓòÉΓòÉΓòÉ 12. Linguistic processing ΓòÉΓòÉΓòÉ
  3920.  
  3921. SearchManager/2 offers linguistic processing in the four major areas of 
  3922. retrieval: 
  3923.  
  3924.  o Indexing. When the search service analyzes documents to extract the terms to 
  3925.    be stored in the document index. 
  3926.  
  3927.  o Retrieval. When the search service searches through the document index to 
  3928.    find the names of documents that contain occurrences of the search terms you 
  3929.    have specified. 
  3930.  
  3931.  o Specifying a query. When you specify the search terms for a query. 
  3932.  
  3933.  o Browsing. When you browse a document that has been found after a search. 
  3934.  
  3935.  In indexing, the document text is processed linguistically to extract the 
  3936.  right terms for the index. This is done to make retrieval as simple and as 
  3937.  fast as possible. 
  3938.  
  3939.  In retrieval, the query terms are also processed linguistically to match them 
  3940.  with the indexed terms. 
  3941.  
  3942.  The key to successful retrieval is to use the same linguistic processing for 
  3943.  retrieval as is used in indexing. 
  3944.  
  3945.  
  3946. ΓòÉΓòÉΓòÉ 12.1. Linguistic processing for indexing ΓòÉΓòÉΓòÉ
  3947.  
  3948. When the search service indexes documents, that is, extracts terms to be stored 
  3949. in the document index, it makes a linguistic analysis of the documents. 
  3950.  
  3951. The linguistic processing that SearchManager/2 uses for indexing documents 
  3952. consists of: 
  3953.  
  3954.  o Basic text analysis 
  3955.  
  3956.     - Recognizing words and other text units 
  3957.     - Recognizing terms that contain non-alphanumeric characters 
  3958.     - Changing terms to a standard form (normalization) 
  3959.     - Sentence recognition 
  3960.  
  3961.  o Reducing terms to their base form 
  3962.  o Part-of-speech filtering 
  3963.  o Stop-word filtering 
  3964.  o Splitting compound terms 
  3965.  o Sentence-begin processing 
  3966.  o Dehyphenation. 
  3967.  
  3968.  Here is a summary of how terms are indexed when the index type is linguistic. 
  3969.  
  3970.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3971.   Γöé DOCUMENT TEXT       Γöé TERM IN INDEX     Γöé EXPLANATION        Γöé
  3972.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3973.   Γöé Mouse           Γöé mouse         Γöé Normalization       Γöé
  3974.   Γöé K╨öfer           Γöé kaefer        Γöé              Γöé
  3975.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3976.   Γöé mice            Γöé mouse         Γöé Lemmatization       Γöé
  3977.   Γöé swum            Γöé swim         Γöé              Γöé
  3978.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3979.   Γöé computer-system      Γöé computer-system,   Γöé Decomposition       Γöé
  3980.   Γöé              Γöé computer, system   Γöé              Γöé
  3981.   Γöé Wetterbericht       Γöé wetterbericht,    Γöé              Γöé
  3982.   Γöé              Γöé wetter, bericht    Γöé              Γöé
  3983.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3984.   Γöé a report about all     Γöé report, animal    Γöé Stop-word filtering: stop Γöé
  3985.   Γöé animals          Γöé            Γöé words A, ABOUT, ALL    Γöé
  3986.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3987.   Γöé I drive my car quickly   Γöé drive, car      Γöé Part-of-speech filtering: Γöé
  3988.   Γöé              Γöé            Γöé only nouns, verbs,     Γöé
  3989.   Γöé              Γöé            Γöé adjectives         Γöé
  3990.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3991.  
  3992.  Figure: Term extraction for linguistic index 
  3993.  
  3994.  By comparison, here is a summary of how terms are indexed when the index type 
  3995.  is Precise. 
  3996.  
  3997.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3998.   Γöé DOCUMENT TEXT       Γöé TERM IN INDEX     Γöé EXPLANATION        Γöé
  3999.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4000.   Γöé Mouse           Γöé Mouse         Γöé No normalization      Γöé
  4001.   Γöé K╨öfer           Γöé K╨öfer         Γöé              Γöé
  4002.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4003.   Γöé mice            Γöé mice         Γöé No lemmatization      Γöé
  4004.   Γöé swum            Γöé swum         Γöé              Γöé
  4005.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4006.   Γöé computer-system      Γöé computer-system    Γöé No decomposition      Γöé
  4007.   Γöé Wetterbericht       Γöé Wetterbericht     Γöé              Γöé
  4008.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4009.   Γöé a report about all animalsΓöé report, animal    Γöé Stop-word filtering:    Γöé
  4010.   Γöé              Γöé            Γöé stop words A,       Γöé
  4011.   Γöé              Γöé            Γöé ABOUT, ALL         Γöé
  4012.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4013.   Γöé I drive my car quickly   Γöé drive, car      Γöé No part-of-speech     Γöé
  4014.   Γöé              Γöé quickly        Γöé filtering         Γöé
  4015.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4016.   Γöé Sage mir          Γöé Sage, sage      Γöé Sentence-begin       Γöé
  4017.   Γöé              Γöé            Γöé processing         Γöé
  4018.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4019.  
  4020.  Figure: Term extraction for precise index 
  4021.  
  4022.  
  4023. ΓòÉΓòÉΓòÉ 12.1.1. Basic text analysis ΓòÉΓòÉΓòÉ
  4024.  
  4025. The search service processes these linguistic functions without the need of a 
  4026. dictionary. 
  4027. Recognizing terms that contain non-alphanumeric characters 
  4028.  
  4029. When indexing documents, SearchManager/2 recognizes terms even though they 
  4030. contain non-alphanumeric characters, for example: 
  4031.  
  4032. don't   $14,225.23   mother-in-law   10/22/90
  4033.  
  4034. SearchManager/2 regards the following as part of a term: 
  4035.  
  4036.  o Accents and apostrophes 
  4037.  o Currency signs 
  4038.  o Number separator characters (like "/"). 
  4039.  
  4040.  SearchManager/2 also uses language-specific rules to recognize terms 
  4041.  containing: 
  4042.  
  4043.  o Accented prefixes in Roman languages, such as l'aventure in French 
  4044.  
  4045.  o National formats for dates, time, and numbers 
  4046.  
  4047.  o Contracted forms and alternatives, such as mission/responsibility, indicated 
  4048.    in English using the "/" character 
  4049.  
  4050.  o Trailing apostrophes in Italian words like securita'. It is usual in typed 
  4051.    Italian text, when the character set does not include characters with 
  4052.    accents, to type the accent after the character; for example, ╨░ is typed a'. 
  4053.  
  4054.  Changing terms to a standard form (normalization) 
  4055.  
  4056.  If you specify computer in a query, you will not find a document that contains 
  4057.  Computer unless the search service does some normalization. In this case, the 
  4058.  effect of normalization is that you find the term in the index, regardless of 
  4059.  how you capitalize the word. 
  4060.  
  4061.  Here is an example showing how normalization handles accents: after 
  4062.  normalization, a query containing the word ╨Æcole retrieves a document 
  4063.  containing the word Ecole. 
  4064.  
  4065.  If the search term includes global ("wild-card") characters, normalization is 
  4066.  done before the global characters are processed. Example: B╨ær?er becomes 
  4067.  buer?er. 
  4068.  
  4069.  
  4070.  Recognizing sentences 
  4071.  
  4072.  You can search for terms that occur in the same sentence. To make this 
  4073.  possible, SearchManager/2 analyzes each document during indexing to find out 
  4074.  where each sentence begins and ends. SearchManager/2 looks for a period 
  4075.  followed by a blank character. 
  4076.  
  4077.  Since a period may be part of an abbreviation, however, SearchManager/2 
  4078.  distinguishes between sentences and abbreviations. 
  4079.  
  4080.  
  4081. ΓòÉΓòÉΓòÉ 12.1.2. Reducing terms to their base form (lemmatization) ΓòÉΓòÉΓòÉ
  4082.  
  4083. If you are looking for documents that contain the term mouse, for example, then 
  4084. it is very likely that you also would like to find occurrences of the term 
  4085. mice. 
  4086.  
  4087. SearchManager/2 can reduce terms to their base form for indexing; the term mice 
  4088. would be indexed as mouse. Later, when you use the search term mouse, the 
  4089. document is found. The document is also found if you search for mice. 
  4090.  
  4091. The effect is that you find documents containing information about mice, 
  4092. regardless of which variation of the term mouse occurs in the document, or is 
  4093. used as a search term. 
  4094.  
  4095. In the same way SearchManager/2 can reduce conjugated verbs to their 
  4096. infinitive; bought, for example, becomes buy. 
  4097.  
  4098.  
  4099. ΓòÉΓòÉΓòÉ 12.1.3. Part-of-speech filtering ΓòÉΓòÉΓòÉ
  4100.  
  4101. When SearchManager/2 extracts terms from documents to place them in the 
  4102. document index, it extracts only nouns, verbs, and adjectives; all other parts 
  4103. of speech, such as prepositions and pronouns, are filtered out. This form of 
  4104. filtering can significantly reduce the size of the index. 
  4105.  
  4106. SearchManager/2 uses the dictionary information to determine the part of speech 
  4107. of each term; it does not do any semantic analysis. 
  4108.  
  4109.  
  4110. ΓòÉΓòÉΓòÉ 12.1.4. Stop-word filtering ΓòÉΓòÉΓòÉ
  4111.  
  4112. Stop words are, for example, prepositions and pronouns, words that occur very 
  4113. frequently in documents. Such words that the administrator considers to be 
  4114. irrelevant as search terms can be excluded from indexing and search by adding 
  4115. them to the stop-word list. 
  4116.  
  4117. Stop words must not be multiword terms. 
  4118.  
  4119. Only the exact form as contained in the stop-word list is excluded; other 
  4120. spellings or other variants are not. Stop-word filtering is in effect only when 
  4121. the stop-word list for the language concerned is used. 
  4122.  
  4123.  
  4124. ΓòÉΓòÉΓòÉ 12.1.5. Splitting compound terms (decomposition) ΓòÉΓòÉΓòÉ
  4125.  
  4126. Germanic languages, such as German or Dutch, are rich in compound terms, like 
  4127. Versandetiketten, which means address labels. SearchManager/2 can split such 
  4128. compound terms into their components. 
  4129.  
  4130. Compound terms are always split during indexing. Compound terms are split 
  4131. during searching only on request - the user selects the Any sequence option. 
  4132.  
  4133. The components are found if they occur in any sequence in a document as long as 
  4134. they are contained within one sentence. For example, when searching for the 
  4135. German word Wetterbericht (weather report), a document containing the phrase 
  4136. Bericht ╨æber das Wetter (report about the weather) would also be found. 
  4137.  
  4138. SearchManager/2 tries to split a term if: 
  4139.  
  4140.  o The term's language uses compound terms 
  4141.  
  4142.  o The term has a certain minimum length 
  4143.  
  4144.  o The term is not itself an entry in the dictionary - compounds that are 
  4145.    commonly used like the German word Gesch╨öftsbericht (business report) are in 
  4146.    the dictionary. 
  4147.  
  4148.  If a split is found to be possible, the term's component parts are then 
  4149.  reduced to their base form. 
  4150.  
  4151.  Here are some examples from Danish, German, and Dutch. 
  4152.  
  4153.  Compound term                  Component parts 
  4154.  b╨½rsm╨íglerselskab              b╨½rsm╨íglerselskab 
  4155.                                 b╨½rs 
  4156.                                 m╨ígler 
  4157.                                 selskab 
  4158.  Gewinnstreben                  Gewinnstrebe 
  4159.                                 Gewinn 
  4160.                                 Streben 
  4161.                                 Strebe 
  4162.  probleemkinderen               probleemkind 
  4163.                                 probleem 
  4164.                                 kind 
  4165.  
  4166.  
  4167. ΓòÉΓòÉΓòÉ 12.1.6. Sentence-begin processing ΓòÉΓòÉΓòÉ
  4168.  
  4169. In most languages, the first word in a sentence is written with a leading 
  4170. uppercase letter. In languages like German, however, each noun begins with an 
  4171. uppercase letter. So when SearchManager/2 uses the case of a term to determine 
  4172. the part of speech, the result could be incorrect for the first word in a 
  4173. sentence. 
  4174.  
  4175. To avoid this, SearchManager/2 considers both spellings (uppercase and 
  4176. lowercase) for the first word in a sentence. 
  4177.  
  4178. For example, for a German sentence beginning with Sage, both forms Sage 
  4179. (reduced to the noun Sage) and sage (reduced to the verb sagen) are then 
  4180. considered. 
  4181.  
  4182.  
  4183. ΓòÉΓòÉΓòÉ 12.1.7. Dehyphenation ΓòÉΓòÉΓòÉ
  4184.  
  4185. During the indexing process, dehyphenation is used to normalize words 
  4186. containing a hyphen. 
  4187.  
  4188. If a hyphen has been explicitly typed in a document, dehyphenation does not 
  4189. remove the hyphen from the word during indexing. For example: 
  4190.  
  4191. co-ordination
  4192.  
  4193. is indexed exactly as it is typed. 
  4194.  
  4195. However, if the word-processor inserts a hyphen, the hyphen is removed. For 
  4196. example, if text was formatted by the word processor like this: 
  4197.  
  4198. tainer...
  4199.  
  4200. then the word con- tainer would be normalized to container. 
  4201.  
  4202.  
  4203. ΓòÉΓòÉΓòÉ 12.2. Linguistic processing for retrieval ΓòÉΓòÉΓòÉ
  4204.  
  4205. When searching for documents, that is, looking in the document index for search 
  4206. terms that were specified in a query, the search service makes a linguistic 
  4207. analysis of the query terms. In doing this, the search service uses the same 
  4208. linguistic processing that it uses when indexing documents described in 
  4209. Linguistic processing for indexing. This ensures that terms are indexed and 
  4210. searched for in the same way. 
  4211.  
  4212. The linguistic processing that SearchManager/2 uses for retrieval consists of: 
  4213.  
  4214.  o Basic text analysis 
  4215.  
  4216.     - Recognizing terms that contain non-alphanumeric characters 
  4217.     - Changing terms to a standard form (normalization) 
  4218.  
  4219.  o Reducing terms to their base form 
  4220.  o Splitting compound terms 
  4221.  o Stop-word filtering 
  4222.  o Part-of-speech filtering. 
  4223.  
  4224.  Those that are not listed here do not apply to retrieval: 
  4225.  
  4226.  o Sentence recognition 
  4227.  o Sentence-begin processing 
  4228.  o Dehyphenation. 
  4229.  
  4230.  
  4231. ΓòÉΓòÉΓòÉ 12.3. Linguistic processing when specifying a query ΓòÉΓòÉΓòÉ
  4232.  
  4233. This section describes the linguistic processing that assists you when you are 
  4234. specifying the search terms for a query. 
  4235.  
  4236.  
  4237. ΓòÉΓòÉΓòÉ 12.3.1. Offering synonyms to enrich a query ΓòÉΓòÉΓòÉ
  4238.  
  4239. SearchManager/2 can display synonyms for search terms and phrases. 
  4240.  
  4241. You can choose which synonyms you want to use with your search term. For 
  4242. example, if you specify combine as a search term, and select the synonyms mix 
  4243. and join, SearchManager/2 searches for documents containing combine or mix or 
  4244. join. 
  4245.  
  4246. For the English term combine the synonyms provided are: 
  4247. admix affiliate ally amalgamate associate band bind blend bloc cartel coalesce 
  4248. coalition combination combine commingle commix compound concrete conjoin 
  4249. conjugate connect couple embody faction fuse mingle mix incorporate party 
  4250. integrate pool intermingle relate intermix ring stir join syndicate league 
  4251. trust link unite marry wed meld yoke merge. 
  4252.  
  4253. If you have installed dictionaries for several languages, the list of synonyms 
  4254. contains terms in the language you have chosen. 
  4255.  
  4256.  
  4257. ΓòÉΓòÉΓòÉ 12.3.2. Offering thesaurus terms to enrich a query ΓòÉΓòÉΓòÉ
  4258.  
  4259. If Thesaurus End User System Toolkit/2 has been installed, you can choose terms 
  4260. from a thesaurus to add to your query. Each term that you select from the 
  4261. thesaurus becomes an additional search term that you can link as you would any 
  4262. other search term using operators, like OR, AND, and NOT. This is in contrast 
  4263. to synonyms, which are associated with a particular search term (using an 
  4264. assumed OR operator). 
  4265.  
  4266.  
  4267. ΓòÉΓòÉΓòÉ 12.4. Linguistic processing for browsing ΓòÉΓòÉΓòÉ
  4268.  
  4269. This section describes the linguistic processing that is used when you browse 
  4270. documents that have been found after a search. 
  4271.  
  4272. Linguistic analysis in the SearchManager/2 document browser is done in two 
  4273. stages: 
  4274.  
  4275.   1. Basic text analysis, normalization and term expansion. 
  4276.  
  4277.   2. Extended matching. 
  4278.  
  4279.  
  4280. ΓòÉΓòÉΓòÉ 12.4.1. Basic text analysis, normalization and term expansion ΓòÉΓòÉΓòÉ
  4281.  
  4282. The first stage is done without accessing a dictionary. This is basic text 
  4283. analysis and normalization as described in Basic text analysis. 
  4284.  
  4285. SearchManager/2 can reduce search terms to their base form before the search 
  4286. begins. A document's terms can be reduced to their base form before being added 
  4287. to the document index. Documents are therefore found on the basis of a term's 
  4288. base form. 
  4289.  
  4290. When you browse a found document, however, you expect to see all variants of 
  4291. the base form highlighted. To highlight these variants, SearchManager/2 has to 
  4292. expand the found base term. (This is the inverse of reducing a term to its base 
  4293. form.) 
  4294.  
  4295. SearchManager/2 can produce all variants (inflections) for each term found in 
  4296. the dictionaries. These are the inflections produced for the German word gehen 
  4297. (to go): 
  4298.  
  4299. gegangen  geh    gehe    gehen    gehend  gehest  gehet  gehst
  4300. ging      ginge  gingen  gingest  ginget  gingst  gingt  geht
  4301.  
  4302.  
  4303. ΓòÉΓòÉΓòÉ 12.4.2. Extended matching ΓòÉΓòÉΓòÉ
  4304.  
  4305. The second stage is extended matching. There can be rare occasions when 
  4306. SearchManager/2 finds a document but basic text analysis and normalization is 
  4307. not able to highlight the found term. But extended matching finds even the most 
  4308. obscure matches; see also Using extended matching. 
  4309.  
  4310. Extended matching includes all linguistic processing that is done while 
  4311. linguistically indexing; to do this, SearchManager/2 needs a dictionary on the 
  4312. client for the language of the document to be browsed. 
  4313.  
  4314. These are the occasions when extended matching can find additional matches: 
  4315.  
  4316.  o The search term includes global characters and is an inflection. 
  4317.  
  4318.    SearchManager/2 handles global characters and stem reduction for the search 
  4319.    term and finds the corresponding documents. Text, however, that matches the 
  4320.    specified search criteria is not highlighted. 
  4321.  
  4322.    Example: A document contains the inflected term swam. 
  4323.  
  4324.     - During indexing this term is reduced to swim. 
  4325.  
  4326.     - If the search term is swi*, the above document is found, because the stem 
  4327.       reduction is swim. 
  4328.  
  4329.     - SearchManager/2 highlights only those words that match the term swi*. 
  4330.       This is why the inflected term swam is not highlighted. 
  4331.  
  4332.  o If compound words have been indexed. 
  4333.  
  4334.    When a document in a Germanic language contains a compound word and is 
  4335.    indexed using a linguistic index, the document index retains the parts of 
  4336.    the compound word and the compound word itself. When SearchManager/2 
  4337.    searches for a part of a compound word, the documents containing the 
  4338.    compound word are found, but the word is not highlighted. 
  4339.  
  4340.    Example: A document contains the German word Apfelbaum ("apple tree" in 
  4341.    English). 
  4342.  
  4343.     - During indexing this word is reduced to apfel and baum. 
  4344.  
  4345.     - When the index is searched for the term baum, the term baum and the 
  4346.       document that contains it is found through the index. 
  4347.  
  4348.     - SearchManager/2 highlights only words in the document that match baum, 
  4349.       but finds no occurrences, since the document contains Apfelbaum, but not 
  4350.       Baum. 
  4351.  
  4352.  o If words are hyphenated at the end of a line. 
  4353.  
  4354.    If the hyphen is inserted automatically by a word processor, SearchManager/2 
  4355.    can find and highlight the hyphenated word. If, however, the hyphen is typed 
  4356.    by the user, the documents containing the word are found, but the word is 
  4357.    not highlighted. 
  4358.  
  4359.    Example: A document contains the hyphenated word container, broken at the 
  4360.    end of a line like this: 
  4361.  
  4362.       Another name for a folder is a con-
  4363.       tainer.
  4364.  
  4365.     - During indexing the word is normalized to container. 
  4366.  
  4367.     - When the index is searched for the term container, the term and the 
  4368.       document that contains it is found. 
  4369.  
  4370.     - SearchManager/2 tries to highlight any words in the document that match 
  4371.       container, but finds a match only if the hyphen in con- tainer was 
  4372.       inserted by the text processor, and not typed by a user. 
  4373.  
  4374.  
  4375. ΓòÉΓòÉΓòÉ 12.5. How each language is supported ΓòÉΓòÉΓòÉ
  4376.  
  4377. The following table shows how languages are supported linguistically by 
  4378. SearchManager/2, assuming that a dictionary for that language is installed. If 
  4379. a dictionary is not installed, basic text analysis is nevertheless carried out. 
  4380.  
  4381. Here is a list of the linguistic functions: 
  4382.  
  4383.  Basic text analysis            Dehyphenation 
  4384.  Normalization                  Stop-word filter 
  4385.  Lemmatization                  Part-of-speech filter 
  4386.  Decomposition                  Synonyms 
  4387.  
  4388.  The following languages support all or most of the linguistic functions: 
  4389.  
  4390.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4391.   Γöé LANGUAGE          Γöé DICTIONARY NAME    Γöé              Γöé
  4392.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4393.   Γöé Catalan          Γöé CATALA        Γöé (no decomposition)     Γöé
  4394.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4395.   Γöé Danish           Γöé DANSK         Γöé              Γöé
  4396.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4397.   Γöé Dutch (preferred and    Γöé NEDERLND / AKTUEEL  Γöé              Γöé
  4398.   Γöé modern spelling)      Γöé            Γöé              Γöé
  4399.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4400.   Γöé UK English         Γöé UK          Γöé (no decomposition)     Γöé
  4401.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4402.   Γöé US English         Γöé US          Γöé (no decomposition)     Γöé
  4403.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4404.   Γöé French (national)     Γöé FRANCAIS       Γöé (no decomposition)     Γöé
  4405.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4406.   Γöé French (Canadian)     Γöé CANADIEN       Γöé (no decomposition)     Γöé
  4407.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4408.   Γöé German (national)     Γöé DEUTSCH        Γöé              Γöé
  4409.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4410.   Γöé German (Swiss)       Γöé DSCHWEIZ       Γöé              Γöé
  4411.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4412.   Γöé Italian          Γöé ITALIANO       Γöé (no decomposition)     Γöé
  4413.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4414.   Γöé Norwegian (Bokmal)     Γöé NORBOK        Γöé              Γöé
  4415.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4416.   Γöé Norwegian (Nynorsk)    Γöé NORNYN        Γöé (no synonyms)       Γöé
  4417.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4418.   Γöé Portuguese (national)   Γöé PORTUGAL       Γöé (no decomposition)     Γöé
  4419.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4420.   Γöé Portuguese (Brazilian)   Γöé BRASIL        Γöé (no decomposition)     Γöé
  4421.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4422.   Γöé Spanish          Γöé ESPANA        Γöé (no decomposition)     Γöé
  4423.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4424.   Γöé Swedish          Γöé SVENSK        Γöé              Γöé
  4425.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4426.  
  4427.  Finnish (SUOMI dictionary) supports only: 
  4428.  
  4429.  Basic text analysis 
  4430.  Normalization 
  4431.  Dehyphenation 
  4432.  Stop-word filter. 
  4433.  
  4434.  Icelandic (ISLENSK dictionary) supports only: 
  4435.  
  4436.  Basic text analysis 
  4437.  Normalization 
  4438.  Decomposition 
  4439.  Dehyphenation 
  4440.  Stop-word filter. 
  4441.  
  4442.  
  4443. ΓòÉΓòÉΓòÉ 13. Thesaurus End User System Toolkit/2 ΓòÉΓòÉΓòÉ
  4444.  
  4445. IBM Thesaurus End User System Toolkit/2, program number 5622-081, permits 
  4446. access to thesaurus data. 
  4447.  
  4448. A common use of a thesaurus is simply to find a synonym for a particular word. 
  4449. But Thesaurus End User System Toolkit/2 offers much more; it can help you find 
  4450. not only synonyms, but other related information, such as: 
  4451.  
  4452.  o Hierachical relations: 
  4453.  
  4454.     - Dog is a narrower term of animal 
  4455.     - Dog is a broader term of poodle 
  4456.     - Wheel is part of an automobile 
  4457.     - Rocky Mountains is an instance of mountain regions 
  4458.  
  4459.  o Associative relations: comp 
  4460.  
  4461.     - Dog is associated with pets 
  4462.  
  4463.  o User-defined relations: 
  4464.    With this option the user can define and customize a thesaurus based on very 
  4465.    specific needs; for example, in the car industry, an is made of relationship 
  4466.    can be defined between product parts and the material they are made of. 
  4467.  
  4468.  When Thesaurus End User System Toolkit/2 is installed, a Thesaurus push button 
  4469.  is provided in the Query View of a query object. Using this push button, you 
  4470.  can choose terms from a thesaurus to add to your query. 
  4471.  
  4472.  Each term that you select from the thesaurus is copied into the Search term 
  4473.  fields of your query to become an additional search term that you can link, as 
  4474.  you would any other search term, using operators like OR, AND, and NOT. (This 
  4475.  is in contrast to synonyms, which are associated with a particular search term 
  4476.  using an assumed OR operator.) 
  4477.  
  4478.  To display thesaurus terms: 
  4479.  
  4480.  o In the Query View of a query object, select the Thesaurus push button 
  4481.    (available only when Thesaurus End User System Toolkit/2 has been 
  4482.    installed). 
  4483.  
  4484.  This displays the Thesaurus window. 
  4485.  
  4486.  Figure: Looking up terms in a thesaurus 
  4487.  
  4488.  Using this window, you can choose a thesaurus, and look for terms in the 
  4489.  thesaurus by displaying those terms having a particular: 
  4490.  
  4491.  o Relation to the specified term, such as "narrow term," or 
  4492.  
  4493.  o Relation property to the specified term, such as "hierarchical." 
  4494.  
  4495.  From here you can display the Thesaurus Result window which offers you a list 
  4496.  of terms related to the term you specify. The terms that you select are then 
  4497.  inserted into the Search terms fields of your query. 
  4498.  
  4499.  Figure: Terms found in a thesaurus 
  4500.  
  4501.  
  4502. ΓòÉΓòÉΓòÉ 14. Messages displayed by the SM2 command ΓòÉΓòÉΓòÉ
  4503.  
  4504. When using the SM2 command you may receive a message that is identified by a 
  4505. message number. This appendix gives you help information for these messages. 
  4506.  
  4507. If you need further details refer to Troubleshooting. 
  4508.  
  4509.  EHS0100   An error was detected when starting the search service. The 
  4510.            EHSSVDEM.EXE file was not found. 
  4511.  
  4512.            Explanation: It is possible that the path to this file is incorrect, 
  4513.            or that the file has been deleted or renamed. Check that SET PATH in 
  4514.            your CONFIG.SYS file points to the path that contains the file. 
  4515.  
  4516.  EHS0101   An error was detected when starting the search service. EHSSVDEM.EXE 
  4517.            could not be started. 
  4518.  
  4519.            Explanation: It is possible that the DLL files called by this 
  4520.            program could not be found, or that the EHSSVDEM.EXE file is faulty. 
  4521.            Check that the LIBPATH statement in your CONFIG.SYS file points to 
  4522.            the path that contains the SearchManager/2 DLLs. 
  4523.  
  4524.  EHS0150   An error was detected when starting or stopping the search service. 
  4525.            Stop the search service and start it again. 
  4526.  
  4527.            Explanation: This can happen if there is a problem with the search 
  4528.            service program at the server workstation. Try stopping the search 
  4529.            service from the pop-up menu of the Search service object. Repeat if 
  4530.            this seems to have no effect. If the problem persists, restart your 
  4531.            operating system. 
  4532.  
  4533.  EHS0200   The search service cannot be started. Check the path pointed to by 
  4534.            the environment variable EHSDATA in the CONFIG.SYS file. 
  4535.  
  4536.            Explanation: There are three SearchManager/2 environment variables 
  4537.            in your CONFIG.SYS file: 
  4538.  
  4539.            EHSDATA, EHSWORK, and EHSNLPS. 
  4540.  
  4541.            Check that they are all present. 
  4542.  
  4543.  EHS0210   The data file EHSADMTB.DAT is not found. Check if this file exists. 
  4544.            It should be in the path pointed to by the EHSDATA environment 
  4545.            variable in the CONFIG.SYS file. 
  4546.  
  4547.            Explanation: Either the file could not be found or it is faulty. 
  4548.  
  4549.            Check if this file exists. It should be in the path pointed to by 
  4550.            the EHSDATA environment variable in your CONFIG.SYS file. Check also 
  4551.            that this path does not have read-only status. 
  4552.  
  4553.            If the file is on a LAN server, check that the LAN drive is still 
  4554.            available. 
  4555.  
  4556.            If the problem persists, check whether the disk on which this file 
  4557.            resides is full. 
  4558.  
  4559.  EHS0300   An error was detected when stopping the search service. Reboot the 
  4560.            system and start the service again. 
  4561.  
  4562.            Explanation: This can happen if there is a problem with the search 
  4563.            service program at the server workstation. Try stopping the search 
  4564.            service from the pop-up menu of the Search service object. Repeat if 
  4565.            this seems to have no effect. If the problem persists, restart your 
  4566.            operating system. 
  4567.  
  4568.  EHS0310   An error was detected within the search service. 
  4569.  
  4570.            Explanation: This can happen if there is a problem with the search 
  4571.            service program at the server workstation. Try stopping the search 
  4572.            service from the pop-up menu of the Search service object. Repeat if 
  4573.            this seems to have no effect. If the problem persists, restart your 
  4574.            operating system. 
  4575.  
  4576.  EHS0400   An error was detected when starting the search service. The 
  4577.            EHSCSSRV.EXE file was not found. 
  4578.  
  4579.            Explanation: It is possible that the path to this file is incorrect, 
  4580.            or that the file has been deleted or renamed. Check that the PATH 
  4581.            statement in your CONFIG.SYS file still points to the correct 
  4582.            directory, and that the path it points to contains the file. 
  4583.  
  4584.  EHS0401   An error was detected when starting the search service. EHSCSSRV.EXE 
  4585.            could not be started. 
  4586.  
  4587.            Explanation: It is possible that the DLL files called by this 
  4588.            program could not be found, or that the EHSCSSRV.EXE file is faulty. 
  4589.            Check that the LIBPATH statement in your CONFIG.SYS file points to 
  4590.            the path that contains the SearchManager/2 DLLs. 
  4591.  
  4592.  EHS041x   An error was detected when starting the search service. Stop the 
  4593.            service and start it again. 
  4594.  
  4595.            Explanation: 
  4596.  
  4597.     o Most likely, the name of the search service is incorrect. Open the 
  4598.       Definition section of the Settings notebook of the Search service object, 
  4599.       and check that the Service name field corresponds exacly to the name 
  4600.       specified in the same field at the server workstation. 
  4601.  
  4602.     o It is also possible that the file EHSCXCOM.CFG could not be found or is 
  4603.       faulty. Check if this file exists. It should be in the path pointed to by 
  4604.       the EHSDATA environment variable in your CONFIG.SYS file. If the file is 
  4605.       on a LAN server, check that the LAN drive is still available. 
  4606.  
  4607.     o Maybe one of the communication programs or its DLLs could not be found or 
  4608.       is faulty. Check that the LIBPATH statement in your CONFIG.SYS file 
  4609.       points to the path that contains the SearchManager/2 DLLs, and that the 
  4610.       PATH statement points to the path that contains the SearchManager/2 
  4611.       programs. 
  4612.  
  4613.  
  4614. ΓòÉΓòÉΓòÉ 15. Troubleshooting ΓòÉΓòÉΓòÉ
  4615.  
  4616. This appendix has two main sections: 
  4617.  
  4618.  o Troubleshooting by window 
  4619.  
  4620.  o Troubleshooting when starting the search service 
  4621.  
  4622.  
  4623. ΓòÉΓòÉΓòÉ 15.1. Troubleshooting by window ΓòÉΓòÉΓòÉ
  4624.  
  4625. This section is arrranged by window. Refer to the item that describes the 
  4626. window you were using when the problem occurred. It begins with a general part 
  4627. describing symptoms that are not related to one particular window. 
  4628.  
  4629.  
  4630. ΓòÉΓòÉΓòÉ 15.1.1. Any window ΓòÉΓòÉΓòÉ
  4631.  
  4632.  In a client/server system, the connection to the server workstation is lost. 
  4633.      It is possible that the search service at the server workstation has 
  4634.      broken the connection to this client. 
  4635.  
  4636.      One of the service parameters that are set for each search service is the 
  4637.      maximum time that each service task is allowed to run. This is to prevent 
  4638.      unreasonably long tasks, in particular long searches, or even error 
  4639.      situations, from reducing the overall system performance. The recommended 
  4640.      minimum for this parameter is 1200 seconds, that is 20 minutes. After this 
  4641.      time has elapsed, the search service breaks its connection to the client. 
  4642.  
  4643.      Normally, you are unaware of this interruption; when you continue to work 
  4644.      with this window SearchManager/2 automatically restarts the connection to 
  4645.      the search service. 
  4646.  
  4647.      If, however, the connection is not automatically restarted: 
  4648.  
  4649.     o Close the window that was active and then open it again. SearchManager/2 
  4650.       tries to reestablish the connection to the search service. 
  4651.  
  4652.     o Check that the Time limit parameter has been set to a reasonable value. 
  4653.       It is defined at the server workstation, in the Definition section of the 
  4654.       Settings notebook for the Search service object. 
  4655.  
  4656.     o Check that no other task being handled by the search service is 
  4657.       preventing your add-to-queue task from being completed in a reasonable 
  4658.       time. 
  4659.  
  4660.  
  4661.  The system locks. 
  4662.      This may occur under extreme conditions, in particular in a 
  4663.      single-workstation system, or in a client/server system when you search 
  4664.      using the same workstation on which the search service is installed. 
  4665.  
  4666.      Restart your system and try: 
  4667.  
  4668.     o Reducing the number of applications that are running simultaneously. 
  4669.  
  4670.     o Reducing the number of queries that are being processed simultaneously. 
  4671.  
  4672.     o Reducing the number of queries that are open simultaneously. 
  4673.  
  4674.     o Reducing the amount of time that you let periodic indexing run (not the 
  4675.       periodic indexing interval) without the system being shut down and 
  4676.       restarted. 
  4677.  
  4678.     o Checking whether a search you are making results in an extreme number of 
  4679.       matches. If so, try modifying it to narrow the search. 
  4680.  
  4681.  
  4682.  In a client/server system, the connection to the server is lost, and any 
  4683.  sessions using that connection lock up. No message is displayed to inform you. 
  4684.      This is normal if the communication type is TCP/IP. 
  4685.  
  4686.      In this case, whenever the server workstation is unexpectedly no longer 
  4687.      available, a message is not displayed until two hours after communication 
  4688.      is interrupted. 
  4689.  
  4690.      If your system communicates using OS/2 named pipes, you are informed 
  4691.      almost immediately by a message when communication to the server is 
  4692.      interrupted. 
  4693.  
  4694.  
  4695.  In a client/server system, you are experiencing communication problems that 
  4696.  need the attention of an IBM service representative. 
  4697.      In this case, the solution comes from IBM, but you can assist by providing 
  4698.      trace information when you report the problem. This trace information is 
  4699.      in two files: 
  4700.  
  4701.     o servicename.LOG is the server trace file 
  4702.     o EHSCCTRC.LOG is the client trace file. 
  4703.  
  4704.      These files are in the path pointed to by the EHSWORK environment variable 
  4705.      in your CONFIG.SYS file. 
  4706.  
  4707.  
  4708.  In a client/server system, when you open a SearchManager/2 window after 
  4709.  restarting your operating system, the message INI file not found  is 
  4710.  displayed. 
  4711.      It is possible that you no longer have access to the disk on which the 
  4712.      SearchManager/2 data files are installed. Check which disks are available 
  4713.      to you on the LAN and, if necessary, restore the connection to the 
  4714.      required disk. 
  4715.  
  4716.  
  4717. ΓòÉΓòÉΓòÉ 15.1.2. Add to Queue window ΓòÉΓòÉΓòÉ
  4718.  
  4719.  In a client/server system, your local drives are not displayed in the Groups 
  4720.  list. 
  4721.      This is normal. Only those drives are displayed to which the search 
  4722.      service has access. If you were to try to place any of your local 
  4723.      documents in the queue, the search service would not be able to access 
  4724.      them for indexing. 
  4725.  
  4726.  
  4727.  In a client/server system, you are trying to select a drive that belongs to a 
  4728.  server workstation that is currently not active. It takes time before the 
  4729.  system informs you. 
  4730.      This is normal. The LAN requester tries several times to get a response 
  4731.      from the server before informing you that the server is not active. 
  4732.  
  4733.  
  4734. ΓòÉΓòÉΓòÉ 15.1.3. Browser window ΓòÉΓòÉΓòÉ
  4735.  
  4736.  It takes time before the document text is displayed. 
  4737.      If the document contains a paragraph that is particularly large, it is 
  4738.      normal for the display of the document to be delayed to some extent. 
  4739.  
  4740.  
  4741.  You are using a monochrome monitor, and are having difficulty seeing 
  4742.  highlighted text like matches. 
  4743.      Change the color settings through the Options choice in the menu bar. 
  4744.  
  4745.  
  4746. ΓòÉΓòÉΓòÉ 15.1.4. Query View window - Defaults section ΓòÉΓòÉΓòÉ
  4747.  
  4748.  In a client/server system, you are trying to work with document groups that 
  4749.  are stored on a server workstation that is currently not active. It takes time 
  4750.  before the system informs you. 
  4751.      This is normal. The LAN requester tries several times to get a response 
  4752.      from the server before informing you that the server is not active. 
  4753.  
  4754.  
  4755.  In a client/server system, your local document groups are not displayed in the 
  4756.  Restrict to document groups list. 
  4757.      This is normal. You can restrict your search only to those document groups 
  4758.      to which the search service has access. 
  4759.  
  4760.  
  4761. ΓòÉΓòÉΓòÉ 15.1.5. SearchManager folder ΓòÉΓòÉΓòÉ
  4762.  
  4763.  When you open the SearchManager folder, the Search service object is not 
  4764.  visible. 
  4765.      It is possible that the Search service object is scrolled out of sight. 
  4766.  
  4767.      To correct this: 
  4768.  
  4769.      1. Click the right-hand mouse button anywhere within the SearchManager 
  4770.         open folder to display the folder's pop-up menu. 
  4771.  
  4772.      2. Select Arrange. If you are working with a client/server system, it is 
  4773.      possible that the window needs to be refreshed. To do this: 
  4774.  
  4775.      1. Click the right-hand mouse button anywhere within the SearchManager 
  4776.         open folder to display the folder's pop-up menu. 
  4777.  
  4778.      2. Select Refresh. 
  4779.  
  4780.  
  4781. ΓòÉΓòÉΓòÉ 15.2. Troubleshooting when starting a search service ΓòÉΓòÉΓòÉ
  4782.  
  4783. If an error occurs when starting a search service, try to solve it using the 
  4784. information displayed by the SM2 command (see Messages displayed by the SM2 
  4785. command), or by using the information that is displayed after selecting Start 
  4786. on the pop-up menu of the Search service folder. 
  4787.  
  4788. If these methods do not lead to a solution, you can display more detailed 
  4789. diagnosis information by entering the following command in an OS/2 session at 
  4790. the workstation where the search service is installed: 
  4791.  
  4792.  o EHSCSSRV servicename 
  4793.  
  4794.  where servicename is the name specified in the Definitions page of the Search 
  4795.  service object. 
  4796.  
  4797.  This command may display the following information: 
  4798.  
  4799.  1303  TCP_INSTALL_PROBLEM 
  4800.            Explanation: You are using TCP/IP, but the TCP/IP installation is 
  4801.            faulty. Check that TCP/IP is installed correctly. 
  4802.  
  4803.  
  4804.  1307  SERVICE_IS_REMOTE 
  4805.            Explanation: You tried to start a search service located on a 
  4806.            different machine. 
  4807.  
  4808.  
  4809.  1325  INV_PARMS_ERROR 
  4810.            Explanation: The command has not been entered correctly. 
  4811.  
  4812.  1305  INIT_FAILED 
  4813.  1312  DOSEXECPGM_ERROR 
  4814.  1316  CFG_FILE_OPEN_ERROR 
  4815.  1318  CFG_FILE_READ_ERROR 
  4816.  1319  CFG_FILE_CLOSE_ERROR 
  4817.  1320  DOSLOAD_COM_METHOD_ERROR 
  4818.  1323  OPENTRACE_ERROR 
  4819.  1350  CFG_SERVER_NOT_FOUND_ERROR 
  4820.  1398  INV_COMTYPE_ERROR 
  4821.            Explanation: These problems may be due to your environment; it is 
  4822.            possible that there is an error in your CONFIG.SYS file. Check the 
  4823.            following points. If the problem persists, restart your operating 
  4824.            system. If SearchManager/2 files are faulty or missing, reinstall 
  4825.            SearchManager/2. Remember to save your index files before 
  4826.            reinstalling SearchManager/2; refer to Deleting components of 
  4827.            SearchManager/2. 
  4828.  
  4829.            Check that the PATH statement points to the directory that contains 
  4830.            the SearchManager/2 programs. 
  4831.  
  4832.            Check that the LIBPATH statement points to the directory that 
  4833.            contains the SearchManager/2 DLLs. 
  4834.  
  4835.            Check that the EHSDATA environment variable points to the directory 
  4836.            that contains the SearchManager/2 data file EHSCXCOM.CFG. 
  4837.  
  4838.            Check that the EHSDATA environment variable points to a directory 
  4839.            that has sufficient free space available. If not, you should move 
  4840.            your document index files to a different disk. Refer to Moving index 
  4841.            files. 
  4842.  
  4843.            Check that the EHSWORK environment variable points to a directory 
  4844.            that has sufficient free space available. 
  4845.  
  4846.            If the EHSDATA or EHSWORK environment variable in your CONFIG.SYS 
  4847.            file points to a directory on a LAN file server, make sure that the 
  4848.            file server is available and that you have write access to the 
  4849.            directory. 
  4850.  
  4851.  1301  MAX_FILE_HANDLE_ERROR 
  4852.  1306  BEGTHREAD_ERROR 
  4853.  1308  DOSPOSTSEM_ERROR 
  4854.  1310  DOSKILLPROC_ERROR 
  4855.  1311  DOSWAITCHILD_ERROR 
  4856.  1314  CONNECTOR_DOSPOSTSEM_ERROR 
  4857.  1321  DOSQRY_PROCADR_ERROR 
  4858.  1322  SHARED_MEM_ERROR 
  4859.  1326  CREATEMEMSEM_ERROR 
  4860.  1327  CREATETASKSEM_ERROR 
  4861.  1328  CREATECLIENTSEM_ERROR 
  4862.  1329  CONNECTOR_DOSCLOSESEM_ERROR 
  4863.  1330  MAIN_DOSCLOSESEM_ERROR 
  4864.  1340  CLOSECLIENTSEM_ERROR 
  4865.  1360  CONNECTOR_FREETASKSEM_ERROR 
  4866.  1370  CXCLOSE_ERROR 
  4867.  1380  CXCREATE_ERROR 
  4868.  1390  CXDISCONN_ERROR 
  4869.  1395  OPENFREETASKSEM_ERROR 
  4870.  1397  SETPRIORITY_ERROR 
  4871.  1398  INV_COMTYPE_ERROR 
  4872.  1399  RESETTASKSEM_ERROR 
  4873.            Explanation: The above problems may be due to resource constraints 
  4874.            on your workstation. 
  4875.  
  4876.      1. Close some applications. 
  4877.  
  4878.      2. Check that the drive that contains the SWAPPER.DAT file has sufficient 
  4879.         free space available. 
  4880.  
  4881.      3. Restart your operating system. 
  4882.  
  4883.  
  4884. ΓòÉΓòÉΓòÉ 16. Some books you may need ΓòÉΓòÉΓòÉ
  4885.  
  4886.  o IBM SearchManager Client/DOS for Windows: Information Retrieval, SH12-6070 
  4887.  
  4888.  o IBM SearchManager/2: Programming Interfaces, SH12-5987 
  4889.  
  4890.