% run this through LaTeX with the appropriate wrapper

\chapter {SUNINT}

\pgm{sunint} is a window interface developed at UCL.
It uses the feature of the SUNVIEW environment to give the user a set
of windows and menus with which they can query the directory.
As with WIDGET it is included only as an example of an X.500 interface, and how to
use the procedural interface, it has not been fully developed.

Like \verb"widget", \verb"sunint" only gives the users access to a subset of the X.500 protocol,
and as such is a read only interface.

\section {Using SUNINT}
The \verb"sunint" interface is invoked with the command \pgm{sunint}

The program automatically binds you to the local directory, unless a \tt -c\rm\ flag is given,
when the following argument is taken to be the address of the DSA 
to connect to.

Once started the user is given a window with two panels.
The upper panel displays the current position in the DIT, the lower 
displays the children.

\subsection {Menus}
Each item in the window has a menu associated with it.  By pressing the
{\em right} mouse button a menu of available options will be displayed.
If an option is `{\sl dimmed}' it means that that particular option is
unavailable.

When a menu item is selected (by moving the mouse over the menu item, and releasing
the mouse button) the appropriate action is taken.

\subsection {Moving around the DIT}
When you enter the program, you are automatically placed at the ROOT of the
DIT.
To move around the DIT, select the `{\em show children}' menu item for the 
ROOT entry.  This will display the Distinguished name and objectclass of 
all the children below the root in the lower panel.
If you now select the `{\em move to here}' menu item from one of the children,
The entry will be redisplayed in the top panel, from where it children can
be displayed.

\subsection {Reading the Attributes}
The menu item `{\em Show details}' will make the attribute of the entry
appear in a separate `pop-up' window.

This window can be removed by selection the {\em hide} option from the menu 
found by pressing the {\em right} button on one of the sides of the window.

\subsection {Searching}
Searching is selected by pressing the button labeled {\em search}, and
selecting the type of search required.

Selecting {\em general search} will display a window with room for text input
of a search filter.
The filter is specified in the same format as for DISH searches described in
section \ref{search}.

The other options are used to make simple searches.
A window is displayed with the attribute types you may want to search on
displayed.
For each type, you can enter the value want to search for, and select the
type of match required.

The result of the search will be displayed in a separate window.

\subsection{Quitting}
To quit, press the {\em quit} button with the {\em left} mouse button.
An automatic unbind will take place.


