home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Product / Product.zip / sm2try.zip / HOWTOUSE.DOC < prev    next >
Text File  |  1994-11-14  |  37KB  |  912 lines

  1.    ┌────────────────────────────────────────────────────────────────────────┐
  2.    │ This document is intended for display in a monospaced font. If the box │
  3.    │ around this text is not properly aligned, you should change the font.  │
  4.    │ For example, if you are using the OS/2 System Editor, select 'Set font'│
  5.    │ from the 'Options' menu and choose the System Monospaced font.         │
  6.    └────────────────────────────────────────────────────────────────────────┘
  7.  
  8.    How to use the SearchManager/2 "Try Out" Version
  9.    ================================================
  10.  
  11.    This description helps you to get the most out of the SearchManager/2
  12.    "Try Out" version. By following these steps, you quickly become familiar
  13.    with SearchManager/2's powerful features and with the associated product
  14.    Thesaurus End User System Toolkit/2.
  15.  
  16.    The description is in two parts:
  17.  
  18.    Part 1 A scenario to demonstrate the main features of SearchManager/2.
  19.           This part helps you become familiar with what SearchManager/2
  20.           can do and how to use it.
  21.  
  22.    Part 2 Several short demonstrations of selected features to highlight
  23.           SearchManager/2's strengths in particular areas.
  24.  
  25.    Before you begin, it may be helpful to read the READ.ME file located
  26.    in the directory where you installed SearchManager/2. This file contains
  27.    information about the SearchManager family of products and some
  28.    last-minute information about this "Try Out" version.
  29.  
  30.    Contents:
  31.    --------
  32.  
  33.    Part 1 - A quick tour of SearchManager's main features
  34.  
  35.       1 - The scenario
  36.       2 - Preparing the demo
  37.       3 - Searching for documents: simple searches
  38.       4 - Searching for documents using phrases
  39.       5 - Searching for documents using synonyms and a thesaurus
  40.       6 - Creating and searching for a new document
  41.       7 - Closing the scenario.
  42.  
  43.    Part 2 - A demonstration of selected features
  44.  
  45.       8 - Finding terms using linguistic features
  46.       9 - Excluding documents that contain a particular term
  47.      10 - Using synonyms
  48.      11 - Working with "hypermedia"
  49.      12 - Restricting the search to a group of documents
  50.      13 - Indexing a document
  51.      14 - Using a word processor for displaying found documents
  52.  
  53.  
  54.    Part 1 - A quick tour of SearchManager's main features
  55.    ======================================================
  56.  
  57.    This "Try-Out" version of SearchManager/2 is a version of the original
  58.    SearchManager/2 program. So you can work with it in the same way as with
  59.    the product itself. You are limited only in the number of documents that
  60.    you can work with. You are restricted to searching in 50 documents.
  61.  
  62.    ┌──────────────────┐
  63.    │ 1 - The scenario │
  64.    └──────────────────┘
  65.  
  66.    You are the manager of the company Test & Compare. The company tests
  67.    computers and writes articles about them for PC magazines. The
  68.    manufacturer Big Elephant has delivered a new PC for testing. You ask
  69.    Harry Testman, one of your employees, to write a report about it for the
  70.    'Hardware Examiner' magazine.
  71.  
  72.    ┌────────────────────────┐
  73.    │ 2 - Preparing the demo │
  74.    └────────────────────────┘
  75.  
  76.    You do this only once after installation. So far, you have opened
  77.    the SearchManager/2 folder which includes:
  78.  
  79.       - Retrieval and Indexing (the complete User's Guide)
  80.       - How to use the "Try Out" version (this document)
  81.       - Installation Utility
  82.       - Ordering the original product
  83.       - Search Service.
  84.  
  85.    a) Open the Search Service object:
  86.  
  87.       Double-click on the Search Service object.
  88.       It opens, containing:
  89.  
  90.       - Document index
  91.       - Query
  92.       - Sample documents
  93.       - Demo documents.
  94.  
  95.    b) Index the Sample documents and the Demo documents:
  96.  
  97.       (If you automatically indexed these documents during
  98.       installation, you can skip the rest of this section
  99.       and continue reading from Section 3.)
  100.  
  101.       Drag the 'Sample documents' object and drop it on the
  102.       'Document index'. To do this, position the mouse pointer
  103.       on the 'Sample documents' object, press and hold the
  104.       right mouse button, drag the object over the
  105.       'Document index' object, and then release the button.
  106.  
  107.       A window appears that shows a list of document names.
  108.       Press the 'Queue' button on that window. The window
  109.       disappears after a short time, and the documents are
  110.       now added to a queue for indexing.
  111.  
  112.       Repeat this using the 'Demo documents' object.
  113.  
  114.    c) Display information about the document queue:
  115.  
  116.       Use the right mouse button to open the pop-up menu of the
  117.       'Document Index' object. Select 'Administration' on that menu.
  118.  
  119.       The administration notebook appears. The first page ('Explicit')
  120.       shows the number of documents in the index queue.
  121.  
  122.    d) Index the queued documents:
  123.  
  124.       Press the 'Index >>' button and press 'OK' on the confirmation
  125.       message that appears. The documents now start to be indexed.
  126.  
  127.       After a short time (a half a minute on faster systems, several
  128.       minutes on slower systems), press the 'Refresh' button. Indexing
  129.       has finished when the number of documents in the queue is zero.
  130.       If this is not the case, wait for a short time, then press the
  131.       Refresh button again.
  132.  
  133.       Documents are indexed to make searching through large numbers of
  134.       documents faster. Indexing is often done at night because it is a
  135.       time-consuming process.
  136.  
  137.    e) When indexing has finished, close the Administration notebook.
  138.  
  139.    ┌──────────────────────────────────────────────┐
  140.    │ 3 - Searching for documents: simple searches │
  141.    └──────────────────────────────────────────────┘
  142.  
  143.    If you did not follow the steps in Section 2, open the
  144.    'SearchManager/2' folder and the 'Search Service' folder now.
  145.  
  146.    Let's come back to the scenario...
  147.    Harry Testman wants to search for reports about the style and
  148.    design of other PCs:
  149.  
  150.    a) Open a query:
  151.  
  152.       Double-click on the 'Query' object in the 'Search Service'
  153.       folder. The 'Query View' opens.
  154.  
  155.       The 'Query View' contains entry fields for search terms and for
  156.       operators (to the left of the search-term fields), and it contains
  157.       a group of options (to the right of the search-term fields). These
  158.       options apply to the search-term field where the cursor is positioned
  159.       and can be different for each search term.
  160.  
  161.    b) Search for documents containing the word "style":
  162.  
  163.       Type the word "style" in the first entry field, then press the 'Search'
  164.       button. The 'Results View' of the 'Query' object opens showing that the
  165.       search is in progress. After a few seconds, document objects are
  166.       displayed. (The first query takes a little longer than other queries
  167.       because of initial processing.)
  168.  
  169.    c) Display the text of one of the found documents:
  170.  
  171.       Double-click on the document 'SF201092.DOC'. The SearchManager
  172.       document browser appears. The word "styling" is highlighted to
  173.       emphasize that it was a search term.
  174.  
  175.       If you need to change the font size, select 'Options' from the
  176.       menu bar, then select 'Set font...'.
  177.  
  178.       Place the cursor on the highlighted word "styling". Do this manually
  179.       by positioning the cursor on the word or click on the 'Next match'
  180.       button. Press the 'Explain' button. A message window appears giving
  181.       the reason why the word was found. In this case the reason is obvious,
  182.       but there can be occasions when it may not be.
  183.  
  184.       Close the message window.
  185.  
  186.    d) Search for documents containing the words "style" or "design":
  187.  
  188.       Select the 'Query View' window again.
  189.       Note: The 'Browser' and the 'Results View' window can be left open;
  190.             they will be reused with the next query.
  191.  
  192.       Type "design" in the second entry field. Press the 'Search'
  193.       button. The 'Results View' now shows more documents.
  194.       Double-click on the document 'DT130993.DOC', then use the
  195.       'Next match' button to display some of the matches.
  196.  
  197.    e) Search for words containing the characters "comp":
  198.  
  199.       Select the 'Query View' window again, then press the 'Clear'
  200.       button to remove the words that you typed earlier.
  201.  
  202.       Type "*comp*" in the first entry field, then press the 'Search'
  203.       button. The '*' character is used as a masking symbol (or wild-card
  204.       character) for a part of a word.
  205.  
  206.       Browse some of the found documents to see which terms qualified for the
  207.       masked term "*comp*".
  208.  
  209.     f) Browsing more than one document at a time:
  210.  
  211.        Each time you select a different document, it is displayed in place
  212.        of the previous one -- only one document is displayed at a time.
  213.        However, if you prefer to browse more than one document at a time,
  214.        open the 'Options' menu from the menu bar of the 'Results View'
  215.        and select 'Use browser'. Now each time you select a different document,
  216.        it is displayed in a separate browser window.
  217.  
  218.    ┌────────────────────────────────────────────┐
  219.    │ 4 - Searching for documents using phrases  │
  220.    └────────────────────────────────────────────┘
  221.  
  222.    The second task for Harry Testman is to compare the new computer
  223.    with previously tested ones concerning price and performance.
  224.    Harry finds that the new PC has a very high performance for a
  225.    low price, so he wants to read reports about PCs with similar
  226.    characteristics.
  227.  
  228.    a) Search for "high performance" and "low price":
  229.  
  230.       Redisplay the 'Query View' window. If the entry fields contain search
  231.       terms press the 'Clear' button to clear the window.
  232.  
  233.       Type "high performance" in the first entry field, and "low price"
  234.       in the second entry field. Open the operator list to the left of the
  235.       second search term field (click on the arrow to the right of the
  236.       operator) and select the 'and' operator. If you prefer to use the
  237.       keyboard to select an operator, use the Tab key to move to the operator
  238.       field and then use the up-arrow and down-arrow keys.
  239.  
  240.       The Query now looks like this:
  241.  
  242.                high performance
  243.          and   low price
  244.  
  245.       Press the 'Search' button.
  246.  
  247.       Double-click on the test report for the Blackdog computer. You see
  248.       "lowest price" and "high performance" highlighted.
  249.  
  250.    But Harry Testman knows that there are more computers with a low
  251.    price and a high performance. He searched for "high performance" and
  252.    "low price" as phrases, so SearchManager looked only for documents where
  253.    the word "high" is followed immediately by the word "performance", and
  254.    where "low" (or, in our case, an inflection of it) is followed by "price".
  255.  
  256.    b) To find those terms in any order within one sentence:
  257.  
  258.       Redisplay the 'Query View' window.
  259.  
  260.       Select the option 'Any sequence', first for the first phrase, and then
  261.       for the second phrase. (To do this, position the cursor in the entry
  262.       field containing "high performance", then select the option
  263.       'Any sequence' to the right of the window. Next, position the cursor in
  264.       the entry field containing "low price", and do the same.)
  265.  
  266.       Press the 'Search' button to repeat the search. You find more
  267.       documents.
  268.  
  269.    c) To display an image within a document:
  270.  
  271.       Double-click on document DT130993.DOC to display it.
  272.  
  273.       Position the cursor on the image tag "IMAGE: tiger.met" near the top
  274.       of the document.
  275.  
  276.       Press the 'Hypermedia' button. Picture Viewer opens, showing
  277.       the image of a tiger.
  278.  
  279.       Note: In some systems, Picture Viewer comes up behind other windows.
  280.             Display it by selecting the document name from your Window List.
  281.             If the picture viewer does not appear at all, or it cannot
  282.             display the image, refer to the READ.ME file in the product
  283.             directory.
  284.  
  285.       Close the Picture Viewer window.
  286.  
  287.    ┌─────────────────────────────────────────────────────────────┐
  288.    │ 5 - Searching for documents using synonyms and a thesaurus  │
  289.    └─────────────────────────────────────────────────────────────┘
  290.  
  291.    The next task for Harry Testman is to compare the new computer
  292.    with previously tested machines from the manufacturer Big Elephant.
  293.    So he wants to find all reports about those PCs.
  294.  
  295.    a) Search for "Big Elephant":
  296.  
  297.       Redisplay the 'Query View' window.
  298.  
  299.       Press the 'Clear' button to clear any text that you have typed.
  300.       Note: This action not only clears the window, but it also returns
  301.             all options (such as 'Any sequence') to their initial values.
  302.  
  303.       Type "Big Elephant" in the first entry field and press 'Search'.
  304.  
  305.       Some of the documents are called "Animal Encyclopedia", but this
  306.       is not the type of document Harry Testman wants to find. He is
  307.       not searching for an animal, but for the company Big Elephant.
  308.  
  309.    b) Search for "Big Elephant" and "company":
  310.  
  311.       Redisplay the 'Query View' window. Enter "company" in the second
  312.       entry field.
  313.  
  314.       For the operator to the left of the second entry field, select 'and'.
  315.       The query now looks like this:
  316.  
  317.                Big Elephant
  318.           and  company
  319.  
  320.       Press 'Search'. You find no documents.
  321.  
  322.    Harry Testman is surprised about the result, but knows that
  323.    SearchManager has some functions to support him in building his
  324.    query and specifying the right search terms.
  325.  
  326.    c) Search for "Big Elephant" and synonyms of "company":
  327.  
  328.       Redisplay the 'Query View' window. Position the cursor in the
  329.       entry field containing the term "company".
  330.  
  331.       Press the 'Synonyms' button. A window appears containing a list of
  332.       synonyms for the term "company".
  333.  
  334.       Select the words "corporation", "enterprise" and "firm".
  335.  
  336.       Press 'OK'. The selected synonyms are displayed in a list on the right-
  337.       hand side of the 'Query View' window.
  338.  
  339.       Press the 'Search' button. Instead of looking only for "company",
  340.       SearchManager now looks for "company" OR "firm" OR "corporation" OR
  341.       "enterprise".
  342.  
  343.    Harry has found more documents than he wants to view. He wants to make
  344.    the query more specific. The information sheet that describes the PC
  345.    says that it is a 486 PC. Harry remembers that the information about
  346.    the companies and the products that have been tested by Test & Compare
  347.    are modelled and stored in a thesaurus. He tries to find names related
  348.    to Big Elephant PCs in that thesaurus...
  349.  
  350.    d) Use a thesaurus to add a search term:
  351.  
  352.       Redisplay the 'Query View' window. Position the cursor in the
  353.       entry field containing "Big Elephant". (Ensure that the term is
  354.       capitalized as shown -- the thesaurus data is case-sensitive.)
  355.       Press the 'Thesaurus' button. The 'Thesaurus' window appears.
  356.  
  357.       Select the thesaurus 'Demo Thesaurus' in the drop down list at
  358.       the bottom right of the window if it is not already selected.
  359.       A list of relations is displayed.
  360.  
  361.       Select the relation 'product sets'. The list to the right now shows the
  362.       relation property of the selected relation (unidirectional).
  363.  
  364.       Press the 'Show' button. The 'Thesaurus Result' window appears
  365.       containing a list of terms.
  366.  
  367.       Select the term "Cache 486DX2" and press the 'Add to Query' button.
  368.       Now redisplay the 'Query View' window to see that the term is added
  369.       to the query.
  370.  
  371.       Close both thesaurus windows.
  372.  
  373.       (If you would like to know more about the use of a thesaurus and how
  374.       you can create the demo thesaurus included in this "Try Out" version,
  375.       order the Thesaurus Administrator/2 product. The order number of the
  376.       demo version of Thesaurus Administrator/2 is GK10-2008.)
  377.  
  378.       Select the operator 'and' for the new search term. The query now
  379.       looks like this:
  380.  
  381.               Big Elephant
  382.         and   company       (with synonyms)
  383.         and   Cache 486DX2
  384.  
  385.       Press the 'Search' button. You find these documents:
  386.          BE210893.WPT a WordPerfect document
  387.          BE220893.DOC an ASCII document.
  388.          BE230893.SAM an Ami Pro document
  389.          BE240893.LWP an IBM Works document
  390.  
  391.    e) Display a document using an editor or a word processor:
  392.  
  393.       Using the right mouse button, click on the document BE220893.DOC
  394.       to display its pop-up menu. On this menu, click on the arrow
  395.       beside the 'Open' entry. The submenu that opens should contain
  396.       these entries:
  397.  
  398.         - Browser
  399.         - Common browser
  400.         - OS/2 System Editor
  401.  
  402.       (If you click on one of the other documents, and the corresponding
  403.       program, Ami Pro, Word Perfect, or IBM Works is installed and
  404.       associated with this document type, then, instead of the OS/2 System
  405.       Editor, the name of the corresponding word-processor program is
  406.       displayed in the pop-up menu.)
  407.  
  408.       Click on 'OS/2 System Editor'. The Editor window opens and the
  409.       document content is displayed.
  410.  
  411.    ┌───────────────────────────────────────────────┐
  412.    │ 6 - Creating and searching for a new document │
  413.    └───────────────────────────────────────────────┘
  414.  
  415.    Harry Testman now creates the test report for the new PC. He does not
  416.    create a new document, but instead he uses the one he has just found
  417.    as a template.
  418.  
  419.    a) Change and save the found document:
  420.  
  421.       You have already opened the editor to display the document
  422.       BE220893.DOC.
  423.  
  424.       Note: If you did not follow the steps in Section 5, start the
  425.             OS/2 System Editor and open the file BE220893.DOC which is
  426.             located in the directory \SM2\DEMO on the drive where you
  427.             installed the SearchManager "Try Out" version.
  428.  
  429.       Add some text to the document and change the model type to
  430.       "east africa 486".
  431.  
  432.       Open the 'File' menu and select 'Save as...' to save the document
  433.       as 'NEWDOC.DOC'.
  434.  
  435.       Close the OS/2 System Editor.
  436.  
  437.    b) Redisplay the 'Search Service' folder:
  438.  
  439.       Close or minimize the 'Browser', 'Query View' and 'Results View'
  440.       windows if they are open. Redisplay the 'Search Service'
  441.       folder.
  442.  
  443.    c) Add a new document to the document queue for indexing:
  444.  
  445.       Double-click on the 'Demo documents' object to open that folder
  446.       object. Find the 'NEWDOC.DOC' object.
  447.  
  448.       Drag this document and drop it on the 'Document index' object
  449.       as you did with the 'Demo documents' object in Section 2.
  450.  
  451.       The 'Add to queue' window appears, showing one document name.
  452.       Press the 'Queue' button. The window is removed.
  453.  
  454.    d) Index the new document:
  455.  
  456.       Select 'Administration' from the pop-up menu of the 'Document
  457.       index' object. The Administration notebook opens. (Press 'Refresh'
  458.       if the number of documents in the queue is still zero.)
  459.  
  460.       Press the 'Index >>' button to start indexing the new document.
  461.  
  462.       Press 'Refresh' after a few seconds to see if indexing has finished
  463.       and that the document is added to the index.
  464.  
  465.       Note: The new document is added to the secondary part of the
  466.             document index. The concepts of the indexing process and the
  467.             index structure are described in the online user's guide
  468.             'Retrieval and Indexing'.
  469.  
  470.       Close the 'Administration' window.
  471.  
  472.    ┌──────────────────────────┐
  473.    │ 7 - Closing the scenario │
  474.    └──────────────────────────┘
  475.  
  476.    Harry Testman has finished his report for the 'Hardware Examiner'
  477.    magazine. Now Paul Mailman has to find all reports written for the
  478.    'Hardware Examiner' and send them to the newspaper publisher.
  479.  
  480.    Note: If you have also installed the demo version of IBM Thesaurus
  481.          Administrator/2 you can now begin that demo to add the new
  482.          PC model to the demo thesaurus. Otherwise, continue as
  483.          follows:
  484.  
  485.    a) Use a thesaurus to find terms related to the 'Hardware Examiner':
  486.  
  487.       Open a 'Query View' window and clear the fields.
  488.  
  489.       Press the 'Thesaurus' button.
  490.  
  491.       Enter "Hardware Examiner" in the entry field at the top
  492.       of the thesaurus window. (If you have run the Thesaurus
  493.       Administrator/2 demo, select the new thesaurus in the drop-down
  494.       list at the bottom right of the 'Thesaurus' window.)
  495.  
  496.       Select the relation "tested" in the left-hand list.
  497.  
  498.       Press the 'Show' button. The 'Thesaurus Result' window opens.
  499.  
  500.       Select all terms in the list and press the 'Add to query' button.
  501.  
  502.       Close the two thesaurus windows.
  503.  
  504.    b) Search for reports about PCs tested for the 'Hardware Examiner':
  505.  
  506.       Enter the model type of the new PC ("east africa 486") in the first
  507.       free entry field. This is already present if you created a new
  508.       thesaurus using the Thesaurus Administrator/2 demo.
  509.  
  510.       Press the 'Search' button. The 'Results View' shows all reports about
  511.       PCs that have been tested for the 'Hardware Examiner'.
  512.  
  513.    Paul Mailman can now do one of the following:
  514.  
  515.       1. Select all objects and drop them onto a printer object to give
  516.          the 'Hardware Examiner' magazine a printout of the documents.
  517.  
  518.       2. If an OS/2 mail application is installed, drop the documents onto
  519.          a mail object to mail the reports to the magazine electronically.
  520.  
  521.    The Test & Compare company has finished the task -- the 'Hardware
  522.    Examiner' has received its reports in time to go to print.
  523.  
  524.  
  525.    Part 2 - A demonstration of selected features
  526.    =============================================
  527.  
  528.    This part highlights some of the features of SearchManager.
  529.  
  530.    ┌─────────────────────────────────────────────┐
  531.    │ 8 - Finding terms using linguistic features │
  532.    └─────────────────────────────────────────────┘
  533.  
  534.    Any retrieval product should be able to find the exact term
  535.    that you are looking for, but only a product with linguistic
  536.    abilities can find variations of the term. Here are two small
  537.    examples of SearchManager's powerful linguistic features.
  538.  
  539.     a) Search for terms:
  540.  
  541.        Open a 'Query View' window. Press the Clear button to clear the
  542.        window.
  543.  
  544.        Type "mouse" in the first search term field, and type "interface"
  545.        in the second search term field.
  546.  
  547.        Press the 'Search' button.
  548.  
  549.     b) Browse one of the found documents:
  550.  
  551.        Browse the document "Examples - sample". Notice that the
  552.        highlighted term "mice" is found as the plural form of "mouse".
  553.  
  554.     c) Use 'Extended matching' to highlight additional found terms:
  555.  
  556.        After a short time, a message at the bottom of the window tells
  557.        you that one further match was found.
  558.  
  559.        Choose 'Extended matching' from the 'Options' menu. SearchManager
  560.        highlights "interface".
  561.  
  562.        SearchManager does text analysis before displaying the document.
  563.        It usually finds all terms to be highlighted. Extended matching
  564.        is an additional process done by intensive analysis using
  565.        dictionaries to highlight unusual matches, like the hyphenated word
  566.        'interface', that are not found by normal text analysis. This
  567.        is done while you are viewing the displayed document. If any
  568.        further matches are found, a message tells you how to display them.
  569.  
  570.    ┌────────────────────────────────────────────────────────┐
  571.    │ 9 - Excluding documents that contain a particular term │
  572.    └────────────────────────────────────────────────────────┘
  573.  
  574.     You want to search for documents about the Big Elephant company's PC
  575.     model of the Africa series. But, of course, you do not want to find
  576.     any documents about the African elephant as an animal.
  577.  
  578.     a) Search for "elephant" and "Africa" but not "animal":
  579.  
  580.        Open a 'Query View' window and press the Clear button to clear the
  581.        window.
  582.  
  583.        Type the term "elephant" in the first search term field, the
  584.        term "Africa" in the second field, and the term "animal" in
  585.        the third.
  586.  
  587.        Select the operator 'and' for the term "Africa" and the operator
  588.        'not' for the term "animal". Your query now looks like this:
  589.  
  590.               elephant
  591.        and    Africa
  592.        not    animal
  593.  
  594.        (The 'not' operator works as an 'and not' operator.)
  595.  
  596.        Press the 'Search' button. You find two documents: BE220893.DOC and
  597.        NEWDOC.DOC, the document you created earlier.
  598.  
  599.        Not included in the result are the Animal Encyclopedia documents
  600.        ANIMAL91, ANIMAL92 and ANIMAL93 which contain not only "Africa"
  601.        and "elephant", but also "animal".
  602.  
  603.    ┌─────────────────────┐
  604.    │ 10 - Using synonyms │
  605.    └─────────────────────┘
  606.  
  607.     SearchManager supports you with synonyms from the dictionaries
  608.     you have installed. This "Try Out" version contains the UK-English
  609.     dictionary.
  610.  
  611.     a) Add your own synonym, for this query only:
  612.  
  613.        Open a 'Query View' window and clear the window.
  614.  
  615.        Type "system" in the first search term field.
  616.  
  617.        Press the 'Synonym' button. The 'Synonym' window opens.
  618.  
  619.        Select some of the synonyms.
  620.  
  621.        Below the list is an entry field. Type in a word that is not
  622.        contained in the list.
  623.  
  624.        Press the Add button to add the word to the list above. The new
  625.        synonym is added to the list, but only for this particular search
  626.        term.
  627.  
  628.     b) Add your own synonym permanently to the synonym list:
  629.  
  630.        This time, type "lay" in the first search term field, then
  631.        press 'Synonyms'.
  632.  
  633.        On the Synonym window, press the 'Permanent' button. A second window
  634.        appears.
  635.  
  636.        Open the 'Term' list at the top. It contains the terms
  637.        for which you can store synonyms. These are the base forms
  638.        of the term you entered on the 'Query View' window.
  639.        Your search term was "lay" which can have two meanings:
  640.        the base form of "to lay", or the past tense of "to lie".
  641.        So the list contains both terms.
  642.  
  643.        Select "lie" from the list.
  644.  
  645.        Type a synonym of your own in the entry field at the bottom and
  646.        press the 'Add' button.
  647.  
  648.        Press the 'OK' button to return to the Synonym window.
  649.        Your new synonym is now stored permanently and appears the
  650.        next time you use the Synonym feature.
  651.  
  652.        Press 'OK' on the Synonym window. The synonyms you selected
  653.        are displayed in the 'Query View' window.
  654.  
  655.    ┌────────────────────────────────┐
  656.    │ 11 - Working with "hypermedia" │
  657.    └────────────────────────────────┘
  658.  
  659.     Documents can contain hypermedia references. These are points in a
  660.     document from which other information, such as graphics, images,
  661.     audio, or video, can be called.
  662.  
  663.     An example of how you could implement hypermedia references is
  664.     included in the sample documents. One of these documents contains
  665.     a reference to a picture of a hot-air balloon.
  666.  
  667.     a) Display a hypermedia image:
  668.  
  669.        Open a 'Query View' window. Type "hot air" in the first search
  670.        term field and press the 'Search' button.
  671.  
  672.        Browse the found document. You see a hypermedia reference that
  673.        looks like this:
  674.  
  675.        IMAGE: hotair.met
  676.  
  677.        Position the cursor anywhere on the hypermedia reference, and press
  678.        the 'Hypermedia' button.
  679.  
  680.    b) Use your own hypermedia application:
  681.  
  682.       To use your own application for hypermedia, do the following:
  683.  
  684.       Edit the file EHSHMLNK.DAT located in the directory \SM2\DATA.
  685.       This file explains the syntax and gives examples of how to
  686.       specify hypermedia tags in documents.
  687.  
  688.       Add an entry for your application and the hypermedia tag you want
  689.       to use and save the file.
  690.  
  691.       The following example is for the IBM Multimedia Presentation Manager/2
  692.       and requires a sound card:
  693.  
  694.            TYPE=MMPM;CMD=PLAY file=%o;
  695.  
  696.       This entry tells SearchManager, when a tag containing MMPM is
  697.       activated, to run the OS/2 command (CMD) file called PLAY using
  698.       the file name given in the tag.
  699.  
  700.       Create a document containing this hypermedia tag with the name of
  701.       the file you want to use with your application.
  702.  
  703.           ┌─ Sample for ASCII documents: ────────────────────────────┐
  704.           │                                                          │
  705.           │  This document contains a reference to the sample sound  │
  706.           │  supplied by MMPM/2 assuming that MMPM/2 was installed   │
  707.           │  on drive C:                                             │
  708.           │                                                          │
  709.           │  <*MMPM: C:\MMOS2\SOUNDS\LASER.WAV *>                    │
  710.           └──────────────────────────────────────────────────────────┘
  711.  
  712.       Index the document.
  713.  
  714.       Search for the new document, then browse the document.
  715.  
  716.       Position the cursor on the hypermedia tag, then press the 'Hypermedia'
  717.       button. The "Laser" sound is generated.
  718.  
  719.    c) Using Hypermedia tags for other purposes:
  720.  
  721.       You can use hypermedia for a whole range of functions, limited only
  722.       by your imagination. Here is an example:
  723.  
  724.       Search for the phrase "index types". A document is found that has a
  725.       hypermedia reference at the end.
  726.  
  727.       Position the cursor on the hypermedia tag, then press the 'Hypermedia'
  728.       button. This reference displays the User's Guide at the place where
  729.       this topic is described.
  730.  
  731.    ┌─────────────────────────────────────────────────────┐
  732.    │ 12 - Restricting the search to a group of documents │
  733.    └─────────────────────────────────────────────────────┘
  734.  
  735.     SearchManager finds all documents stored in its document index that
  736.     match the search criteria. However, in some cases, you may want to
  737.     restrict the search to a specific group of documents, such as a
  738.     directory on your hard disk.
  739.  
  740.     a) Search in all documents:
  741.  
  742.        Open a 'Query View' window. Type "design" in the first
  743.        search term field.
  744.  
  745.        Press the 'Search' button. The Results View opens.
  746.        Six documents are found.
  747.  
  748.     b) Specify a document group to be searched:
  749.  
  750.        Redisplay the 'Query View' window.
  751.  
  752.        Select the 'Defaults' tab at the bottom of the notebook to see
  753.        the second page.
  754.  
  755.        Select 'Restrict to document groups'. The 'Add' button is enabled.
  756.  
  757.        Press the 'Add' button.
  758.        The 'Add Document Groups' window opens.
  759.  
  760.        Double-click on the item in the 'Groups' listbox representing
  761.        the drive where you installed the SearchManager "Try Out" version.
  762.        The directory tree is expanded.
  763.  
  764.        Double-click on the item representing the directory SM2. (If you
  765.        specified a different name at installation, choose this name.)
  766.  
  767.        Select the item SM2\DOCS and press the 'Add' button. The item is
  768.        copied to the 'Selected groups' box on the right.
  769.  
  770.        Press the 'OK' button. The 'Add Document Groups' window closes.
  771.        The selected directory is displayed on the 'Defaults' page.
  772.  
  773.     c) Searching in a selected document group:
  774.  
  775.        Select the 'Query' tab at the bottom of the notebook to redisplay
  776.        the 'Query View'.
  777.  
  778.        Using the same search term "design", press the 'Search' button.
  779.        The 'Results' view now displays only two documents.
  780.  
  781.     d) Search in all documents:
  782.  
  783.        Now return to the previous setting for the rest of this demo.
  784.        To do this:
  785.  
  786.        Redisplay the 'Query View' window.
  787.        Select the 'Defaults' tab again.
  788.        Select 'Search the entire index'.
  789.  
  790.    ┌──────────────────────────┐
  791.    │ 13 - Indexing a document │
  792.    └──────────────────────────┘
  793.    You can drag documents to the 'Index' object for indexing, or you can
  794.    display a window from which to select documents for indexing. Better still,
  795.    indexing can be automated.
  796.  
  797.    a) Select this document 'How to use the "Try Out" version...' to put it
  798.       in the queue for indexing:
  799.  
  800.       Close or minimize the 'Query View' and the 'Results View' windows.
  801.  
  802.       Redisplay the 'Search service' folder.
  803.  
  804.       Double-click on the Document index object. A window opens from
  805.       which you can select documents to be indexed.
  806.  
  807.       Double-click on the item in the 'Groups' listbox representing the
  808.       drive where you installed the SearchManager "Try Out" version. The
  809.       directory tree is expanded.
  810.  
  811.       Double-click on the item representing the directory SM2. (If you
  812.       specified a different name at installation, choose this name.)
  813.  
  814.       Select the item "How to use the Try-Out version..." in the 'Documents'
  815.       list at the right.
  816.  
  817.       Press the 'Queue' button to put the document in the index queue.
  818.  
  819.    b) Index this document:
  820.  
  821.       Press the 'Administration' button. The Administration notebook opens.
  822.       The document queue contains one document.
  823.  
  824.    c) Do periodic indexing automatically:
  825.  
  826.       In contrast to this manual method of indexing, there are also ways
  827.       to do indexing, and other index-administration tasks, periodically.
  828.       For more information, refer to the online user's guide "Retrieval
  829.       and Indexing". If you want to know more now, click on the 'Periodic'
  830.       tab in the Administration notebook and look through the pages under
  831.       this tab, using Help when you need it.
  832.  
  833.       Close the Administration window.
  834.  
  835.    ┌────────────────────────────────────────────────────────┐
  836.    │ 14 - Using a word processor to display found documents │
  837.    └────────────────────────────────────────────────────────┘
  838.  
  839.    You can use your own word processor rather than the SearchManager
  840.    document browser for browsing found documents. The matched terms are not
  841.    highlighted, but you can edit the document.
  842.  
  843.    a) Search for documents to browse:
  844.  
  845.       Open a query object and press the Clear button to clear the window.
  846.  
  847.       Type "excellent" in the first search term field.
  848.  
  849.       Press the 'Search' button.
  850.  
  851.    b) There are three ways to edit the found documents using your own word
  852.       processor:
  853.  
  854.       1. If the word processor supports drag and drop, drag the document
  855.          and drop it onto your word processor object.
  856.  
  857.       2. Open the pop-up menu of the document object:
  858.  
  859.          Select the arrow beside 'Open' and select the word processor from
  860.          the submenu that is displayed.
  861.          Note: The word processor must have been associated with the
  862.                document type for it to be included in that menu.
  863.  
  864.       3. Double-click on a document.
  865.          Normally the SearchManager document browser opens when you
  866.          double-click on a document in the 'Results View' window.
  867.  
  868.          If you want the word processor for this document type to be
  869.          opened instead on the double-click action, do the following:
  870.  
  871.          Select 'Options' on the menu bar of the 'Results View', then
  872.          click on the menu item that is marked as selected.
  873.          This removes the selection from the menu item so that neither
  874.          'Use browser' nor 'Use common browser' is selected in that menu.
  875.  
  876.          Double-click on one of the documents. The default word processor
  877.          of that document should open:
  878.  
  879.          Document        Default word processor
  880.          --------        ----------------------
  881.          BE210893.WPT    Word Perfect (if installed)
  882.          BE220893.DOC    OS/2 System Editor
  883.          BE230893.SAM    Ami Pro (if installed)
  884.          BE240893.LWP    IBM Works (if installed)
  885.  
  886.    ┌──────────────────────┐
  887.    │ Ordering information │
  888.    └──────────────────────┘
  889.  
  890.    For information about how to order any of the SearchManager/2 family of
  891.    products, click on 'Ordering the original product' in the SearchManager/2
  892.    window.
  893.  
  894.    ┌────────────┐
  895.    │ Trademarks │
  896.    └────────────┘
  897.  
  898.    The following are trademarks of the IBM Corporation in the
  899.    United States or other countries or both:
  900.  
  901.    IBM
  902.    OS/2
  903.    SearchManager/2
  904.    Thesaurus End User System Toolkit/2
  905.    Thesaurus Administrator/2.
  906.  
  907.    The following terms are trademarks of other companies:
  908.  
  909.    Ami Pro                  Samna Corporation
  910.    WordPerfect              WordPerfect Corporation.
  911.  
  912.