@device(imprint10)
@style(spacing 1, topmargin .75 inch, bottommargin .5 inch)
@pageheading(left="", center="", right="", immediate)
@pagefooting(left="Revision B, December 1985", center="", right"L. B. Merims",
immediate)

@majorheading(Project Athena Notes on
Using Ingres Version 3.0)

@begin(heading,flushleft)
Administration
@end(heading)
Before you can use Ingres on Project Athena, you must:

@begin(itemize)
@b(Have an Athena Account.)  See the free Athena document @i(Essential Athena)
available in all clusters, or call the Athena Account Administrator
at (25)3-1325 for information on who can get an Athena acount, and
how to go about it.

@begin(multiple)
@b(Be validated as an Ingres user.)  This is a @i(separate, additional)
step.  To use Ingres in any capacity, you must first call the
Ingres Administrator at (25)3-1325 and get him/her to add you to
the database of people that Ingres permits to use itself.  The Administrator
must also know which machine you need to use Ingres on.

@blankspace(1 line)
@begin(text, leftmargin +5, rightmargin +5, spacing 1)
Note:  Until the technical barriers that prevent wider use are resolved,
Athena may limit Ingres
use to curriculum development projects and those demonstrating a strong
need.
@end(text)
@blankspace(1 line)

Once you become a validated Ingres user, you can create and use @i(your own)
databases.
@end(multiple)

@begin(multiple)
@b(Add the @p(~rtingres/bin) directory to your search path.)  All Ingres
commands are stored in the @i(~rtingres/bin) directory.  (Note, only
one "i".)  Unix will not normally find the Ingres commands.
Instead, you will
get "Command not found" error messages.  To make Ingres commands
work, edit your @i(.login) file.
Find the line that starts "setenv PATH".  At the end of this single
long line, add @b(:~rtingres/bin) (Do put in the @b[:] separator.)

Exit the editor.  Then type:  @b(source .login)  This will make the
new PATH active immediately.
@end(multiple)
@end(Itemize)

To use somebody else's Ingres database, you must a) have an Athena
account on the machine where the database is, b)
be
a validated Ingres user, and c) the person who owns the
database must give you permission to read and/or write their
database with the Ingres @i(permit)
command.  The Athena Ingres Administrator is not involved in
giving this last kind of permission.



@begin(heading, flushleft)
Documentation
@end(heading)
Copies of the Ingres documentation are
available for reference in each Athena Unix cluster's manual racks.  You
can  also buy this Ingres documentation at the Information Services
Publications Office in 11-209.  

This manual is for Version 3.0 of Relational Technology's
Ingres database system.  This is the version running on Athena Unix
systems as of January 14, 1986.


This @i(Ingres Manual) is a large volume containing all the major individual
Ingres manuals in one package.  It contains:
@begin(description)
@b(Ingres/MENU Users Guide)@\The interactive front-end menu interface
to the Ingres
system.  New with Ingres Version 3.0.

@b(Ingres Application Notes)@\Sample applications from Ingres users.  Written
before Version 3.0 of the system.

@b(Ingres Reference Manual)@\The main Ingres reference manual, organizing
commands in alphabetical order.

@b(Ingres/FORMS: Visual-Forms-Editor Users Guide)@\Designing the screen
forms that define and display an Ingres database.

@b(Ingres/QUERY: Query-by-Forms Users Guide)@\Adding, deleting, replacing,
or retrieving data from an Ingres database in a screen fashion without
having to know the Quel language.

@b(Ingres/REPORTS: Report-by-Forms Users Guide)@\How to generate formatted
reports of database data by designing a screen.

@B(Ingres/REPORTS: Report Writer Reference Manual)@\How to generate formatted
reports of database data by issuing commands.

@B(Ingres QUEL Self-Instruction Guide)@\A step-by-step tutorial to the
Ingres query language, Quel.

@B(Ingres/APPLICATIONS:  Applications by Forms Users Guide)@\Designing
full database applications, such as "check in a new book," for use
by non-database specialist users.
@end(description)


Other Ingres documentation available includes:
@begin(description)
@b(Introduction to Ingres)@\A survey of all the pieces that make up Ingres,
what each is good for, and briefly how to use them.  We recommend you
start here if you are new to Ingres and databases.

@b(Ingres EQUEL/C Users Guide)@\How to access an Ingres
database from a C program.

@b(Ingres EQUEL/Fortran Users Guide)@\How to access an Ingres database
from a Fortran program.

@b(Ingres Video Tapes)@\For those who prefer this form, you can learn
about Ingres from a comprehensive set of video tapes. 
Ask a consultant how to gain access
to the video tapes.  If the consultant doesn't know (arrangements
are still being worked out as this goes to press), they can refer the question
to someone who does.
@end(description)