                   OPL Database server installation
                   ================================


The .ZIP file contains 5 database server files which need to be
copied onto the Psion machine.  The files are:

        SYS$DATA.IMG
        SYS$DATA.CFG
        DBSDRVR.LDD
        ISAM3.DYL
        DBASE.ISM

These should all be placed in a \DBS\ directory on any drive.

The .ZIP file also contains the following files:

        README.TXT      - This file
        SERVER.TXT      - A reference guide for the database server
                          functions
        DATABASE.OPO    - The OPL API code for the Series 3a
        DB.OPA          - A sample OPL database application
        DATAS3.OPO      - OPL API for the Series 3
        DATAHC.OPO      - OPL API for the HC
        DATAWA.OPO      - OPL API for the Workabout
        DATABASE.LEX    - The language extension file for the OPL API
        DBS.OPH         - The OPL API header file
        DB.OPL          - The source for the sample application
        DB.MAK          - An ODE .MAK project for the sample application
        DB.PIC          - The sample application icon

The API code module, DATABASE.OPO, also needs to be copied onto the Psion
machine, into the \OPO\ directory. If you are using ODE, then it can be
simply added to the project file and will be automatically copied across.

If you wish to run the server on a Series 3, HC or Workabout rather
than a Series 3a machine, then use the appropriate .OPO instead of
the DATABASE.OPO module.

If you are installing a newer version of DBS over an old existing
version, it is important to make sure that the old device driver has
been removed from memory before running the new version.  The
simplest way of doing this is to ensure that you are not running any
applications that uses the server, then write a simple OPL program which
just connects to the server, then immediately disconnects.
e.g.
        #include "dbs.oph"

        PROC main:
          LOADM "\opo\database.opo"
          DbsConnect(0)
          DbsDisconnect()
          UNLOADM "\opo\database.opo"
        ENDP

Versions of the database server from 0.03 onwards use a slightly
modified version of the device driver to support the OPL APIs DbsGetError
function.  Previous versions of the device driver do not support this
and attempting to use them can have very unpredicatable results. 
