The Developer Connection…ice Driver Kit for OS/2 3/DEV3-D1.ISO/prodtool/sm2/ehshlp.pkg/EHSUIMST.HLP

OS/2 Help File | 1993-11-29 | 123.6 KB | 4,810 lines

ΓòÉΓòÉΓòÉ <hidden> Help Window Not Found ΓòÉΓòÉΓòÉ

The requested help window was not found.


ΓòÉΓòÉΓòÉ <hidden> Help for Product Information ΓòÉΓòÉΓòÉ

Use Product Information to display the ownership information for the active
program.


ΓòÉΓòÉΓòÉ <hidden> Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to remove the window without applying any changes made in this
window.


ΓòÉΓòÉΓòÉ <hidden> Help for General Help ΓòÉΓòÉΓòÉ

Use General help to display information about the contents of the active
window.


ΓòÉΓòÉΓòÉ <hidden> Help for Help ΓòÉΓòÉΓòÉ

Select the arrow to the right of Help and use the choices in the Help menu to
display:

o An index of references to help topics
o General information about the object
o A list and description of keys you can use
o General information about the help facility
o Product information for this object.


ΓòÉΓòÉΓòÉ <hidden> Help for Help Index ΓòÉΓòÉΓòÉ

Use the Help index to display an alphabetic list of references to the help
topics in the active program.

Note:  To see all text of the index entries, maximize the Index window.

You can select an index entry to display the help topic that is related to that
index entry.


ΓòÉΓòÉΓòÉ <hidden> Help for Using Help ΓòÉΓòÉΓòÉ

Use Using help to find out how to use the help facility.


ΓòÉΓòÉΓòÉ <hidden> Help for Keys Help ΓòÉΓòÉΓòÉ

Use Keys help to display a description about each key you can use in the active
program.


ΓòÉΓòÉΓòÉ <hidden> Help for Help Push Button ΓòÉΓòÉΓòÉ

Use the Help push button to display a Help window describing the field at the
current cursor position.


ΓòÉΓòÉΓòÉ <hidden> No ΓòÉΓòÉΓòÉ

Do not perform the act described in the panel.


ΓòÉΓòÉΓòÉ <hidden> Help for OK ΓòÉΓòÉΓòÉ

Select OK to accept the information in this window and close it.


ΓòÉΓòÉΓòÉ <hidden> Stop ΓòÉΓòÉΓòÉ

Stop the current processing.


ΓòÉΓòÉΓòÉ <hidden> Yes ΓòÉΓòÉΓòÉ

Perform the act described in the panel.


ΓòÉΓòÉΓòÉ <hidden> Information line ΓòÉΓòÉΓòÉ

This choice gives a user the ability to hide or display the information line
control.  The information line control displays additional information about
the field that has the cursor emphasis.


ΓòÉΓòÉΓòÉ <hidden> Direct Manipulation ΓòÉΓòÉΓòÉ

The direct manipulation operation was a copy request. The results of a copy to
an entry field will be as follows:

o Any selected text in the control will be deleted.

o The text being dropped will be inserted into the control at the cursor
  position.

o The cursor will be placed following the dropped text.

o The source of the dropped text will not be changed.


ΓòÉΓòÉΓòÉ <hidden> Direct Manipulation ΓòÉΓòÉΓòÉ

The direct manipulation operation was a move request. The results of a move to
an entry field will be as follows:

o Any selected text in the control will be deleted.

o The text being dropped will be inserted into the control at the cursor
  position.

o The cursor will be placed following the dropped text.

o The dropped text will be deleted from the source.


ΓòÉΓòÉΓòÉ <hidden> Direct Manipulation ΓòÉΓòÉΓòÉ

The direct manipulation operation was a copy request. The results of a copy to
a list will be as follows:

o If the list is a sorted list, the dropped text will be inserted into the list
  in the sorted order.

o If the list is an unsorted list, the dropped text will be inserted into the
  list following the list item the mouse is over when the drop is made.

o The source of the dropped text will not be changed.


ΓòÉΓòÉΓòÉ <hidden> Direct Manipulation ΓòÉΓòÉΓòÉ

The direct manipulation operation was a move request. The results of a move to
a list will be as follows:

o If the list is a sorted list, the dropped text will be inserted into the list
  in the sorted order.

o If the list is an unsorted list, the dropped text will be inserted into the
  list following the list item the mouse is over when the drop is made.

o The dropped text will be deleted from the source.


ΓòÉΓòÉΓòÉ <hidden> Direct Manipulation ΓòÉΓòÉΓòÉ

The direct manipulation operation requested was invalid. Pressing and holding a
key when the drop is made augments the operation as follows:

o No key - defaults to a copy operation.

o Ctrl key - copy operation.

o Shift key - move operation for OS/2 2.0, invalid for OS/2 1.X.

o Alt key - move operation for OS/2 1.X, invalid for OS/2 2.0.

o Two or more keys - invalid operation.


ΓòÉΓòÉΓòÉ <hidden> Undo ΓòÉΓòÉΓòÉ

This choice returns the settings to their state prior to the last action.


ΓòÉΓòÉΓòÉ <hidden> Close ΓòÉΓòÉΓòÉ

This choice will remove the window without affecting the current process.
Close does not change the information in the window.


ΓòÉΓòÉΓòÉ 1. Help for Query View Notebook ΓòÉΓòÉΓòÉ

Use the Query View notebook to make a query and to set defaults for the
specified query.

Sections:

Use the following, as appropriate:

Query
     To make your query.

Defaults
     To set defaults for this query.


ΓòÉΓòÉΓòÉ 2. Help for Query ΓòÉΓòÉΓòÉ

Use the Query section of the Query View notebook to make your query.

Note:

o You can use a progress indicator to monitor query processing.

o Any operators preceding the first search term are ignored.

o If you use more than one operator, SearchManager/2 processes the AND and the
  NOT operators first (in the sequence that they are given), and then it
  processes the OR operators.

  For example:

         price
    and  increase
    or   foreign
    and  airline
  looks for documents that contain both PRICE and INCREASE, and it also looks
  for documents that contain both FOREIGN and AIRLINE.

  It can be thought of like this:

    (price and increase) or (foreign and airline).

o If you are using the OS/2* file system, you can restrict a search so that
  only documents of selected document groups are searched.

Use the following as appropriate:

Search terms
     To specify the search terms for your query.

Operator
     To specify the relation between two search terms.

In the box labeled Options for search term you can use the following, as
appropriate, for the search term at the current cursor position:

Any sequence
     To specify, for multiple-word search terms, that you want to find
     documents that contain the terms in any sequence (within the same
     sentence) rather than in the exact sequence typed in the Search terms
     field. (Not available for a precise index.)

Inflected forms
     To search for any other forms of the search term, such as plural,
     singular, or another tense. (Not available for a precise index.)

Synonym list
     To view the synonyms that you have chosen for the search term at the
     current cursor position.

Language list
     To select which dictionary to use when searching for other forms of the
     search term at the current cursor position.

Push buttons:

Select:

o Synonyms to open the Synonyms window.

o Search to search for the specified search terms.

o Clear to empty the Search terms fields and to reset the items in the Options
  for box to their default values.

o Undo to restore the search terms and options to their values specified for
  the last search request. If you have not yet performed a search, this section
  contains the information that was initially presented when opening the query.

o Help to display help information for the selected item.


ΓòÉΓòÉΓòÉ 2.1. Help for Operator List ΓòÉΓòÉΓòÉ

To specify the relation between search terms, select an operator from the
Operator drop-down list.

Note:

o Any operators preceding the first search term are ignored.

o If you use more than one operator, SearchManager/2 processes the AND and the
  NOT operators first (in the sequence that they are given), and then it
  processes the OR operators.

  For example:

         price
    and  increase
    or   foreign
    and  airline
  looks for documents that contain both PRICE and INCREASE, and it also looks
  for documents that contain both FOREIGN and AIRLINE.

  It can be thought of like this:

    (price and increase) or (foreign and airline).


ΓòÉΓòÉΓòÉ 2.2. Help for Search Terms ΓòÉΓòÉΓòÉ

In each Search terms field you can use the following to search for (or to
exclude from your search):

o A word or phrase.

o Fragments of a word or phrase using global characters for masking words or
  characters sometimes known as "wild-card" characters.

A search term can have up to 255 characters.

There are 50 Search terms fields. Use the scroll bar to view the next fields.

Use the box labeled Options for search term to select the following as
appropriate for the search term at the current cursor position:

o Whether to respect the sequence of the words in a multiple-word search term,
  or to search for them in any sequence (in the same sentence).

o Whether to search for any inflected forms of the search term, such as plural,
  singular, or another tense.

o Synonyms for the displayed search term.

o The language dictionary to be used when searching for inflected forms.

Note:

o Any operators preceding the first search term are ignored.

o If you use more than one operator, SearchManager/2 processes the AND and the
  NOT operators first (in the sequence that they are given), and then it
  processes the OR operators.

  For example:

         price
    and  increase
    or   foreign
    and  airline
  looks for documents that contain both PRICE and INCREASE, and it also looks
  for documents that contain both FOREIGN and AIRLINE.

  It can be thought of like this:

    (price and increase) or (foreign and airline).

Further information:

o Complex structured queries.


ΓòÉΓòÉΓòÉ 2.3. Help for Any Sequence ΓòÉΓòÉΓòÉ

Use Any sequence to specify how exact you want the search to be for a compound
word or phrase specified in the Search terms field.

If Any sequence is selected, the search term:

annual report guidelines

for example, finds documents that contain:

guidelines for writing annual reports

If the search term belongs to the Germanic languages, SearchManager/2 breaks a
compound into its parts, and uses the parts to search as if for a group of
words.

If you do not select Any sequence, the exact sequence of the specified compound
word or phrase is used.

Note:

o The words contained in the Search terms field must be in the same sentence.

o Any sequence is available if Inflected forms has been selected.

o Any sequence is not available if you are using a precise index.


ΓòÉΓòÉΓòÉ 2.4. Help for Inflected Forms ΓòÉΓòÉΓòÉ

Use Inflected forms to specify whether you want to find variations of the
search term, such as singular, plural, or different tenses.

If you select Inflected forms and your search term is:

drive
SearchManager/2 finds documents that contain, for example:

drive
drives
driving
drove
driven

If Inflected forms is not selected, SearchManager/2 searches only for the
precise form of the word as specified in the Search terms field.

Inflected forms is:

o Selected for a linguistic index.

o Available for selection for a dual index.

o Not available for a precise index.


ΓòÉΓòÉΓòÉ <hidden> Help for Synonyms ΓòÉΓòÉΓòÉ

Select Synonyms to provide synonyms for the search term displayed in the
Options for search term box.

SearchManager/2 then opens the Synonyms window.

Synonyms are available only for single words.


ΓòÉΓòÉΓòÉ 2.5. Help for Synonym List ΓòÉΓòÉΓòÉ

The Synonym list contains the synonyms you have specified for the search term
at the current cursor position.

Click on Synonyms to open the Synonyms window.


ΓòÉΓòÉΓòÉ 2.6. Help for Language List ΓòÉΓòÉΓòÉ

To specify the dictionary to be used when searching for inflections of the
search term, select a language from the Language drop-down list.

Note:  Whichever language is selected, SearchManager/2 assumes that the
synonyms selected for this search term are in the same language.


ΓòÉΓòÉΓòÉ <hidden> Help for Search ΓòÉΓòÉΓòÉ

Select Search to search the index according to the selected specification.

You can use a progress indicator to monitor query processing.


ΓòÉΓòÉΓòÉ <hidden> Help for Thesaurus ΓòÉΓòÉΓòÉ

Select Thesaurus to provide thesaurus terms for the search term displayed at
the current cursor position.

SearchManager/2 then opens the Thesaurus window.

Note:  Thesaurus terms are available only for single words.


ΓòÉΓòÉΓòÉ <hidden> Help for Clear ΓòÉΓòÉΓòÉ

Select Clear to empty the Search terms fields and to reset the items in the
Options for box to their default values.


ΓòÉΓòÉΓòÉ <hidden> Help for Undo ΓòÉΓòÉΓòÉ

Select Undo to restore the search terms and options to their values specified
for the last search request. If you have not yet performed a search, this
section contains the information that was initially presented when opening the
query.


ΓòÉΓòÉΓòÉ 3. Help for Defaults ΓòÉΓòÉΓòÉ

Use the Defaults section of the Query View notebook to define defaults for the
query.

Fields:

Use the following, as appropriate:

Service
     To choose the search service to be used. (Single-workstation systems have
     one search service.)

Search the entire index
     To search the entire index.

Restrict to document groups
     To search only the documents specified for the selected document groups.

     Note:  This choice is available only if you are using the OS/2* file
     system.

Document Group list
     To specify the document groups you want to search.

Language
     To select the default dictionary to be used when searching for inflected
     forms of this query's search terms.

A word or part of a word
     To define the global ("wild-card") character that represents a word or
     part of a word in a search term.

One character
     To define the global character that represents exactly one character of a
     search term.

Display first
     To specify how many documents you want to see at a time in the Results
     View.

Show progress
     To display the progress indicator for a search. (You must select the
     progress indicator before starting the search.)

Push buttons

Select:

o Add to choose new groups for the document group list using the Add Document
  Groups window.

o Remove to remove the selected items from the document group list.


ΓòÉΓòÉΓòÉ 3.1. Help for Search Service ΓòÉΓòÉΓòÉ

This field shows the search services available. To specify the search service
to be used, select it from the Search service drop-down list.

Single-workstation systems have one search service.


ΓòÉΓòÉΓòÉ 3.2. Help for Search the Entire Index ΓòÉΓòÉΓòÉ

Select Search entire index to search all documents contained in the document
index.


ΓòÉΓòÉΓòÉ 3.3. Help for Restrict to Document Groups ΓòÉΓòÉΓòÉ

Select Restrict to document groups to search only the documents contained in
the selected document groups.

Note:

o This choice is available only if you are using the OS/2* file system.

o You must select the document groups you want to search in the Document Group
  list.


ΓòÉΓòÉΓòÉ 3.4. Help for Document Group List ΓòÉΓòÉΓòÉ

To specify in which document groups you want to search, add document groups or
remove document groups from the document group list.


ΓòÉΓòÉΓòÉ 3.5. Help for Add ΓòÉΓòÉΓòÉ

Select Add to choose new groups for the document group list using the Add
Document Groups window.


ΓòÉΓòÉΓòÉ 3.6. Help for Remove ΓòÉΓòÉΓòÉ

Select the items you want to remove from the list. Then click on Remove to
remove the selected document group from the document group list.


ΓòÉΓòÉΓòÉ 3.7. Help for Word or Part of a Word ΓòÉΓòÉΓòÉ

In the A word or part of a word field define the global character that
represents one or more characters at the front, middle, or end of a search
term.

Note:

o Make sure that you do not use the same character for word and character
  masking.

o You can leave this field empty, but if you type a blank character in it, the
  character is not be accepted.


ΓòÉΓòÉΓòÉ 3.8. Help for Character ΓòÉΓòÉΓòÉ

In the One character field define the global character that represents only one
character in a search term.

Note:

o Make sure that you do not use the same character for word and character
  masking.

o You can leave this field empty, but if you type a blank character in it, the
  character is not be accepted.


ΓòÉΓòÉΓòÉ 3.9. Help for Language Selection ΓòÉΓòÉΓòÉ

Use the Language drop-down list to select the dictionary to be used for finding
variations of the search terms.

This selection determines which language appears in the Language list field in
the Query section.

For new queries, this list displays the language defined in the Global Defaults
window. (If you change the language for a search term, SearchManager/2 assumes
that the synonyms selected for this search term are in the same language.)


ΓòÉΓòÉΓòÉ 3.10. Help for Display First ΓòÉΓòÉΓòÉ

Use the Display first field to specify how many documents can be scrolled
through at one time in the Results View.

You can specify to view up to 300 documents at a time. The smaller the number,
the sooner the Results View is displayed.


ΓòÉΓòÉΓòÉ 3.11. Help for Show Progress ΓòÉΓòÉΓòÉ

Select Show progress to display the Progress Indicator window for a search. The
progress indicator includes a push button that lets you interrupt the search.
This can be useful when a search takes a particularly long time, and you want
to interrupt the search so that you can repeat it using more specific search
terms.

You must select the progress indicator before starting the search.


ΓòÉΓòÉΓòÉ 4. Help for Synonyms ΓòÉΓòÉΓòÉ

Use the Synonyms window to select synonyms for the search term.

Synonyms are available only for single words.

Search terms and their synonyms are internally linked using or operators.

Fields

Use the following, as appropriate:

Synonym list
     To view the synonyms available for the search term, and to select those
     you need.

Additional synonym (temporary)
     To add a synonym to the list for use in this query only.

Push buttons:

Select:

o Select all to select all the synonyms listed.

o Deselect all to cancel the selection of any synonyms.

o Reset to reset the window to its initial state when it was opened.

o Permanent to add synonyms to the synonym list for use in any query.

  SearchManager/2 then opens the Permanent User Synonyms window.

o Add to add a synonym to the list for use in this query only.

o OK to accept all changes and close the window. The selected synonyms are
  displayed in the Synonym List in the Query section.

o Cancel to remove the window without any changes.

o Help to display help information.


ΓòÉΓòÉΓòÉ 4.1. Help for Synonym List ΓòÉΓòÉΓòÉ

The Synonym list shows the synonyms that are available for the search term. It
contains synonyms provided by SearchManager/2 and any new synonyms you have
added for use in this query.

Click on synonyms in this list, to select them for the search term. Only the
selected synonyms are presented in the Synonym list of the Query section.

Use the following, as appropriate:

o Select all
o Deselect all
o Reset
o Permanent
o Add.


ΓòÉΓòÉΓòÉ <hidden> Help for Select All ΓòÉΓòÉΓòÉ

Click on Select all to select all items shown in the synonym list. These items
are then displayed in the synonym list of the Query section.


ΓòÉΓòÉΓòÉ <hidden> Help for Deselect All ΓòÉΓòÉΓòÉ

Click on Deselect all to cancel the selection of any selected synonyms in the
list.


ΓòÉΓòÉΓòÉ <hidden> Help for Reset ΓòÉΓòÉΓòÉ

Select Reset to reset the window to the values shown when it was last opened.


ΓòÉΓòÉΓòÉ <hidden> Help for Permanent ΓòÉΓòÉΓòÉ

Select Permanent to add synonyms to the synonym list to be available for all
queries.

SearchManager/2 then opens the Permanent User Synonyms window.


ΓòÉΓòÉΓòÉ 4.2. Help for Additional Synonym (Temporary) ΓòÉΓòÉΓòÉ

Specify the synonym you want to add to the synonym list for this query only.
Then click on Add.

A synonym can have up to 255 characters.

(To add synonyms to the synonym list for all queries, click on Permanent.)


ΓòÉΓòÉΓòÉ <hidden> Help for Add ΓòÉΓòÉΓòÉ

Select Add to add the specified synonym to the synonym list for this query
only.

(To add synonyms to the synonym list for all queries, click on Permanent.)


ΓòÉΓòÉΓòÉ 5. Help for Permanent User Synonyms ΓòÉΓòÉΓòÉ

Use the Permanent User Synonyms window to add your own synonyms to the existing
synonym list.

The new synonyms appear in the Synonym List of the Synonyms window in any
query.

Fields

Use the following, as appropriate:

Term list
     To view and to select the terms for which you want to select synonyms.

Synonym list
     To view and to update the synonyms provided for the selected term.

Additional synonym
     To specify a synonym you want to add to the synonym list for use in all
     subsequent queries.

Push buttons:

Select:

o Remove to remove the selected synonyms from the synonym list.

o Add to add the specified synonym to the synonym list.

o OK to accept all changes and close the window. The new synonyms are stored
  and displayed in the Synonym List.

o Cancel to remove the window without any changes.

o Help to display help information.


ΓòÉΓòÉΓòÉ 5.1. Help for Term List ΓòÉΓòÉΓòÉ

The Term drop-down list contains the selected search term and its base form.

For example:

o If the search term is:

    lay
  the Term list contains:

    lay
    lie
  where lay can be the past tense of to lay or to lie.

o If the search term is:

    building
  the Term list contains:

    building
    build
  where building can be a noun or an inflection of the verb build.

To specify synonyms for a term, click on the term contained in the Term list,
and select the synonyms from the Permanent User Synonyms list.


ΓòÉΓòÉΓòÉ 5.2. Help for Permanent User Synonyms ΓòÉΓòÉΓòÉ

The Permanent User Synonyms list shows the synonyms you have specified for the
selected term.

Use the following, as appropriate:

Remove
     To remove the selected synonyms from the list.

Add
     To add the specified word to the permanent user synonym list.


ΓòÉΓòÉΓòÉ <hidden> Help for Remove ΓòÉΓòÉΓòÉ

Select the synonyms you want to remove from the list. Then click on Remove to
remove them.


ΓòÉΓòÉΓòÉ 5.3. Help for Additional Synonym ΓòÉΓòÉΓòÉ

Specify the synonym you want to add to the permanent user synonym list, then
click on Add.


ΓòÉΓòÉΓòÉ <hidden> Help for Add ΓòÉΓòÉΓòÉ

Select Add to add the specified synonym to the synonym list.


ΓòÉΓòÉΓòÉ 6. Help for Progress Indicator ΓòÉΓòÉΓòÉ

Use the Progress Indicator window to monitor query processing. (You must select
the progress indicator before starting the search.) The progress indicator
includes a push button that lets you interrupt the search. This can be useful
when a search takes a particularly long time, and you want to interrupt it so
that you can repeat the search using more specific search terms.

The Defaults section of the Query View notebook defines whether a progress
indicator is displayed.

Push buttons:

Select:

o Stop to stop the search.
o Help to display help information.


ΓòÉΓòÉΓòÉ <hidden> Help for Stop ΓòÉΓòÉΓòÉ

Select Stop to stop the search.


ΓòÉΓòÉΓòÉ 7. Help for Results View ΓòÉΓòÉΓòÉ

Use the Results View to view the documents resulting from the search.

Note for saved result lists:  The Browser window is not available when the
Query View and the Results View of a Query object are closed:

o Use your system editor to browse documents contained in a saved result list.
  (Highlighted matches are not shown.)

o To see the highlighted matches, repeat the search by selecting Search on the
  Query section of the Query View notebook. Then you can use the Browser window
  to see all highlighted matches.

Menu bar choices:

o Results
o View
o Options


ΓòÉΓòÉΓòÉ 7.1. Help for Results ΓòÉΓòÉΓòÉ

Select Results to print the result list.


ΓòÉΓòÉΓòÉ 7.1.1. Help for Print ΓòÉΓòÉΓòÉ

Select Print in the Results pull-down to print the result list.

Note:  The result list is printed as shown in the Details view.


ΓòÉΓòÉΓòÉ 7.2. Help for View ΓòÉΓòÉΓòÉ

Select View to change the display of the result list.

Choices:

o Next
o Previous
o Top
o Bottom
o Icons
o Details


ΓòÉΓòÉΓòÉ 7.2.1. Help for Next ΓòÉΓòÉΓòÉ

Select Next in the View pull-down to display the next page of the result list.

The Display first field of the Defaults page defines how many documents can be
scrolled through at a time.


ΓòÉΓòÉΓòÉ 7.2.2. Help for Previous ΓòÉΓòÉΓòÉ

Select Previous in the View pull-down to display the previous page of the
result list.

The Display first field of the Defaults page defines how many documents can be
scrolled through at a time.


ΓòÉΓòÉΓòÉ 7.2.3. Help for Top ΓòÉΓòÉΓòÉ

Select Top in the View pull-down to display the first page of the result list.

The Display first field of the Defaults page defines how many documents can be
scrolled through at a time.


ΓòÉΓòÉΓòÉ 7.2.4. Help for Bottom ΓòÉΓòÉΓòÉ

Select Bottom in the View pull-down to display the last page of the result
list.

The Display first field of the Defaults page defines how many documents can be
scrolled through at a time.


ΓòÉΓòÉΓòÉ 7.2.5. Help for Icons ΓòÉΓòÉΓòÉ

Select Icons to display the documents contained in the Results View window as
document icons, and to arrange these objects within the folder.

Initially Icons view is selected by default.


ΓòÉΓòÉΓòÉ 7.2.6. Help for Details ΓòÉΓòÉΓòÉ

Select Details to display the properties of the document objects such as
location and description.


ΓòÉΓòÉΓòÉ 7.3. Help for Options ΓòÉΓòÉΓòÉ

Select Options to specify the default Browser choice to be used when browsing
documents presented in the result list.

Choices:

o Use browser
o Use common browser.

Note:  If you do not select one of the above Browser choices, the default
action of the original document is applied, when using the OS/2* file system.


ΓòÉΓòÉΓòÉ 7.3.1. Help for Use Browser ΓòÉΓòÉΓòÉ

Select Use browser to display the selected document using the Browser window.
You can select several documents for browsing. SearchManager/2 opens a new
window for each document and highlights text that matches the search criteria.

You may find this choice more convenient when you want to study and perhaps
compare several documents at the same time. However, if you want to browse a
lot of documents, opening a new window for each document can have an impact on
your system performance.

You can only view the document and copy information to the clipboard. You
cannot change the document content in the Browser window.

The Browser window is not available when the Query View and the Results View of
a Query object are closed:

o Use your system editor to browse documents contained in a saved result list.
  (Highlighted matches are not shown.)

o To see the highlighted matches, repeat the search by selecting Search on the
  Query section of the Query View notebook. Then you can use the Browser window
  to see all highlighted matches.


ΓòÉΓòÉΓòÉ 7.3.2. Help for Use Common Browser ΓòÉΓòÉΓòÉ

Select Common browser to display the selected document using the Browser
window. Text that matches the search criteria is highlighted.

You can select only one document at a time. SearchManager/2 opens only one
window for browsing documents contained in one result list. This is faster than
browsing several documents at a time by selecting Use browser, so you may find
it more convenient when you want to look briefly at many documents.

You can only view the document and copy information to the clipboard. You
cannot change the document content in the SearchManager/2 Browser window.

The Browser window is not available when the Query View and the Results View of
a Query object are closed:

o Use your system editor to browse documents contained in a saved result list.
  (Highlighted matches are not shown.)

o To see the highlighted matches, repeat the search by selecting Search on the
  Query section of the Query View notebook. Then you can use the Browser window
  to see all highlighted matches.


ΓòÉΓòÉΓòÉ 8. Help for Query ΓòÉΓòÉΓòÉ

The Query object contains the search criteria and the result list of the
specified query.

Select Open on the pop-up menu of the Query object to process the query and its
result list.

Double-click on a query object to open the Query View notebook.


ΓòÉΓòÉΓòÉ 8.1. Help for Open ΓòÉΓòÉΓòÉ

Select Open to process settings, the result list, or a query.

Initially, the Query View notebook is opened.


ΓòÉΓòÉΓòÉ 8.1.1. Help for Settings, Results View, and Query View ΓòÉΓòÉΓòÉ

Use the following, as appropriate:

Settings
     To view or change the current settings of the object.

Results view
     To display the result of the query.

     Note:  The Browser window is not available when the Query View and the
     Results View of a Query object are closed:

   o Use your system editor to browse documents contained in a saved result
     list. (Highlighted matches are not shown.)

   o To see the highlighted matches, repeat the search by selecting Search on
     the Query section of the Query View notebook. Then you can use the Browser
     window to see all highlighted matches.

     Use your system editor, if you want to browse a saved result list.

Query view
     To open the Query View notebook, to make a query and to view or change an
     existing query.

     This choice is selected by default.


ΓòÉΓòÉΓòÉ 9. Help for Document ΓòÉΓòÉΓòÉ

Each document object acts as an OS/2 shadow of the original document objects.
An action done to a document object in the result list is done to the original
document as well.

Use the pop-up menu of the Document objects to process documents shown in a
result list.

Double-click on a document object to view its contents. The default action
depends on the Browser choice selected on the Options menu.

Note:  You cannot copy, move, or delete a document object in the result list.
To process these actions, you must locate the original document object.

Special choices:

Add to queue
     To add this document to the queue for indexing again.

Locate original
     To locate the original document object.

Browser
     To view the selected document using the Browser window.

Common browser
     To view the selected document using the Browser window.


ΓòÉΓòÉΓòÉ 9.1. Help for Open ΓòÉΓòÉΓòÉ

Select Open to choose the view of the Document object.


ΓòÉΓòÉΓòÉ 9.1.1. Help for Browser ΓòÉΓòÉΓòÉ

Select Browser to display the selected document using the SearchManager/2
Browser window. You can select several documents for browsing. SearchManager/2
opens a new window for each document and highlights text that matches the
search criteria.

You may find this choice more convenient when you want to study and perhaps
compare several documents at the same time. However, if you want to browse a
lot of documents, opening a new window for each document can have an impact on
your system performance.

You can only view the document and copy information to the clipboard. You
cannot change the document content in the SearchManager/2 Browser window.

The Browser window is not available when the Query View and the Results View of
a Query object are closed:

o Use your system editor to browse documents contained in a saved result list.
  (Highlighted matches are not shown.)

o To see the highlighted matches, repeat the search by selecting Search on the
  Query section of the Query View notebook. Then you can use the Browser window
  to see all highlighted matches.


ΓòÉΓòÉΓòÉ 9.1.2. Help for Common Browser ΓòÉΓòÉΓòÉ

Select Common browser to display the selected document using the
SearchManager/2 Browser window. Text that matches the search criteria is
highlighted.

You can select only one document at a time. SearchManager/2 opens only one
window for browsing documents contained in one result list. This is faster than
browsing several documents at a time by selecting Use browser, so you may find
it more convenient when you want to look briefly at many documents.

You can only view the document and copy information to the clipboard. You
cannot change the document content in the SearchManager/2 Browser window.

The Browser window is not available when the Query View and the Results View of
a Query object are closed:

o Use your system editor to browse documents contained in a saved result list.
  (Highlighted matches are not shown.)

o To see the highlighted matches, repeat the search by selecting Search on the
  Query section of the Query View notebook. Then you can use the Browser window
  to see all highlighted matches.


ΓòÉΓòÉΓòÉ 9.2. Help for Add to Queue ΓòÉΓòÉΓòÉ

Select Add to queue to add documents to the queue for indexing (or for removal
from the index). The Add to Queue window is displayed.

Note:  Use this choice to place this document in the queue to be indexed again,
or perhaps to be removed from the document index.


ΓòÉΓòÉΓòÉ 9.3. Help for Copy Name ΓòÉΓòÉΓòÉ

Select Copy name to copy the fully qualified name of the document to the
clipboard. You can use this, for example, to insert the name into another file.


ΓòÉΓòÉΓòÉ 9.4. Help for Locate Original ΓòÉΓòÉΓòÉ

Select Locate original to locate the original document object so that you can
copy, delete, or move it.


ΓòÉΓòÉΓòÉ 10. Help for Add to Queue ΓòÉΓòÉΓòÉ

Use the Add to Queue window to place documents in the document queue for
indexing.

Specify whether documents will be:

o Added to the document index
o Removed from the document index.

Note:  If you are working at a client workstation in a client/server system,
the documents you add to the document index must be located on a file server.
The workstation where the SearchManager/2 search service is installed must have
access to these documents.

Fields

Use the following, as appropriate, if you have dragged and dropped OS/2*
file-system documents on the index object, or if you have selected Add to queue
from the pop-up menu of a document object in the Results View:

Documents
     To select the documents you want to add or remove from the index.

Add to index
     To indicate that the selected documents are to be added to the index.

Remove from index
     To indicate that the selected documents are to be removed from the index.

In addition, use the following, as appropriate, if you have selected Add to
queue from the pop-up menu of the index object:

Groups
     To select the document groups to be used.

Documents
     To select the documents you want to add or remove from the document index.

Push buttons:

Select:

o Queue to add the selected documents to the document queue. Depending on the
  selected options, these documents will be added to or removed from the
  document index.

o Select all to select all documents in the documents list. This choice is
  available if you have selected Add to queue from the pop-up menu of the index
  object.

o Deselect all to cancel the selection of any documents in the documents list.

  Note:  This choice is available if you have selected Add to queue from the
  pop-up menu of the index object.

o Cancel to remove the window without any changes.

o Help to display help information.


ΓòÉΓòÉΓòÉ 10.1. Help for Documents ΓòÉΓòÉΓòÉ

The Documents list shows the documents that have been selected for indexing.
You can specify the following for the listed documents:

o Add to index
o Remove from index


ΓòÉΓòÉΓòÉ 10.2. Help for Add to Index ΓòÉΓòÉΓòÉ

Use Add to index if the selected documents are to be added to the document
index.


ΓòÉΓòÉΓòÉ 10.3. Help for Remove from Index ΓòÉΓòÉΓòÉ

Use Remove from index if the selected documents are to be removed from the
document index.


ΓòÉΓòÉΓòÉ <hidden> Help for Queue ΓòÉΓòÉΓòÉ

Use Queue to add the marked documents to the document queue. These documents
are processed the next time documents are indexed.


ΓòÉΓòÉΓòÉ <hidden> Help for Administration ΓòÉΓòÉΓòÉ

Use Administration to display the administration notebook. In the Explicit
section of the notebook, press Refresh to see the current number of documents
in the document queue.


ΓòÉΓòÉΓòÉ 10.4. Help for Groups ΓòÉΓòÉΓòÉ

Use the Groups list box to displays all document groups available on your
system.

Double-click on a document group to display all subgroups (if available) and
documents in the Documents list.

If you double-click on the document group again, SearchManager/2 reduces the
expansion to show only the document groups (without displaying subgroups or
documents in the Documents list box).


ΓòÉΓòÉΓòÉ 10.5. Help for Documents ΓòÉΓòÉΓòÉ

The Documents list box displays the documents contained in the selected
document group.

Double-click on the document group in the Groups list to display its subgroups
there, and its documents here in the Documents list.

Select the documents you want to have indexed.

Use the following, as appropriate:

o Select all
o Deselect all

Only the selected documents are added to the Document Queue.


ΓòÉΓòÉΓòÉ <hidden> Help for Select All ΓòÉΓòÉΓòÉ

Click on Select all to select all documents shown in the document list. These
documents are then added to the document queue.


ΓòÉΓòÉΓòÉ <hidden> Help for Deselect All ΓòÉΓòÉΓòÉ

Select Deselect all to cancel the selection of all documents shown in the
document list.


ΓòÉΓòÉΓòÉ 11. Help for Index ΓòÉΓòÉΓòÉ

Using the Index object you can create a query, perform administration tasks,
and place documents in the queue for indexing.

Use the pop-up menu of the Index object to work on queries and the document
index.

The Search service folder must contain an Index object. You cannot remove,
delete, or copy this object from the Search service folder.

If you are using the OS/2* file system, you can create a shadow of the Index
object to prepare queries outside the Search service folder.


ΓòÉΓòÉΓòÉ 11.1. Help for Open ΓòÉΓòÉΓòÉ

Select Open to display the Settings notebook of the Index object.


ΓòÉΓòÉΓòÉ 11.2. Help for Administration ΓòÉΓòÉΓòÉ

Select Administration to display the Administration notebook and to work on the
documents and the document index:

o Indexing documents, or merging and cleaning up the document index explicitly;
  that is, at irregular intervals, when you explicitly request it.

o Indexing documents, or merging and cleaning up the document index
  periodically; that is, automatically at predetermined intervals.

o Controlling and displaying the status of retrieval and indexing activities.

o Specifying the indexing rules; that is, the naming conventions that assist
  SearchManager/2 in recognizing obscure document types.

o Specifying stop words.

o Specifying properties for the document index.


ΓòÉΓòÉΓòÉ 11.3. Help for New Query ΓòÉΓòÉΓòÉ

Select New query to create a Query object. The Query object is located in the
corresponding Search service folder.

Double-click on the Query object to open the Query View notebook.


ΓòÉΓòÉΓòÉ 11.4. Help for Add to Queue ΓòÉΓòÉΓòÉ

Select Add to queue to add documents to the queue for indexing (or for removal
from the index). The Add to Queue window is displayed.

Tip:  Instead of using this choice, select documents or document groups to be
added to (or removed from) the document index, by dragging and dropping the
selected documents onto the Index object.


ΓòÉΓòÉΓòÉ 11.5. Help for Search Service ΓòÉΓòÉΓòÉ

The Search service folder contains the:

o Index object
o Query objects.

Use the Search service folder to start or stop administration and to process
document index requests and queries.

Double-click on the Search service folder to display the objects contained in
it.


ΓòÉΓòÉΓòÉ 11.6. Help for Start service ΓòÉΓòÉΓòÉ

Select Start service to start the search service.

Note:

o If you are working at a single-workstation system, the search service starts
  automatically whenever you need it, there is normally no need to start it
  from the Search service object.

o If you are working at the server workstation in a client/server system, you
  must start the search service so that it is available for those working at
  the client workstations.

o If you are working at a client workstation in a client/server system, the
  search service at the server workstation must already be started.

Periodic indexing is possible only when the search service is started.

Further information:

o Different ways of starting the search service.


ΓòÉΓòÉΓòÉ 11.7. Help for Stop search service ΓòÉΓòÉΓòÉ

Select Stop service to stop the search service.

Note:  Check if periodic indexing is active, before stopping the Search
service.


ΓòÉΓòÉΓòÉ 12. Help for Definitions ΓòÉΓòÉΓòÉ

Use the Definitions section of the Settings notebook to define or customize the
selected Search service object.

Initially the specifications defined during installation are shown. If you
change the specifications on the server workstation where the Search service is
installed, you must also change the specifications of all clients accordingly
to ensure that the clients continue to have access to the Search service.

Fields:

The fields that are shown in this window depend on whether you are working at:

o A client workstation in a client/server system

o A server workstation in a client/server system

o A single-workstation system.

For help on these fields, position the cursor on the field concerned and press
F1.

Push buttons:

Select:

o Undo to restore the content of the section to the specifications when it was
  last opened.

o Help to display help information for the selected item.


ΓòÉΓòÉΓòÉ 12.1. Help for Search Service Name ΓòÉΓòÉΓòÉ

o If you are defining a search service at the server workstation:

  In the Search service name field specify the name of the search service,
  using OS/2* naming conventions. The name of a search service can have up to 8
  alphanumeric characters.

  Initially the specifications defined during installation are shown. If you
  change the specifications on the server workstation where the Search service
  is installed, you must also change the specifications of all clients
  accordingly to ensure that the clients continue to have access to the Search
  service.

o If you are defining a search service at a client workstation:

  In the Search service name field specify the name of the search service you
  want to access.

  Note:  If you change search service names, existing Query objects must be
  changed accordingly. You do this on the Defaults page of each Query View
  notebook.


ΓòÉΓòÉΓòÉ 12.2. Help for Machine Name ΓòÉΓòÉΓòÉ

In the Machine name field specify the identification (ID) of the workstation
that contains the search service.

On the server workstation specify the identification of this workstation. This
is dependent on the communication type:

o Named pipes:

  Enter the LAN address of this workstation. You can display this by entering

    net name
  in an OS/2* session.

o TCP/IP:

  Enter the TCP/IP host name or the TCP/IP dotted decimal address of this
  workstation.

Initially the specifications defined during installation are shown. If you
change the specifications on the server workstation where the Search service is
installed, you must also change the specifications of all clients accordingly
to ensure that the clients continue to have access to the Search service.

On the client workstation specify the machine name of the server workstation
you want to access. Be sure that this name exactly matches the name of the
server workstation.


ΓòÉΓòÉΓòÉ 12.3. Help for Communication Type ΓòÉΓòÉΓòÉ

Select the Communication type drop-down list to specify whether to use named
pipes or TCP/IP.

Initially the specifications defined during installation are shown. If you
change the specifications on the server workstation where the Search service is
installed, you must also change the specifications of all clients accordingly
to ensure that the clients continue to have access to the Search service.


ΓòÉΓòÉΓòÉ 12.4. Help for Port ΓòÉΓòÉΓòÉ

The Port field is required, if you have selected the communication type TCP/IP.

This field is not available for the communication type Named pipes.

Initially the specifications defined during installation are shown. If you
change the specifications on the server workstation where the Search service is
installed, you must also change the specifications of all clients accordingly
to ensure that the clients continue to have access to the Search service.


ΓòÉΓòÉΓòÉ 12.5. Help for Maximum Parallel Search service Tasks ΓòÉΓòÉΓòÉ

In the Maximum parallel search service tasks field, specify the maximum number
of tasks to be handled at the same time by the search service. Service tasks
are, for example, starting a search, adding documents to the queue, or
administration tasks.

The higher you set this value, the slower your system becomes. On the other
hand, if you set this value too low, then, at busy times, some clients may not
be able to search.

If the server has, say, 100 clients that are not likely to be searching at the
same time, try setting this value to about 30.


ΓòÉΓòÉΓòÉ 12.6. Help for Search Service Tasks Kept Available ΓòÉΓòÉΓòÉ

In the Search service tasks kept available field, specify the number of tasks
started in advance to handle future requests.

For good performance, a client making a request should always find a service
task ready to handle its request. However, having too many service tasks open
unnecessarily, means making inefficient use of the service.

The specified number must be lower or equal to the number specified for Maximum
parallel search service tasks


ΓòÉΓòÉΓòÉ 12.7. Help for Time Limit Seconds ΓòÉΓòÉΓòÉ

In the Time limit seconds field, specify the time that a search service task is
allowed to run. After this time, the service task assigned to handle a specific
request, like a search, is terminated.

Set this value to the longest reasonable search time. It prevents unreasonably
long searches from reducing the overall system performance.

It also terminates inactive tasks, such as when a query notebook is left open
after a search.

The recommended minimum value is 1200 seconds.


ΓòÉΓòÉΓòÉ 12.8. Help for Task Cleanup Every ms ΓòÉΓòÉΓòÉ

In the Task cleanup field, specify how frequently you want SearchManager/2 to
check whether new tasks have to be started to handle future requests, or to
check whether to remove surplus tasks to ease the system load.

It is best not to change the system default value which is 500 ms.


ΓòÉΓòÉΓòÉ <hidden> Help for Undo ΓòÉΓòÉΓòÉ

Select Undo to restore the content of the section to the specifications when it
was last opened.


ΓòÉΓòÉΓòÉ 13. Help for Global Defaults ΓòÉΓòÉΓòÉ

Use the Global Defaults window to define defaults for SearchManager/2.

A new definition does not affect open windows or existing queries. Only new
windows and newly created queries use the new definition.

Fields:

Use the following, as appropriate:

Window
     To change the language used on SearchManager/2 windows.

     The language selection is not available on single-workstation systems.

Query
     To select the default language used for analyzing search terms.

A word or part of a word
     To define the global character that represents a word or part of a word in
     a search term.

One character
     To define the global character that represents exactly one character of a
     search term.

Push buttons:

Select:

o Cancel to remove the window without any changes.

o Help to display help information.


ΓòÉΓòÉΓòÉ 13.1. Help for Word or Part of a Word ΓòÉΓòÉΓòÉ

In the A word or part of a word field define the global character that
represents one or more characters at the front, middle, or end of a search
term.

Note:

o Make sure that you do not use the same character for word and character
  masking.

o You can leave this field empty, but if you type a blank character in it, the
  character is not be accepted.

You can change this selection for individual queries using the Defaults
section.

Note:  A new definition does not affect existing queries. Only newly created
queries use the new definition.


ΓòÉΓòÉΓòÉ 13.2. Help for Character ΓòÉΓòÉΓòÉ

In the One character field define the global character that represents only one
character in a search term.

Note:

o Make sure that you do not use the same character for word and character
  masking.

o You can leave this field empty, but if you type a blank character in it, the
  character is not be accepted.

You can change this selection for individual queries using the Defaults
section.

Note:  A new definition does not affect existing queries. Only newly created
queries use the new definition.


ΓòÉΓòÉΓòÉ 13.3. Help for Query ΓòÉΓòÉΓòÉ

Select the language to be used for search terms using the Query drop-down list.
SearchManager/2 uses this language for analyzing the search terms specified in
a query.

This list displays the language currently used for queries.

Note:  You can change the language for:

o A query using the Defaults section.

o Individual search terms contained in a query using the Language drop-down
  list of the Query section.

Note:

o SearchManager/2 provides dictionaries for US English and your local language.

o You can select any language from the query drop-down list. If the correct
  dictionary is not found for analyzing search terms, stem reduction of search
  terms and extended matching is not available.

In a client/server system, dictionaries can be installed on local and remote
workstations:

o The search service at the server workstation uses dictionaries for indexing
  and query processing.

o The client uses dictionaries for selecting synonyms and for extended
  matching. The client can use the dictionaries provided by its server, and
  additionally, all dictionary files installed on its own workstation.


ΓòÉΓòÉΓòÉ 13.4. Help for Window ΓòÉΓòÉΓòÉ

Select the language to be used on SearchManager/2 windows using the Window
drop-down list.

Note:  If you are working in a client/server system, a new definition does not
affect open windows. Only new windows use the new definition. The language
selection is not available in single-workstation systems.


ΓòÉΓòÉΓòÉ <hidden> Help for OK ΓòÉΓòÉΓòÉ

Select OK to accept the information in this window and close it.


ΓòÉΓòÉΓòÉ <hidden> Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to remove the window without applying any changes made in this
window.


ΓòÉΓòÉΓòÉ 14. Help for SearchManager/2 ΓòÉΓòÉΓòÉ

Use the SearchManager/2 folder to set global defaults for language and global
characters for SearchManager/2 and to select the Search service folder.

This folder also contains an Installation Utility object that helps you install
later versions of SearchManager/2 or components of SearchManager/2 that you
have not yet installed. Double-click on this object to start the installation
utility.

In a client/server system, the SearchManager/2 folder contains all search
services that you are linked to. These servers can reside on different
machines.

Note:  A search request deals with only one search service at a time.

Tasks:

o Double-click on the folder to display the objects contained in it.

o Use the pop-up menu to view or change global defaults defined for the
  SearchManager/2 folder.


ΓòÉΓòÉΓòÉ 14.1. Help for Defaults ΓòÉΓòÉΓòÉ

Select Defaults to view or change global defaults defined for SearchManager/2.

Note:  Global defaults can be defined for:

o Window and query language
o Masking characters.


ΓòÉΓòÉΓòÉ 15. Help for Add Document Groups ΓòÉΓòÉΓòÉ

Use the Add Document Groups window to select or specify document groups for:

o A query on the Defaults section

o Indexing on the Periodic section.

Fields:

Use the following, as appropriate:

Groups list
     To select the drive and directory of the groups you want to use.

Selected groups
     To view the document groups you have selected.

Push buttons:

Select:

o Add to add the selected document group to the list of selected groups.

o Remove to remove the selected document group from the list of selected
  groups.

o Cancel to remove the window without any changes.

o Help to display help information.


ΓòÉΓòÉΓòÉ 15.1. Help for Groups ΓòÉΓòÉΓòÉ

The Groups list shows the drives and paths available on your system. These can
be selected as document groups for indexing, or for limiting the scope of a
query.

Select the document groups by clicking on a drive. Double-click on a drive to
display its subgroups. (Double-click again to remove its subgroups.)

Select the document groups in this list, then click on Add to add these groups
to the Selected groups list.

To remove these groups from the Selected groups list, first select the groups
to be removed, then click on Remove. Select OK to accept your selection.


ΓòÉΓòÉΓòÉ 15.2. Help for Add ΓòÉΓòÉΓòÉ

Select Add to add the document selected in the Groups list to the Selected
groups list.


ΓòÉΓòÉΓòÉ 15.3. Help for Remove ΓòÉΓòÉΓòÉ

Select Remove to remove the selected groups from the Selected groups list.


ΓòÉΓòÉΓòÉ 15.4. Help for Selected Groups ΓòÉΓòÉΓòÉ

The Selected groups list shows the document groups selected from the Groups
list.


ΓòÉΓòÉΓòÉ <hidden> Help for OK ΓòÉΓòÉΓòÉ

Select OK to accept the information in this window and close it.


ΓòÉΓòÉΓòÉ <hidden> Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to remove the window without applying any changes made in this
window.


ΓòÉΓòÉΓòÉ 16. Help for Administration Notebook ΓòÉΓòÉΓòÉ

Use the Administration notebook to perform administration tasks required for
SearchManager/2:

o Indexing documents, or merging and cleaning up the document index when you
  explicitly request it.

o Indexing documents, or merging and cleaning up the document index
  periodically.

o Controlling and displaying the status of retrieval and indexing activities.

o Specifying the rules to be used for recognizing document types.

o Specifying stop words.

o Specifying properties for the document index: the index type and library
  services DLLs.


ΓòÉΓòÉΓòÉ 17. Help for Explicit ΓòÉΓòÉΓòÉ

Use the Explicit section of the Administration notebook to index, merge, or
clean up the document index now - when you explicitly request it - rather than
periodically.

Fields:

Document queue
     Shows how many documents have been placed in the document queue for
     indexing or for removal from the index.

Secondary document index
     Shows how many documents there are whose terms are contained in the
     secondary part of the document index.

Primary document index
     Shows how many documents there are whose terms are contained in the
     primary part of the document index.

Push buttons:

Note:  If one of the following push buttons is not available, the corresponding
action is currently running or locked. For more information refer to the Status
section.

Select:

o Index to start processing the document queue; that is, to index the documents
  that are in the queue, or to remove their terms from the document index.

o Clear (in the Document queue group) to empty the document queue immediately
  without indexing any documents.

  Caution:  If you select Clear all entries in the document queue are deleted
  and lost.

o Clear (in the Document index group) to empty the primary and secondary parts
  of the document index.

  Caution:  If you select Clear all entries in the document index are deleted
  and lost.

o Merge to merge the index entries in the secondary part of the document index
  with those in the primary part, and then to clear the secondary part.

o Cleanup to remove obsolete index entries; that is, to remove any terms that
  belong to documents that no longer exist.

o Refresh to update the information shown on the window.

o Help to display help information for the selected item.


ΓòÉΓòÉΓòÉ 17.1. Help for Document Queue ΓòÉΓòÉΓòÉ

The Document queue field shows the number of documents currently in the
document queue.

Push buttons:

Use the following as appropriate:

o Index
o Clear (document queue)
o Merge
o Cleanup
o Clear (document index)


ΓòÉΓòÉΓòÉ 17.2. Help for Vertical Indicator ΓòÉΓòÉΓòÉ

The vertical indicator of the document queue represents the number of documents
currently contained in the document queue. The size of the indicator is in
relation to the largest of the three indicators.

Push buttons:

Use the following as appropriate:

o Index
o Clear (document queue)
o Merge
o Cleanup
o Clear (document index)


ΓòÉΓòÉΓòÉ <hidden> Help for Index ΓòÉΓòÉΓòÉ

Select Index to process the document queue; that is, all documents in the queue
for which Add to index was chosen are indexed - their terms are added to the
document index. On the other hand, if Remove from index was chosen for any
documents in the queue, the terms of those documents are removed from the
document index.

If this is the first time that documents are indexed (the document index is
empty), the primary part of the document index is created, otherwise the number
of documents indexed in the secondary part increases by the number of documents
that are newly added to the document index. If these documents have been
indexed before, then the number of documents in the document index remains the
same.


ΓòÉΓòÉΓòÉ <hidden> Help for Clear ΓòÉΓòÉΓòÉ

Select Clear to delete all entries in the document queue. When clearing the
document queue, no indexing is done. The number of documents in the document
index remains unchanged.

Caution:  The only way to undo this action is to manually place the documents
in the queue again.


ΓòÉΓòÉΓòÉ 17.3. Help for Secondary ΓòÉΓòÉΓòÉ

The Secondary field shows the number of documents whose terms have been added
to the secondary part of the document index.

Note:  To improve the speed of indexing, keep the secondary part of the
document index relatively small. If you notice that indexing has become slower,
merge the secondary part of the document index with the primary part. (The
secondary part is then cleared.)

Push buttons:

Use the following as appropriate:

o Index
o Clear (document queue)
o Merge
o Cleanup
o Clear (document index)


ΓòÉΓòÉΓòÉ 17.4. Help for Vertical Indicator ΓòÉΓòÉΓòÉ

The vertical indicator of the Secondary part of the document index represents
the number of documents currently contained in this index, relative to the
largest of the three indicators.

Push buttons:

Use the following as appropriate:

o Index
o Clear (document queue)
o Merge
o Cleanup
o Clear (document index)


ΓòÉΓòÉΓòÉ <hidden> Help for Merge ΓòÉΓòÉΓòÉ

Select Merge to merge the index entries contained in the secondary part of the
document index with those in the primary part of the document index.

The primary part of the document index is updated to include all index entries
previously contained in the secondary part. The secondary part is then cleared.

Merge is recommended if many documents have been removed from the document
index since the last Merge action.

To improve the speed of indexing, keep the size of the secondary part of the
document index relatively small. If its size has increased significantly, such
that you notice that indexing now takes longer than usual, merge its contents
with the primary part of the document index. The secondary index is then
cleared.


ΓòÉΓòÉΓòÉ <hidden> Help for Cleanup ΓòÉΓòÉΓòÉ

When you delete a document that has previously been indexed, its terms remain
in the document index.

Select Cleanup to remove these obsolete index entries.

When cleanup has finished, Indexing is started to process the documents
contained in the document queue.

Note:  Make sure that enough disk space is available for cleanup and indexing.


ΓòÉΓòÉΓòÉ <hidden> Help for Clear ΓòÉΓòÉΓòÉ

Select Clear to remove all index entries from the document index.

Caution:  If you clear the document index all index entries are lost.


ΓòÉΓòÉΓòÉ 17.5. Help for Primary ΓòÉΓòÉΓòÉ

The Primary field shows the number of documents whose terms have been added to
the primary part of the document index.

Push buttons:

Use the following as appropriate:

o Index
o Clear (document queue)
o Merge
o Cleanup
o Clear (document index)


ΓòÉΓòÉΓòÉ 17.6. Help for Vertical Indicator ΓòÉΓòÉΓòÉ

The vertical indicator of the Primary part of the document index represents the
number of documents currently contained in this index, relative to the largest
of the three indicators.

Push buttons:

Use the following as appropriate:

o Index
o Clear (document queue)
o Merge
o Cleanup
o Clear (document index)


ΓòÉΓòÉΓòÉ 18. Help for Periodic ΓòÉΓòÉΓòÉ

Use the Periodic section of the Administration notebook to periodically index
documents, or to periodically merge or clean up the document index.

This section provides a general overview of the status of periodic
administration for the index, merge, and cleanup activities.

Note:

o All conditions specified on the pages of the Periodic section must be
  completed before administration activities are started.

o Periodic administration is active only when the search service is started.

Tabs at the bottom of the section:

Use the following, as appropriate:

Indexing
     To specify conditions for periodic indexing.

Merge
     To specify conditions for periodic merge.

Cleanup
     To specify conditions for periodic cleanup.

Field:

Use Status to view the status of periodic administration.

Push buttons:

Select:

o Start to start periodic administration.

o Stop to stop periodic administration.

o Unlock to display further information on why periodic administration is
  locked.

o Refresh to update the information shown on the window.

o Help to display help information for the selected item.


ΓòÉΓòÉΓòÉ 18.1. Help for Status ΓòÉΓòÉΓòÉ

The Status field shows if periodic administration is:

Running
     Select Stop to stop periodic administration.

Not running
     Select Start to start periodic administration.

Locked
     Select Unlock to display information about why the action is locked.


ΓòÉΓòÉΓòÉ <hidden> Help for Start ΓòÉΓòÉΓòÉ

Select Start to start periodic administration.


ΓòÉΓòÉΓòÉ <hidden> Help for Stop ΓòÉΓòÉΓòÉ

Select Stop to stop periodic administration.

All administration actions that are currently active continue until they are
completed. New actions are prevented from starting.


ΓòÉΓòÉΓòÉ <hidden> Help for Unlock ΓòÉΓòÉΓòÉ

Select Unlock to display information about why periodic administration is
locked.


ΓòÉΓòÉΓòÉ 18.2. Help for Indexing ΓòÉΓòÉΓòÉ

Use the Indexing section of the Administration notebook to define conditions
for periodic indexing.

Periodic indexing is recommended if you frequently index documents.

Note:  Make sure that enough disk space is available for indexing activities.

Select whether to process:

Document queue only
     To index the documents listed in the document queue at regular times, or
     if the specified maximum size of the document queue is reached. If one of
     these specifications is fulfilled, SearchManager/2 starts indexing.

     Use this choice if documents are added to the document queue at irregular
     intervals rather than periodically.

Document groups
     To specify that document groups are to be indexed. The Document group list
     contains the document groups to be indexed.

Use the following, as appropriate:

Days or hours
     To specify how often indexing must be done.

Date and time
     To specify the date and time to start periodic indexing of the document
     queue or document groups.

Note:  If you want to index documents at some time in the future, but only once
rather than periodically, specify the date and time, then an interval of zero,
and a queue size of zero.

Push buttons:

Select:

o Add to display the Add Document Groups window.

o Remove to remove a document group from the Document group list.

o Set to save the new settings.

o Refresh to update the information shown.

o Help to display help information for the selected item.


ΓòÉΓòÉΓòÉ 18.2.1. Help for Document Queue Only ΓòÉΓòÉΓòÉ

Select Document queue only to index documents that are listed in the document
queue. This selection has the same effect as the indexing action defined on the
Explicit section. Here, however, indexing is done periodically.

Indexing takes place:

o When the maximum size of the document queue is reached.

  or

o When the specified time is reached.

Documents are removed from, or added to the document index, depending on your
preselection on the Add to Queue window.


ΓòÉΓòÉΓòÉ 18.2.2. Help for Maximum Queue Size ΓòÉΓòÉΓòÉ

Periodic indexing lets you index at a particular time, or when the document
queue contains a particular number of documents, whichever occurs first.

In the Maximum queue size field, specify how large you want to allow the
document queue to become before SearchManager/2 starts indexing.

When the document queue has reached the specified size, indexing starts
automatically, even if the specified time has not yet been reached.


ΓòÉΓòÉΓòÉ 18.2.3. Help for Document Groups ΓòÉΓòÉΓòÉ

If Document groups is selected, SearchManager/2 does periodic indexing for the
selected document groups. SearchManager/2 indexes only those documents in these
groups that have changed since the last time they were indexed.

For each document group contained in the document group list, you can specify
an individual indexing frequency. Select a document group in this list to view
and change its indexing frequency. (When selecting new document groups, the
currently specified indexing frequency is used by default.)

When the specified time is reached, only new or changed documents of the
document groups are added to the document queue.

Note:  Any other documents that are already in the document queue are also
indexed.

Push buttons:

Select:

o Add to display the Add Document Groups window. To add single documents, use
  the Documents queue only choice.

o Remove to remove the selected document group from the list.


ΓòÉΓòÉΓòÉ 18.2.4. Help for Document Group List ΓòÉΓòÉΓòÉ

For each document group contained in the document group list, you can specify
an individual indexing frequency. Select a document group in this list to view
and change its indexing frequency.

When the specified time is reached, only new or changed documents of the
document groups are added to the document queue.

Push buttons:

Select:

o Add to display the Add Document Groups window.

o Remove to remove the selected document group from the list.


ΓòÉΓòÉΓòÉ <hidden> Help for Add ΓòÉΓòÉΓòÉ

Select Add to choose new groups for the document group list using the Add
Document Groups window.

Note:  When selecting new document groups, the currently specified indexing
frequency is used by default.


ΓòÉΓòÉΓòÉ 18.3. Help for Remove ΓòÉΓòÉΓòÉ

Select the items you want to remove from the list. Then click on Remove to
remove the selected document group from the document group list.


ΓòÉΓòÉΓòÉ 18.3.1. Help for Days or Hours ΓòÉΓòÉΓòÉ

In the Days or Hours field, specify the interval between periodic indexing.

You can specify:

o 0 to 99 days
o 0 to 24 hours.

Specify either days or hours.


ΓòÉΓòÉΓòÉ 18.3.2. Help for Date and Time ΓòÉΓòÉΓòÉ

In the Date and Time field, specify when to start periodic indexing.

Note:

o If you specify only date and time and an interval of 0 days and 0 hours,
  periodic indexing is done only once, not periodically.

o The display format of the Date and Time field depends on the country settings
  defined for your OS/2* system.


ΓòÉΓòÉΓòÉ 18.4. Help for Merge ΓòÉΓòÉΓòÉ

Use the Merge section of the Administration notebook to periodically merge the
secondary part of the document index with the primary part.

The speed of indexing is related to the size of the secondary part of the
document index; the larger this part is, the longer indexing takes. By merging
periodically, you ensure that the secondary part remains relatively small.

The secondary part of the document index is merged with the primary part only
if the following prerequisites are both fulfilled:

o The specified interval for merging has passed.

  Specify the starting date, time, and the interval (days or hours) for
  periodic merging.

o The specified number of documents in the secondary part of the document index
  is reached. This limit ensures that Merge is done only when the secondary
  part of the document index is large enough to make merging worth doing.

  Specify the size limit for the secondary part of the document index. When the
  specified interval has passed, Merge starts only if the secondary part of the
  document index has reached the number of documents specified.

To merge documents at some time in the future, but only once rather than
periodically, specify the date and time, then set the interval (days and hours)
to zero, and the number of documents to zero.

Make sure that enough disk space is available for merge activities.

Fields:

Use the following, as appropriate:

Days or hours
     To specify how often merging must be done.

Date and time
     To specify the date and time to start periodic merge.

documents
     To specify the minimum index size to be reached before starting periodic
     merge.

Push buttons:

Select:

o Set to save the new settings.

o Refresh to update the information shown.

o Help to display help information for the selected item.


ΓòÉΓòÉΓòÉ 18.4.1. Help for documents ΓòÉΓòÉΓòÉ

In the documents field, specify the minimum number of documents to be contained
in the secondary part of the document index before periodic merge can start.

Periodic merge starts when both prerequisites are met:

o The interval has passed
o The document index size is reached.


ΓòÉΓòÉΓòÉ 18.4.2. Help for Days or Hours ΓòÉΓòÉΓòÉ

In the Days or Hours field, specify how often you want to merge the secondary
part of the document index into the primary part.

You can specify:

o 0 to 99 days
o 0 to 24 hours.

Specify either days or hours.


ΓòÉΓòÉΓòÉ 18.4.3. Help for Date and Time ΓòÉΓòÉΓòÉ

In the Date and Time fields, specify when to start periodic merge.

As long as the secondary index contains the specified number of documents,
merging is done periodically, starting at this date and time.

To merge documents at some time in the future, but only once rather than
periodically, specify the date and time, then set the interval (days and hours)
to zero, and the number of documents to zero.

The display format of the Date and Time field depends on the country settings
defined for your OS/2* system.


ΓòÉΓòÉΓòÉ 18.5. Help for Cleanup ΓòÉΓòÉΓòÉ

Use the Cleanup section of the Administration notebook to periodically clean up
the document index; that is, to remove from the index any terms that belong to
deleted documents.

When cleanup has finished, Indexing is started to process the documents
contained in the document queue.

Note:

o Make sure that enough disk space is available for cleanup and indexing
  activities.

o If you specify only date and time, periodic cleanup is done only once.

Fields:

Use the following, as appropriate:

Days or hours
     To specify how often cleanup must be done.

Date and time
     To specify the date and time to start periodic cleanup.

Push buttons:

Select:

o Set to save the new settings.

o Refresh to update the information shown.

o Help to display help information for the selected item.


ΓòÉΓòÉΓòÉ 18.5.1. Help for Days or Hours ΓòÉΓòÉΓòÉ

In the Days or Hours field, specify how often you want to remove obsolete terms
from the document index.

You can specify:

o 0 to 99 days
o 0 to 24 hours.

Specify either days or hours.


ΓòÉΓòÉΓòÉ 18.5.2. Help for Date or Time ΓòÉΓòÉΓòÉ

In the Date and Time field, specify when to start periodic cleanup.

Note:

o If you specify only date and time, and specify zero days and zero hours, then
  cleanup is done only once.

o The display format of the Date and Time field depends on the country settings
  defined for your OS/2* system.


ΓòÉΓòÉΓòÉ 19. Help for Status ΓòÉΓòÉΓòÉ

Use the Status section of the Administration notebook to display and control
SearchManager/2 retrieval and indexing activities.

Use the following, as appropriate:

Search status
     To check or specify if users can search for documents. Select Prevent to
     temporarily prevent users from searching for documents; for example, when
     you intend to clear the index.

Add to queue status
     To check or specify if documents can be added to the document queue.
     Select Prevent to temporarily prevent users from adding documents to the
     queue; for example, when you intend to clear the queue.

Select one of the following to display the status for indexing, merge, or
cleanup:

Indexing
     To check the current status of indexing and when indexing was last done.

Merge
     To check the current status of merge and when merge was last done.

Cleanup
     To check the current status of cleanup and when cleanup was last done.

Begin date and time
     Shows when the selected administration action started.

Status
     Shows the status of the selected administration action.

End date and time
     Shows when the selected administration action was last completed.

Indexing messages
     Shows the number of indexing messages that occurred during indexing. They
     occur when, for example, documents cannot be indexed, or are indexed but a
     problem occurs, or when a dictionary cannot be found.

Push buttons:

o If the current status is Prevented, use Permit to allow users to search.

o If the current status is Permitted, use Prevent to stop search activities.

o Use Unlock to display information about why search activities are locked.

o Use Show to display the Indexing Messages window.

o Refresh to update the information shown on the window.

o Help to display help information for the selected item.


ΓòÉΓòÉΓòÉ 19.1. Help for Status ΓòÉΓòÉΓòÉ

The Status field shows if Search activities are:

Permitted
     Select Prevent to prevent users from searching.

Prevented
     Select Permit to allow users to search.

Locked
     Select Unlock to display information about why the action is locked.


ΓòÉΓòÉΓòÉ <hidden> Help for Permit ΓòÉΓòÉΓòÉ

If the current status is Prevent, select Permit to allow users to search.


ΓòÉΓòÉΓòÉ <hidden> Help for Prevent ΓòÉΓòÉΓòÉ

If the current status is Permit, select Prevent to prevent users from
searching.


ΓòÉΓòÉΓòÉ <hidden> Help for Unlock ΓòÉΓòÉΓòÉ

Select Unlock to display information about why search activities are locked.


ΓòÉΓòÉΓòÉ 19.2. Help for Status ΓòÉΓòÉΓòÉ

The Status field shows if Add to queue activities are:

Permitted
     Select Prevent to prevent add-to-queue activities.

Prevented
     Select Permit to allow users to add documents to the queue for indexing.

Locked
     Select Unlock to display information about why the action is locked.


ΓòÉΓòÉΓòÉ <hidden> Help for Permit ΓòÉΓòÉΓòÉ

Select Permit to allow users to add documents to the queue for indexing.


ΓòÉΓòÉΓòÉ <hidden> Help for Prevent ΓòÉΓòÉΓòÉ

Select Prevent to prevent users from adding documents to the queue for
indexing.


ΓòÉΓòÉΓòÉ <hidden> Help for Unlock ΓòÉΓòÉΓòÉ

Select Unlock to display information about why add-to-queue activities are
locked.


ΓòÉΓòÉΓòÉ 19.3. Help for Indexing ΓòÉΓòÉΓòÉ

Select Indexing to see the current status of indexing activities and when
indexing began and ended.

The number of documents that encountered a problem during indexing is displayed
in the Indexing messages field.


ΓòÉΓòÉΓòÉ 19.4. Help for Merge ΓòÉΓòÉΓòÉ

Select Merge to see the current status of merge activities and when merge began
and ended.


ΓòÉΓòÉΓòÉ 19.5. Help for Cleanup ΓòÉΓòÉΓòÉ

Select Cleanup to see the current status of cleanup activities and when cleanup
began and ended.


ΓòÉΓòÉΓòÉ 19.6. Help for Date and Time (Begin) ΓòÉΓòÉΓòÉ

The Date and Time fields show when the selected administration activity
started. The contents depend on the status of the current administration
activity.


ΓòÉΓòÉΓòÉ 19.7. Help for Date and Time (End) ΓòÉΓòÉΓòÉ

The Date and Time fields show when the selected administration activity was
last completed. The contents depend on the status of the current administration
activity.


ΓòÉΓòÉΓòÉ 19.8. Help for Status ΓòÉΓòÉΓòÉ

The Status field shows if Indexing, Merge, or Cleanup activities are:

Running
     The selected administration activity is currently being processed. The
     displayed date and time show when the selected administration activity
     started. The end date and time is not yet available.

Not Running
     The selected administration activity is currently not running. The
     displayed date and time show when the selected administration activity was
     started and when it was last completed.

Locked
     The selected administration activity is currently locked, because a
     problem was encountered. Select Unlock to display further information.

     Note:  The displayed begin date and time show when the selected
     administration activity was started. They do not specify when the Locked
     status occurred.

Queuing
     The indexing activity is currently being processed. SearchManager/2 is
     checking a document group to add updated or new documents to the document
     queue.

     Note:  The displayed date and time show when indexing started. The end
     date and time is not yet available.


ΓòÉΓòÉΓòÉ <hidden> Help for Unlock ΓòÉΓòÉΓòÉ

Select Unlock to display information about why Indexing, Merge, or Cleanup
activities are locked. When you have resolved the problem, select Unlock.


ΓòÉΓòÉΓòÉ 19.9. Help for Indexing Messages ΓòÉΓòÉΓòÉ

The Indexing messages field shows the number of indexing messages that occurred
during indexing. Select Show to display the Indexing Messages window.


ΓòÉΓòÉΓòÉ <hidden> Help for Show ΓòÉΓòÉΓòÉ

Select Show to display the Indexing Messages window. This window provides
information about why documents cannot be indexed correctly; for example, when
documents cannot be indexed, or are indexed but a problem occurs, or when a
dictionary cannot be found.


ΓòÉΓòÉΓòÉ 20. Help for Rules ΓòÉΓòÉΓòÉ

Use the Rules section of the Administration notebook to define how a file's
extension can be used to identify a document's type, language, and Coded
Character Set Identifier (CCSID).

Note:  The specifications on this section are only valid if you are using the
OS/2* file system or Lotus Notes**. For Lotus Notes documents, use the Rules
section to define a default rule.

When indexing documents SearchManager/2 needs to know:

o Which type of document it is; if it is a WordPerfect** document, for example,
  or a flat ASCII file

o Which language the document is written in

o Which CCSID is used.

Note:  SearchManager/2 can detect many document types automatically. However,
detecting the language and the CCSID is more difficult. So, here you can
establish file-naming conventions so that SearchManager/2 can identify these
three factors using each document's file extension.

Fields:

Use the following, as appropriate:

Extension
     To specify the file extension.

Include
     To include or exclude from the indexing process those documents having the
     specified file extension.

Format
     To select the format.

Language
     To select the main language used in the document.

CCSID
     To select the Coded Character Set ID.

Push buttons:

Select:

o Set to save the new settings.

o Refresh to update the information shown.

o Help to display help information for the selected item.


ΓòÉΓòÉΓòÉ 20.1. Help for List of Indexing Rules ΓòÉΓòÉΓòÉ

The Indexing rules list shows the indexing rules you have specified.

You can update this list:

o To add new indexing rules, specify the required information and select Add.

  Note:  If you select an existing rule, SearchManager/2 includes its values in
  the New rule box.

o To remove indexing rules, select the item to be removed, then select Remove.

o For Lotus Notes** documents, use the Default rule fields, specifying:

   Format
        ASCII

   Language
        Set according to the installed version of Lotus Notes, or to the
        language in which the documents are written; one language is supported

   CCSID
        850, the default for Lotus Notes.


ΓòÉΓòÉΓòÉ <hidden> Help for Remove ΓòÉΓòÉΓòÉ

Select Remove to remove the selected item from the list of indexing rules.


ΓòÉΓòÉΓòÉ 20.2. Help for Extension ΓòÉΓòÉΓòÉ

In the Extension field specify the file extension for which you want to add
indexing rules.

The extension must follow the OS/2* file naming conventions. It can have up to
3 characters.


ΓòÉΓòÉΓòÉ 20.3. Help for Include ΓòÉΓòÉΓòÉ

To specify whether to include documents with this file extension in the
indexing process, select YES or NO from the Include drop-down list.

Note:  If you select NO, you cannot select Format, Language, and CCSID.


ΓòÉΓòÉΓòÉ 20.4. Help for Format ΓòÉΓòÉΓòÉ

This field is available only if Include is YES.

Select the text format from the Format drop-down list.

SearchManager/2 supports the following text formats:

o Revisable Form Text (RFT)
o Final Form Text (FFT)
o Flat ASCII
o WordPerfect** 5.x
o Word for Windows
o Rich Text Format (RTF)
o Ami Pro**
o SearchManager/370 Editable Condensed Text Format (ECTF)
o SearchManager/2 Text Format (refer to SearchManager/2: Programming Interfaces
  for more details)

When indexing a document from a Lotus Notes** library system, these can be in
ASCII or RFT format.


ΓòÉΓòÉΓòÉ 20.5. Help for Language ΓòÉΓòÉΓòÉ

This field is available only if Include is YES.

This list shows the languages supported by the installed dictionaries.

To specify the language used in a document, select the language from the
Language drop-down list.

For Lotus Notes** documents set the language according to the installed version
of Lotus Notes, or to the language in which the documents are written. One
language is supported.


ΓòÉΓòÉΓòÉ 20.6. Help for CCSID ΓòÉΓòÉΓòÉ

This field is available only if Include is YES.

Select the Coded Character Set ID (CCSID) of a document from the CCSID
drop-down list.

For Lotus Notes** documents set the CCSID to 850.


ΓòÉΓòÉΓòÉ <hidden> Help for Add ΓòÉΓòÉΓòÉ

Select Add to add the specified indexing rule for a document type to the list
of indexing rules.


ΓòÉΓòÉΓòÉ 20.7. Help for Default Format ΓòÉΓòÉΓòÉ

Select the default text format from the Format drop-down list.

SearchManager/2 can identify many document types automatically. For those that
it cannot recognize, the indexing rules enable SearchManager/2 to identify
document type, language, and CCSID by means of the file extension. For those
files whose extension is not included in these rules, SearchManager/2 assumes
the default type that you specify here.

Use this field to specify a default text for Lotus Notes** documents.

SearchManager/2 supports the following text formats:

o Revisable Form Text (RFT)
o Final Form Text (FFT)
o Flat ASCII
o WordPerfect** 5.x
o Word for Windows
o Rich Text Format (RTF)
o Ami Pro**
o SearchManager/370 Editable Condensed Text Format (ECTF)
o SearchManager/2 Text Format (refer to SearchManager/2: Programming Interfaces
  for more details)

When indexing a document from a Lotus Notes** library system, these can be in
ASCII or RFT format.


ΓòÉΓòÉΓòÉ 20.8. Help for Default Language ΓòÉΓòÉΓòÉ

To specify the default language used for the selected format, select the
language from the Language drop-down list.

The indexing rules enable SearchManager/2 to identify the main language used in
the document by means of the file extension. For those files whose extension is
not included in these rules, SearchManager/2 assumes the language that you
specify here.


ΓòÉΓòÉΓòÉ 20.9. Help for Default CCSID ΓòÉΓòÉΓòÉ

Select the default Coded Character Set ID (CCSID) for the selected format and
language from the CCSID drop-down list.

The indexing rules enable SearchManager/2 to identify the CCSID used for the
document by means of the file extension. For those files whose extension is not
included in these rules, SearchManager/2 assumes the CCSID that you specify
here.


ΓòÉΓòÉΓòÉ 21. Help for Stop Words ΓòÉΓòÉΓòÉ

Use the Stop words section of the Administration notebook to define irrelevant
words that you want omitted from the document index. This not only reduces the
size of the index and reduces the time it takes to search through it, it also
increases the precision of your search.

Examples of stop words are:

and
of
by
in
or

Note:

o Each dictionary has its own list of stop words.

o In a client/server system, the list of stop words for a particular index can
  be changed only at the server workstation on which the SearchManager/2 search
  service is installed.

Fields:

Use the following, as appropriate:

Language
     To select the language of the dictionary whose stop-word list you want to
     use.

List of stop words
     To view or remove stop words.

New stop word
     To add a new stop word.

Push buttons:

Select:

o Remove to remove the selected stop words from the list.

o Add to add the specified stop word to the list.

o Set to save any changes made to the stop-word list.

o Refresh to update the information shown on the window.

o Help to display help information for the selected item.


ΓòÉΓòÉΓòÉ 21.1. Help for Language List ΓòÉΓòÉΓòÉ

Specify the language of the dictionary whose stop-word list you want to use,
from the Language drop-down list.


ΓòÉΓòÉΓòÉ 21.2. Help for List of Stop Words ΓòÉΓòÉΓòÉ

The Stop word list shows the stop words provided for the selected language.

To remove words from this list, select them, then click on Remove.

To add a stop word to this list, specify it in the New stop word field, then
select Add.


ΓòÉΓòÉΓòÉ <hidden> Help for Remove ΓòÉΓòÉΓòÉ

Select Remove to remove the selected words from the list of stop words.


ΓòÉΓòÉΓòÉ 21.3. Help for New Stop Word ΓòÉΓòÉΓòÉ

In the New stop word field, specify the word you want to add to the list of
stop words. Then press Add.

A stop word can have up to 255 characters.


ΓòÉΓòÉΓòÉ <hidden> Help for Add ΓòÉΓòÉΓòÉ

Select Add to add the specified word to the list of stop words.


ΓòÉΓòÉΓòÉ 22. Help for Properties ΓòÉΓòÉΓòÉ

Use the Properties section of the Administration notebook to define the index
type and the programs to use for the type of library system or file system you
are using.

The index types are:

o Linguistic

  Any form of a search term matches any other form occurring in one of the
  indexed documents. For example, the search term

    mouse
  matches the document terms

    mouse, mice, MICE
  and so on.

o Precise

  The terms in the documents are indexed in exactly the same form as they occur
  in the document. For example, the search term

    mouse
  matches only the document term

    mouse
  and no other variations like Mouse.

o Dual

  The dual index is a combination of the other two types.

Changing the document index type

To change the index type to, or from, linguistic, the document index must first
be cleared. A change from precise to dual, or from dual to precise, can be done
when the index is not empty, but the change takes place during the next merge.

You can select to change to one of the following index types:

o Precise
o Dual
o Linguistic

The Current field shows which index type is currently used, and the Pending
field displays the index type you want to change to. It displays this until the
change has taken place.

To cancel the request to change the index type select Cancel pending request.

Note:  You cannot change to another index type while Merge is running.

Library services

If you want to use Lotus Notes** or other library services as described in
SearchManager/2: Programming Interfaces, you must specify the names of the
interface programs you intend to use (library services DLLs):

Client
     To specify the library services DLL for the client.

Server
     To specify the library services DLL for the server.

When SearchManager/2 is first installed, these fields contain the names of the
DLLs for the OS/2* file system:

o Client: EHSLSCFS
o Server: EHSLSSFS

SearchManager/2 also provides Library Service DLLs which support Lotus Notes
Version 3. If you are using Lotus Notes, enter the following DLL names:

o Client: EHSLSCLN
o Server: EHSLSSLN

Push buttons:

Select:

o Set to save any changes made to the Properties section.

o Refresh to update the information shown on the window.

o Help to display help information for the selected item.


ΓòÉΓòÉΓòÉ 22.1. Help for Precise ΓòÉΓòÉΓòÉ

Select Change to and Precise if you want to use a precise index.

In a precise index, the terms of the documents are indexed exactly as they are
found in the documents.

Only exact search terms are searched for and found in the documents.

A precise index:

o Is case sensitive.

o Offers faster retrieval and indexing compared to the other index types.

o Requires more disk space than the linguistic index, because each indexed term
  is stored "as is" in the index; that is, each different spelling, case, and
  tense is stored.

The linguistic functions used to index documents for a precise index are:

o Word and sentence separation
o Sentence-begin processing
o Stop-word filtering.

The following table shows how some English and German keywords are extracted
from document text:

ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöéDocument text    ΓöéTerm in index    ΓöéExplanation      Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé...Mouse...      ΓöéMouse            ΓöéNo normalization Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
│KДfer            │KДfer            │No normalization │
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé...mice...       Γöémice             ΓöéNo lemmatization Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé...swum...       Γöéswum             ΓöéNo lemmatization Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöécomputer-system  Γöécomputer-system  ΓöéNo decomposition Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéWetterbericht    ΓöéWetterbericht    ΓöéNo decomposition Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöéa report about   Γöéreport, animals  ΓöéStop-word        Γöé
Γöéall animals      Γöé                 Γöéfiltering: a,    Γöé
Γöé                 Γöé                 Γöéabout, all       Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéI drive my car   Γöédrive, car,      ΓöéNo part of speechΓöé
Γöéquickly.         Γöéquickly          Γöéfiltering.       Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéSage mir...      ΓöéSage, sage       ΓöéSentence-begin   Γöé
Γöé                 Γöé                 Γöéprocessing.      Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ


ΓòÉΓòÉΓòÉ 22.2. Help for Dual ΓòÉΓòÉΓòÉ

Select Change to and Dual if you want to use a dual index.

The dual index is a precise index with linguistic support. You can use precise
and linguistic search terms for searching documents:

o When you select Inflected forms any form and any case of a search term
  matches any other form and any other case in a document.

o When you deselect Inflected forms only the exact spelling and case result in
  found matches.

The dual index:

o Is the most flexible index type; you can decide for each individual search
  term whether to search linguistically or precisely.

o Requires more disk space than the other index types.

o Requires more time for indexing and searching than the linguistic index.

o Stores not only the normalized and lemmatized form (base form) of each term,
  but also the original term.

o Processes search terms that contain global characters. This means that
  matching for word fragments is case sensitive as it is when searching in a
  precise index.


ΓòÉΓòÉΓòÉ 22.3. Help for Linguistic ΓòÉΓòÉΓòÉ

Select Change to and Linguistic if you want to use a linguistic index.

The linguistic index uses linguistic functions and dictionaries during text
analysis of documents and query processing.

During query processing the search terms are compared to the terms found in the
index. This means any form and any case of a word in the document matches any
form and any case of a search term.

A linguistic index:

o Is not case sensitive.

o Finds a lot of documents that qualify for the search terms (high recall),
  because all inflections of the specified search terms are processed during
  text analysis and query processing.

o Requires less disk space than the other index types supported by
  SearchManager/2.

o Requires more time for indexing and search than the precise index.
When linguistic index processes search terms that contain global characters,
the word fragments are compared to the base (stem) forms in the index. For
example, if the document text contains:

   I swum
the linguistic index stores the verb as:

   swim
and handles all inflections of this term, using a dictionary.

If you specify a search term that contains a global character, such as:

swu*
The linguistic index reduces this term to:

swu
and searches only for terms starting with these 3 characters. This is why the
specified word fragment does not find the verb:

swim
To find this text, you must specify swi* instead.

The linguistic functions used to index documents for a linguistic index are:

o Word and sentence separation
o Lemmatization
o Normalization
o Word decomposition
o Stop-word filtering and part-of-speech filtering.

The following table shows how some English and German terms are extracted from
document text:

ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöéDocument text    ΓöéTerm in Index    ΓöéExplanation      Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéMouse...         Γöémouse            ΓöéNormalization    Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
│KДfer            │kaefer           │Normalization    │
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé...swum...       Γöéswim             ΓöéLemmatization    Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé...mice...       Γöémouse            ΓöéLemmatization    Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöécomputer-system  Γöécomputer-system, ΓöéDecomposition    Γöé
Γöé                 Γöécomputer, system Γöé                 Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéWetterbericht    Γöéwetterbericht,   ΓöéDecomposition    Γöé
Γöé                 Γöéwetter, bericht  Γöé                 Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöéa report about   Γöéreport, animal   ΓöéStop-word        Γöé
Γöéall animals      Γöé                 Γöéfiltering: a,    Γöé
Γöé                 Γöé                 Γöéabout, all       Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéI drive my car   Γöédrive, car       ΓöéPart-of-speech   Γöé
Γöéquickly.         Γöé                 Γöéfiltering: only  Γöé
Γöé                 Γöé                 Γöénouns, verbs,    Γöé
Γöé                 Γöé                 Γöéadjectives.      Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ


ΓòÉΓòÉΓòÉ 22.4. Help for Client ΓòÉΓòÉΓòÉ

In the Client field specify the name of the interface program (DLL) to be used
by SearchManager/2 to work with the library services for the client.

The DLL file name can have up to 8 characters and no extension. It must follow
the OS/2* file-naming conventions.

When SearchManager/2 is first installed, these fields contain the names of the
DLLs for the OS/2* file system:

Client: EHSLSCFS
Server: EHSLSSFS

SearchManager/2 also provides Library Service DLLs which support Lotus Notes**
Version 3. If you are using Lotus Notes, enter the following DLL names:

Client: EHSLSCLN
Server: EHSLSSLN

If you intend to use different library services, refer to SearchManager/2:
Programming Interfaces for more information.

Note:  Specify the new library services DLL files before indexing documents.

If, however, you change the library services DLL files for an existing index,
make sure that the new services are compatible with those that are currently
used. If they are not compatible, documents that have already been indexed may
no longer be shown in a search result, and periodic indexing of existing
document groups may no longer work.


ΓòÉΓòÉΓòÉ 22.5. Help for Server ΓòÉΓòÉΓòÉ

In the Server field specify the name of the interface program (DLL) to be used
by SearchManager/2 to work with the library services for the server.

The DLL file name can have up to 8 characters and no extension. It must follow
the OS/2* file-naming conventions.

When SearchManager/2 is first installed, these fields contain the names of the
DLLs for the OS/2* file system:

Client: EHSLSCFS
Server: EHSLSSFS

SearchManager/2 also provides Library Service DLLs which support Lotus Notes**
Version 3. If you are using Lotus Notes, enter the following DLL names:

Client: EHSLSCLN
Server: EHSLSSLN

If you intend to use different library services, refer to SearchManager/2:
Programming Interfaces for more information.

Note:  Specify the new library services DLL files before indexing documents.

If, however, you change the library services DLL files for an existing index,
make sure that the new services are compatible with those that are currently
used. If they are not compatible, documents that have already been indexed may
no longer be shown in a search result, and periodic indexing of existing
document groups may no longer work.


ΓòÉΓòÉΓòÉ 22.6. Help for Current ΓòÉΓòÉΓòÉ

The Current field displays the type of index currently used.


ΓòÉΓòÉΓòÉ 22.7. Help for Change To ΓòÉΓòÉΓòÉ

Select Change to to specify a new index type. Then select the index type and
click on Set.

You can select one of the following index types:

o Linguistic index.

  Note:  This choice is available only if the document index is empty (for
  example, after installation or clear).

o Precise index. If you select this index type, the new selection is pending
  until the document index is next merged.

o Dual index. If you select this index type, the new selection is pending until
  the document index is next merged.


ΓòÉΓòÉΓòÉ 22.8. Help for Pending ΓòÉΓòÉΓòÉ

The Pending field specifies the new type of index that you have chosen.

To cancel this request, select Cancel pending request.

Note:  When changing from precise to dual or from dual to precise, the change
does not occur immediately; the Pending field displays the newly selected index
type until the secondary part of the document index has been merged with the
primary part.

After merge (periodic merge or explicit merge) the new index type is active and
displayed in the Current field.


ΓòÉΓòÉΓòÉ 22.9. Help for Cancel Pending Request ΓòÉΓòÉΓòÉ

Select Cancel pending request if you specify to change to a new index type, but
then decide not to do so. Click on Set to save your new specification.

Note:  When changing from precise to dual or from dual to precise, the change
does not occur immediately; the Pending field displays the newly selected index
type until the secondary part of the document index has been merged with the
primary part.

After merge (periodic merge or explicit merge) the new index type is active and
displayed in the Current field.


ΓòÉΓòÉΓòÉ 23. Help for Indexing Messages ΓòÉΓòÉΓòÉ

Use the Indexing Messages window to check which documents could not be indexed
or if dictionaries were missing.

Click on the item you want to check to display the corresponding indexing
message in the Reason field.

Fields:

Use the following, as appropriate:

Indexing message
     To select an item to display the corresponding indexing information in the
     Reason field.

Reason
     To display a detailed description for the item selected in the indexing
     message list.

Push buttons:

Select:

o Remove selected to remove the selected items from the list.

o Remove all to remove all items from the list.

o Cancel to remove the window without any changes.

o Help to display help information.


ΓòÉΓòÉΓòÉ 23.1. Help for Indexing Message List ΓòÉΓòÉΓòÉ

The indexing message list shows the date, time, and the fully qualified name of
the documents or dictionaries that encountered a problem during indexing.

Click on an item contained in this list, to display the corresponding
diagnostic message in the Reason field.

If you have analyzed the reason, select the following as appropriate:

o Remove selected
o Remove all.


ΓòÉΓòÉΓòÉ <hidden> Help for Remove Selected ΓòÉΓòÉΓòÉ

Select Remove selected to remove the selected items from the indexing message
list.


ΓòÉΓòÉΓòÉ <hidden> Help for Remove All ΓòÉΓòÉΓòÉ

Select Remove all to remove all items from the indexing message list.


ΓòÉΓòÉΓòÉ 23.2. Help for Reason ΓòÉΓòÉΓòÉ

The Reason field displays the diagnostic information provided for the selected
item.


ΓòÉΓòÉΓòÉ 24. Help for Unlock ΓòÉΓòÉΓòÉ

Use the Unlock window to check why the action was locked. The Reason field
displays the corresponding diagnostic information.

Note:  If you cannot solve the problem, contact your IBM service
representative, stating the Internal Reason code.

Push buttons:

Select:

o Unlock to reset the lock condition and to continue processing.

o Cancel to remove the window without any changes.

o Help to display help information.


ΓòÉΓòÉΓòÉ 24.1. Help for Reason ΓòÉΓòÉΓòÉ

The Reason field displays the diagnostic information provided for the lock
condition.

Select Unlock when you have resolved the problem and want to continue
processing.

Note:  If you cannot solve the problem, contact your IBM service
representative.


ΓòÉΓòÉΓòÉ <hidden> Help for Unlock ΓòÉΓòÉΓòÉ

Select Unlock to reset the lock condition and to continue processing.


ΓòÉΓòÉΓòÉ <hidden> Help for Refresh ΓòÉΓòÉΓòÉ

Select Refresh to update the information shown in the window.

Note:  If you have changed the specifications on the window, but you have not
yet selected Set, you can redisplay the initial settings by selecting Refresh.


ΓòÉΓòÉΓòÉ <hidden> Help for Set ΓòÉΓòÉΓòÉ

Select Set to save the new specifications.


ΓòÉΓòÉΓòÉ <hidden> Help for OK ΓòÉΓòÉΓòÉ

Select OK to accept the information in this window and close it.


ΓòÉΓòÉΓòÉ <hidden> Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to remove the window without applying any changes made in this
window.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

Select OK to start indexing.

Select Cancel to end this task.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

Select OK to start merging the document index.

Select Cancel to end this task.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

Select OK to start index cleanup.

Select Cancel to end this task.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

Select OK to start clearing the document queue.

Select Cancel to end this task.

Caution:  The document queue is emptied and its content is reset to zero
document entries.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

Select OK to start clearing the document index.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

An error was detected that prevented this function from completing.

Unlock the function and try again. If the function continues to lock, contact
your IBM service representative.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

An error was detected that prevented this function from starting or completing.
An OS/2 exception may have occurred.

Unlock the function and try again. If the function continues to lock, contact
your IBM service representative.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

An error was detected that prevented this function from completing.

It is possible that the EHSNLPS environment variable at the server workstation
is not set or is missing. Check this environment variable in the CONFIG.SYS
file of the server workstation. If necessary, correct it and restart the
system.

If the function continues to lock, contact your IBM service representative.

Information that can assist IBM in diagnosing the cause of the error is
contained in the file EHSABEND.xxx in the path pointed to by the EHSWORK
environment variable in your CONFIG.SYS file.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The Library Services DLLs could not be loaded.

Check that the name of both DLLs are entered correctly on the Properties page
of the Administration notebook. On a client workstation, check that the names
of the DLLs correspond exactly to the names at the server workstation.

Check that the LIBPATH statement in your CONFIG.SYS file still points to the
Library Services DLLs.

If the problem persists, contact your IBM service representative.

Information that can assist IBM in diagnosing the cause of the error is
contained in the file EHSABEND.xxx in the path pointed to by the EHSWORK
environment variable in your CONFIG.SYS file.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The Library Services functions appear to be faulty.

If you are using your own Library Services functions, look for the error there.

If you are using the OS/2 file system, contact your IBM service representative.

Information that can assist IBM in diagnosing the cause of the error is
contained in the file EHSABEND.xxx in the path pointed to by the EHSWORK
environment variable in your CONFIG.SYS file.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

There is a problem working with the national language processor (NLP) service.
Check whether the installation of the NLP service was completed successfully.

If the problem persists, contact your IBM service representative.

Information that can assist IBM in diagnosing the cause of the error is
contained in the file EHSABEND.xxx in the path pointed to by the EHSWORK
environment variable in your CONFIG.SYS file.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

An error was detected that prevented this function from completing.

The server workstation requires additional memory. Reduce its memory
requirement by closing applications or change its configuration to increase
available memory.

If the function continues to lock, contact your IBM service representative.

Information that can assist IBM in diagnosing the cause of the error is
contained in the file EHSABEND.xxx in the path pointed to by the EHSWORK
environment variable in your CONFIG.SYS file.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

An error was detected that prevented this function from completing.

Contact your IBM service representative.

Information that can assist IBM in diagnosing the cause of the error is
contained in the file EHSABEND.xxx in the path pointed to by the EHSWORK
environment variable in your CONFIG.SYS file.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

An error was detected that prevented this function from completing.

It is possible that the error occurred when accessing your index files.

If this error occurred immediately after installation try reinstalling the
system. Otherwise, check that the index files have not inadvertently been
deleted or whether the disk is full.

If the function continues to lock, contact your IBM service representative.

Information that can assist in diagnosing the cause of the error is contained
in the file EHSABEND.xxx in the path pointed to by the EHSWORK environment
variable in your CONFIG.SYS file.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

An error was detected that prevented this function from completing.

It is possible that a disk is full on the server workstation.

If this error occurred immediately after installation, try reinstalling the
system. Otherwise, contact your IBM service representative.

Information that can assist IBM in diagnosing the cause of the error is
contained in the file EHSABEND.xxx in the path pointed to by the EHSWORK
environment variable in your CONFIG.SYS file.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

An error may have occurred during installation. Ensure that you have completed
all the installation steps.

Ensure in particular that the correct environment variables are in the
CONFIG.SYS file, and that the PATH, DPATH, and LIBPATH point to your
SearchManager/2 installation.

If the problem persists, reinstall SearchManager/2.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The system requires additional memory. Reduce the memory requirement by closing
applications or change your configuration to increase available memory.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

An error was detected when starting the search service.

Refer to the manual SearchManager/2: Retrieval and Indexing for information
about the return code.

If this does not lead to a solution of the problem, write down the diagnosis
information that appears below the message, and contact your administrator or
IBM service representative.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

You tried to browse a document, but the Browser window could not be opened
within the allowed time.

This could be because:

o You have other active processes that have slowed down your system.

  Stop these processes and try again to browse the document.

o There are too many Browser windows open.

o The program files for the Browser could not be found. Check that the correct
  environment variables are in the CONFIG.SYS file, and that the PATH, DPATH,
  and LIBPATH point to your SearchManager/2 installation.

  If the problem persists, reinstall SearchManager/2.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

SearchManager/2 cannot make the query because you have not specified search
terms, or the search terms that you have specified are all stop words.

Type the text you are looking for in the Search terms fields and try again.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The query cannot be opened.

Check that the definition of the search service is correct. If it is, then, if
you are working at a client workstation in a client/server system, try deleting
the search service object and creating it again.

Otherwise, try reinstalling SearchManager/2.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

SearchManager/2 cannot find a search service having the name you have
specified; or, you are trying to process a new query without specifying the
name of a search service.

Check the search service name in the Defaults section of the Query notebook.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The query contains too many search terms or synonyms. Reduce the number of
terms or synonyms, and try again.

It is also possible that you are using global characters in a way that causes
SearchManager/2 to search for too many terms. If this is the case, modify your
use of global characters to make the search more specific.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The action you are trying to do failed because the search service is currently
not available.

If you are at a client workstation in a client/server system, ask your system
administrator to start the search service. Check that you are still logged on
to the LAN. Otherwise, start the search service by selecting Start on the
pop-up menu of the Search service object.

If the problem persists, check the Definitions page in the search service's
Settings notebook. The settings there must correspond to those at the server
workstation:

o The machine names must be identical.

o The communication protocols must be of the same type: named pipes, or TCP/IP.
  If the communication type is named pipes, the search service must be
  installed on a LAN server workstation.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The search service cannot recognize the Coded Character Set Identifier (CCSID).
This ID is specified in the CODEPAGE parameter in your CONFIG.SYS file.

The CODEPAGE parameter should be one of the following:

  37  USA, Canada, and others
 273  Austria, Germany
 277  Denmark, Norway
 278  Finland, Sweden
 280  Italy
 284  Spain, Latin America
 285  United Kingdom
 297  France
 437  USA
 500  International Latin-1
 819  Latin-1
 850  Latin-1
 860  Portugal
 861  Iceland
 863  Canada
 865  Denmark, Norway
 871  Iceland
4946  Latin-1 (Codepage 850)
Correct the CODEPAGE parameter and restart your system.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The action you have just selected is currently not available.

If you are at a client workstation in a client/server system, ask your system
administrator to check whether the action is locked.

Otherwise, check this yourself, using the Status section of the Administration
notebook.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The action you have just selected is currently locked.

If you are at a client workstation in a client/server system, ask your system
administrator to check why the action is locked, and to unlock it.

Otherwise, check this yourself, using the Status section of the Administration
notebook. Unlock the action and continue processing.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

A language is selected for which no dictionary is installed. Either deselect
the language, or check that the dictionary for this language has been installed
correctly. If the problem persists, install the dictionary again.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The search terms in the query you are making contain a stop word. Stop words
are those that carry no significant information, like which, however, and any.

These words are not in the document index, so SearchManager/2 did not attempt
to use the stop word while searching.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The search service is busy. You cannot make a connection to the search service
at the moment.

During installation, a limit was set on the number of tasks that the search
service is allowed to process simultaneously. This limit has been exceeded,
possibly because too many users are working with the system.

Try again later. If the problem persists, contact your system administrator.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The search service is currently changing or merging the document index. The
action that you have requested cannot be made until the search has completed
its current task.

Monitor the status of the search service and try the action again later.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

Communication with the search service has failed.

This could be caused by a lack of memory space or by a problem that occurred
during installation.

Reduce the amount of memory you need by closing applications. If this doesn't
help, try restarting your system. If the problem persists, change your
configuration to increase memory space and restart your system.

If the problem still persists, reinstall SearchManager/2.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The environment variable EPSNLPS in the CONFIG.SYS file indicates the path to
the dictionaries. This path could be set incorrectly.

Check your CONFIG.SYS file to ensure that the path pointed to by the
environment variable is the one in which the dictionaries are installed.

If you are working at a client workstation in a client/server system, contact
your system administrator.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

One of the index files cannot be found or is faulty.

Check your CONFIG.SYS file to ensure that the path pointed to by the EHSDATA
environment variable is the one containing the index files. Try also restarting
your system.

If the problem persists, and the error occurred when you pressed SHOW to
display indexing messages, delete the file EHSDOCER.DAT. (This file is in the
path indicated by the environment variable EHSDATA in your CONFIG.SYS file.)
The latest indexing messages are then lost, but the file is recreated when
documents are next indexed.

If the problem occurred at a different time, one of the other indexing files
could be missing or faulty. In this case, clear the index by pressing the
(Index) Clear push button on the Explicit page of the Administration notebook.
All index entries are lost when you do this.

If the problem still persists, reinstall SearchManager/2.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The data file EHSCXCOM.CFG cannot be found.

Check your CONFIG.SYS file to ensure that the path pointed to by the EHSDATA
environment variable is the one containing the data file EHSCXCOM.CFG. Try also
restarting your system.

If the problem persists, and the error occurred on a SearchManager LAN Server/2
server or client workstation, delete the file EHSCXCOM.CFG (if it exists) and
replace it with a file that has a size of zero bytes.

(Tip: To do this, use the OS/2* command

 rd >EHSCXCOM.CFG

This brings an OS/2 error message, which you can ignore.)

Now build the contents of the file again by redefining the local search service
(if the problem occurred at a server workstation) or by reaccessing the search
service (if the problem occurred at a client workstation).

If the problem still persists or the error occurred on a SearchManager/2 single
workstation system, save your index files and then reinstall SearchManager.

To save your index files, (SearchManager/2 and SearchManager LAN Server/2 only;
not applicable for a SearchManager Client/2 workstation):

 1. Save all files having the extensions DAT and IDX by copying them to a
    different location. These files are located in the directory that is
    pointed to by the EHSDATA environment variable in your CONFIG.SYS.

 2. Reinstall SearchManager

 3. Copy all the index files that you saved back to the directory that is
    pointed to by the EHSDATA environment variable.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

There is not enough memory space to store one of the index files, or one of the
index files is faulty.

Reduce the memory requirement by closing applications. If this doesn't help,
try restarting your system. If the problem persists, change your configuration
to increase memory space and restart your system.

Otherwise, one of the indexing files is missing or is faulty. In this case,
clear the index by pressing the (Index) Clear push button on the Explicit page
of the Administration notebook. All index entries are lost when you do this.

If the problem still persists, reinstall SearchManager/2.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The number of indexing messages that can be displayed is limited. Currently,
there are more messages than can be displayed. To display those messages that
are missing from the list:

 1. Delete those messages that you no longer need

 2. Press OK to dismiss the panel

 3. Press Show again.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

Information for this administration section is missing.

If you are working on the Periodic section, the missing information should be
in the file EHSPINDX.DAT. If you are displaying indexing messages, the missing
information should be in the file EHSDOCER.DAT.

Check your CONFIG.SYS file to ensure that the path pointed to by the EHSDATA
environment variable is the one containing these files.

Try also restarting your system.

If the problem still persists, reinstall SearchManager/2.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

A problem occurred while reading a Thesaurus file. Check your authorization to
access the path that contains the Thesaurus files. This path is pointed to by
the environment variable FKZTEUS in your CONFIG.SYS file.

If the problem persists, reinstall the Thesaurus data files.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The dictionaries that are installed on your workstation are not compatible with
this version of SearchManager/2.

Check if dictionaries from another product are in the path pointed to by the
CONFIG.SYS environment variable EHSNPLS.

Check also if you have an older version of the dictionary installed on your
workstation. If so, remove the old version.

If the problem persists, contact your IBM service representative.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

A problem occurred while reading from or writing to the dictionary file.

If this happened while you were adding permanent synonyms to the dictionary, or
while you were changing the stop-word list, check your authorization to access
the appropriate directories.

The directory for synonyms is pointed to by the EHSDATA environment variable in
your CONFIG.SYS file. The directory for stop words is pointed to by the EHSNLPS
environment variable.

If the problem still persists, install the dictionaries again.

If an addenda dictionary containing permanent user synonyms is faulty, you can
erase this file, but then these additional synonyms are lost. The addenda
dictionary files have the extension .ADB and are in the directory pointed to by
the environment variable EHSDATA.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

A dictionary is faulty. Install the dictionaries again.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

No dictionary is currently active.

An error, described in a previous message, has caused all dictionaries to be no
longer available.

Correct the error as described in the previous message.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The search service does not have access to one or more of the documents that
you are putting in the queue for indexing. When the search service tries to
index these documents, it will not be able to find them.

Remove those documents from the displayed list.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

You have selected to restrict your search to document groups, but the list of
document groups is empty.

Select the Defaults section of the Query notebook, and add the names of the
document groups to be searched.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

You have selected more than 50 Thesaurus terms. There are not enough Search
term fields to accommodate them all.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

You have selected to add a folder (document group) to the document queue.
However, the folder is empty or does not contain documents.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The EHSUI.INI file is missing or faulty.

Check that it is in the path pointed to by the CONFIG.SYS environment variable
EHSDATA.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

You have specified the same character for both global characters.

You must specify different characters for:

o A word or part of a word
o One character.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

More than 1000 documents have been found that match your search criteria.

When a large number of documents are found, you can have the results list
displayed to you in "batches". The smaller the batch size, the sooner the list
is displayed. You set this number in the Display first field in the Defaults
section of the Query notebook.

Select OK to display a list of the first batch of documents.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The index type has been changed; for example, you are now using a precise index
instead of a dual index. If you are at a client workstation in a client/server
system, this change was made by the system administrator.

The Query section of the Query View notebook is automatically changed to show
the new index type: Inflected forms is selected for a linguistic index, not
selected for a precise index, and can be selected for a dual index.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

You have selected to search for documents, but no documents have been indexed.
The document index is empty.

To index documents, select Add to queue from the pop-up menu of the Index
object, or drag and drop the documents you want to index onto the Index object.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

A probelm occurred when opening the communication file. The file EHSCXCOM.CFG
should be in the path pointed to by the EHSDATA environment variable in your
CONFIG.SYS file.

Check that the file is in this path. If necessary, change the EHSDATA
environment variable, and restart your system.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

An error was detected when reading from or writing to the communication file.

The file EHSCXCOM.CFG should be in the path pointed to by the EHSDATA
environment variable in your CONFIG.SYS file.

Check that the file is in this path and that you have write access to it.

If necessary, change the EHSDATA environment variable, and restart your system.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The query you are making begins with a Not operator.

You cannot have a Not operator at the beginning of a query.

For example, a query cannot begin:

NOT computer OR system

Restructure the query so that the Not operator is no longer at the beginning of
the query.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

Thesaurus files could not be found.

Check your CONFIG.SYS file to ensure that the path pointed to by the FKZTEUS
environment variable is the one containing the Thesaurus files. Try also
restarting your system.

If the problem persists, reinstall the Thesaurus.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

The client library services DLL cannot be used. Either the DLL is missing or it
does not contain the expected functions. The name of the currently used DLL is
displayed in the Properties section of the index administration notebook. Check
whether this DLL can be accessed by SearchManager. If the DLL is not the one
provided by SearchManager, check whether it contains the correct functions. See
SearchManager/2: Programming Interfaces for a description of the library
services.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

An error was detected when starting the search service.

Stop the service and start it again.

If the error persists, restart your system.


ΓòÉΓòÉΓòÉ <hidden> Help for Message ΓòÉΓòÉΓòÉ

An error was detected when starting or stopping the search service.

Stop the search service and start it again.

If the error persists, restart your system.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this window by selecting Product information from the Help menu bar.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this window by selecting General help from the Help choice or by
pressing F2 in a Help window.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this window by selecting an object and pressing mouse button 2, or
by selecting Help from the menu bar.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this window by selecting Help index from the Help choice or by
pressing F11 in a Help window.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this window by selecting Using help from the Help choice or by
pressing Shift + F10 in a Help window.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this window by selecting Keys help from the Help choice or by
pressing F9 in a Help window.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

To print the form:

 1. Select Print on the Help window to display the Print window.

 2. Select This section on the Print window.

 3. Select Print.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

To copy this form to a file, you can select any of the Copy choices, provided
by the Help window, for example:

 1. Select Copy to file from the Services pull-down to duplicate this form and
    place it in a temporary file named TEXT.TMP in the current directory of the
    current drive.

 2. Rename this file to RCF.TXT and send it to IBM.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

To specify complex structured queries, such as:

(price or charge) and (increase or raise)
do the following:

 1. Type:

        price
    in the first Search terms field.

 2. Make

        charge
    a synonym of:

        price
    by clicking on Synonyms to display the Synonyms window.

 3. Type:

        increase
    in the second Search terms field.

 4. Make:

        raise
    a synonym of:

        increase

 5. Connect the first and the second Search terms fields using an and operator.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this window in one of the following ways:

o Select the Add to queue choice in the pop-up menu of the Index object or of
  the Document objects in a result list.

o Select documents or document groups and drag and drop them onto the index
  object.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Click on the list button of the drop-down list to display the available items.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this window from the SearchManager/2 folder by selecting Defaults
from the pop-up menu.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to the Index object as follows:

 1. Open the SearchManager/2 folder.
 2. Open the Search service folder that contains the Index object you want to
    process.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to the Query objects as follows:

 1. Open the SearchManager/2 folder.
 2. Open the Search service folder that contains the Query objects you want to
    process.

Note:  You can move the Query objects to the desktop or any other folders.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Initially the default is an asterisk (*).

o Example of an asterisk at the front of a word:

    *text
  finds documents containing:

    text
    context
    hypertext
    teletext

o Example of an asterisk representing a whole word:

    annual * report
  finds documents containing:

    annual budget report
    annual sales report
    annual report

Note:  This global character must not be blank.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Initially the default is a question mark (?).

Example:

M?ll?r
finds documents containing:

Miller
Myller
Millar

Note:

o This global character cannot stand alone to represent a single-character
  word.

o This global character must not be blank.

o If you specify this global character, it must represent a character in that
  position. It cannot represent a blank.

    m?ll?
  does not find documents containing:

    mill


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this pop-up menu as follows:

o Using the mouse:

    1. Move the mouse pointer to the object.

    2. Click mouse button 2 once.

o Using the keyboard:

    1. Select the object.

    2. Use the system defined key combination for displaying pop-up menus
       (default: Shift-F10).


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to the Query section on the Query View notebook in one of the following
ways:

o Double-click on the Query object.

o Select the Query object and press Enter.

o Select Open from the pop-up menu of the Query object. Then select Query view.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to the Query View notebook in one of the following ways:

o Double-click on the Query object.

o Select Query view from the pop-up menu of the Query object.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

On the Query View notebook you can connect your search terms with one of the
following operators:

or
     Retrieves documents that contain at least one of the search terms
     specified.

     For example:

              Sugar
          or  Salt
     looks for documents that contain either Sugar or Salt, or both.

     Or is initially set in the list boxes.

and
     Retrieves only documents that contain both search terms specified.

     For example:

              Sugar
          and Salt
     looks for documents that contain both Sugar and Salt. For example, a
     document that contains only sugar is not found.

not
     Retrieves documents that contain the first search term, but not the
     second.

     For example:

              Sugar Candy
          not Salt
     looks for documents that contain Sugar Candy, but then leaves out all
     documents that in addition contain Salt.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Here is an example for a German compound word. If you enter:

Jahresbericht
the search locates documents that contain:

Bericht fБr das Jahr


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this window in one of the following ways:

o Using the Query View notebook:

   - Select the Query View notebook.

   - Select Add on the Defaults section.

o Using the Administration notebook:

   - Select the Administration notebook.

   - Select Add on the Periodic section for Indexing.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this section from the Query View notebook by selecting the Defaults
section.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this window as follows:

 1. Open the Query View notebook.

 2. Select Synonyms.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this window as follows:

 1. Open the Query View notebook.

 2. Select Thesaurus.

    Note:  The Thesaurus push button is displayed only if the IBM licensed
    program IBM Thesaurus End-User System Toolkit/2 is installed.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this window as follows:

 1. Open the Query View notebook.

 2. Select Thesaurus.

    Note:  The Thesaurus push button is displayed only if the IBM licensed
    program Thesaurus is installed.

 3. Select Show.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this window as follows:

 1. Open the Query View notebook.

 2. Select the Defaults section.

 3. Select the progress indicator.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this window as follows:

 1. Open the Browser window.

 2. Select Options on the menu bar.

 3. Select Set colors on the Options pull-down.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this window as follows:

 1. Open the Browser window.

 2. Select Locate on the menu bar.

 3. Select Find on the Locate pull-down.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this window as follows:

 1. Open the Browser window.

 2. Select Options on the menu bar.

 3. Select Set font on the Options pull-down.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this window by selecting the Browse choice from the pop-up menu of
the Document object you want to browse.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to the Document objects as follows:

 1. Open the SearchManager/2 folder.
 2. Select the search service that contains the Query object you want to
    process.
 3. Select the Results view from the pop-up menu of the Query object you want
    to process.
 4. The Document objects are displayed in the Results View.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to the Explain window as follows:

 1. Select the highlighted term, for which you need more information.
 2. Select Explain.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to this window by selecting Results view from the Open choice of the
pop-up menu of the Query object you want to process.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to the Explicit section of the Administration notebook as follows:

o Select Administration from the pop-up menu of the Index object.

o Select the Explicit tab.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to the Periodic section of the Administration notebook as follows:

o Select Administration from the pop-up menu of the Index object.

o Select the Periodic tab.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to the Status section of the Administration notebook as follows:

o Select Administration from the pop-up menu of the Index object.

o Select the Status tab.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to the Unlock window by selecting Unlock from the corresponding section
of the Administration notebook.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to the Indexing Messages window as follows:

o Select Administration from the pop-up menu of the Index object.

o Select the Status tab.

o Select Show.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to the Rules section of the Administration notebook as follows:

o Select Administration from the pop-up menu of the Index object.

o Select the Rules tab.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to the Stop words section of the Administration notebook as follows:

o Select Administration from the pop-up menu of the Index object.

o Select the Stop words tab.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to the Properties section of the Administration notebook as follows:

o Select Administration from the pop-up menu of the Index object.

o Select the Properties tab.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to the Periodic Indexing section of the Administration notebook as
follows:

o Select Administration from the pop-up menu of the Index object.

o Select the Periodic tab.

o Select the Indexing tab of the Periodic section.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to the Periodic Merge section of the Administration notebook as
follows:

o Select Administration from the pop-up menu of the Index object.

o Select the Periodic tab.

o Select the Merge tab of the Periodic section.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to the Periodic Cleanup section of the Administration notebook as
follows:

o Select Administration from the pop-up menu of the Index object.

o Select the Periodic tab.

o Select the Cleanup tab of the Periodic section.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to the Administration notebook by selecting Administration from the
pop-up menu of the Index object.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You can start a local search service or a search service on a
single-workstation system in one of the following ways:

o Select Start on the pop-up menu of the Search service object.

o Use SM2 command from the OS/2 command prompt (start EXE program).

o Use the special batch file STARTUP.CMD to start the search service
  automatically at system startup.

o The search service is automatically started by the local client, if you
  search for documents or process administration tasks that require the search
  service to be started.

Note:  Start is only available from the machine on which the search service is
installed. It is not available for a remote client.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

You get to the Definitions section of the Settings notebook for the search
service object as follows:

o Select Settings on the Open choice of the pop-up menu of the Search service
  object.

o Select the Definitions section from the Settings notebook.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of IBM Corporation


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of IBM Corporation


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of IBM Corporation


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of IBM Corporation


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of IBM Corporation


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of IBM Corporation


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of IBM Corporation


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of IBM Corporation


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of IBM Corporation


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of IBM Corporation


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of Samna Corporation


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of Intel Corporation


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of Lotus Development Corporation


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of Novell Inc.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of Novell Inc.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of Microsoft Corporation


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of WordPerfect Corporation