Quick Reference

Searching for an Entry

1. Click on the icon, or select Search from the Entry menu.
   The Search window is displayed.

2. Select the type of entry you want to search for using the Person option button.
   The options in the Person option button are defined in the Deja.properties file on the directory server. See the Sun Directory Services User's Guide for information on defining standard searches.

   Default options are:

   • Person
   • Locality
   • Organization
   • Specify Filter - This is a way of specifying a set of entries, based on the presence of a particular attribute or attribute value. You can specify complex filters using the or or and logical operators. Use | for or and & for and. The filter can include the standard wildcard character *. Some filter examples are listed below:

     Filter	Definition
     l=London	locality is "London"
     cn=*Rob*	common name contains "Rob"
     (&(cn=Ch*)(cn=*Thomas*))	common name starts with "Ch" and contains "Thomas"
     (|(sn=*bert*)(sn=*bort*))	short name contains "bert" or "bort"
     (&(cn=Rob*)(|(cn=*Green*)(cn=*Jones*)))	common name starts with "Rob" and contains "Green" or "Jones"

3. Type the text string or filter you want to search for in the search text field.
   The search can include the standard wildcard character *.

4. Click Search to start the search.
   The search results are displayed in the search results list and the number of entries found is displayed in the status bar. If there are no matches, the search results list is empty and the status bar indicates that no entries were found.

   You can refine your search in two ways:

   • Combine two or more searches.
     
   • Constrain the search.

5. Click the Clear button to clear the search text field.

Combining Searches

You can combine your first search string with up to two other text strings using and or or logical operators. You cannot combine both operators in the same search. For example. you can search for x and y and z, or you can search for x or y or z.
1. Select the type of entry you want to search for using the Person option button.

2. Type the text string you want to search for in the search text field.

3. Click on the AND or OR button to select the logical operator.

4. Select the entry type for the second text string using the Person option button.

5. Type the second text string in the search text field.

6. If you want to add a third search criterion, click the AND or OR button and repeat steps 4 and 5.

• To remove a search criterion, click the Back button.

• To clear all the search text fields, click the Clear button.

Using Search Constraints

1. Type the Distinguished Name (DN) of the root of the subtree you want to search.
   Or, select the root of the subtree you want to search in the browser window and click Get from Browser.

2. Select the search time limit (in milliseconds) from the Time Limit option button.
   By default, there is no time limit.

3. Select the maximum number of search results from the Max. Matches option button.
   The default maximum number of search matches is 100.

4. Select the scope of the search from the Search Scope option button.
   The default search scope is subtree.
   • One Level searches the entries on the level immediately below the search root.

   • Subtree searches all entries below the search root.

5. If you want to dereference aliases as you search, check the Dereference Aliases check box.
   If you choose to dereference aliases as you search, the distinguished name (DN) of an alias entry is translated to the DN of the actual entry. With the dereferencing flag checked, the object referred to by the alias is returned by a search. With the dereferencing flag unchecked, the alias entry is returned by a search.

Search Results List

• Search results are displayed in a list below the search criteria.
  The headings of the search results table are defined in the Deja.properties file on the directory server. By default, each entry's naming attribute, common name, telephone number and email address is displayed. See the Sun Directory Services User's Guide for information.

• To view an entry from the search results list, double-click on the entry's name.
  The View window is displayed, and the entry is highlighted in the browser window.