|
Host/API | HOST |
HOST
is a set of FORTRAN
routines that enable the
SIR/DBMS
user to interface directly with a database. These routines provide
all the capabilities of a DBMS RETRIEVAL
or RETRIEVAL UPDATE
.
However, schema definition, schema modification, batch data input, retrieval procedures
(such as SPSS SAVE FILE
or CONDESCRIPTIVE
), utility routines and
the graphical user interface are not available via HOST
. These operations
must be performed with DBMS
.
HOST
is designed for use in those situations in which features are required
that are not available in DBMS. It provides a direct interface between a database and a
user-written program. For this reason, HOST
is particularly appropriate when
the user has an existing application package that requires the inclusion of facilities for
retrieval of information from a database. HOST
also provides facilities that
give the SIR/DBMS user the capability to write a program that can process input from many
terminals. The user's program controls the operation of the terminals and uses
HOST
to process one or more databases simultaneously, a feature not available
in DBMS.
The HOST
package (like any subroutine package) must be used correctly and
carefully to avoid damage to the database. Unlike DBMS, the HOST
routines
cannot protect the database from programmer error, accidental or deliberate. For example,
if a HOST
memory resident table is modified in any way by the user-written
routines during a run, then invalid data, pointers, counts, and other erroneous
information may be written to the database. This invalid information may not be detected
by either HOST
or DBMS
until later.
We recommend that applications using HOST
be tested thoroughly with a
duplicate of the database before the programs are put into production.