DOS ALSYS Installation Instructions

This version of Sage-ST ^TM requires the DOS Alsys FirstAda 4.4.1 or newer compiler. Please note that any earlier versions of Alsys are incompatible with Sage-ST ^TM 4.1. Before running the Sage-ST ^TM installation process, run ADASTART.BAT to ensure that the Ada compiler is installed and operational. The Sage-ST ^TM installation will fail if the compiler has not been loaded. If the Sage-ST ^TM installation fails, a file called FAMBUILD.BAT can be found in the root directory that lists the commands that must be executed in order for the libraries to be properly installed.

Insert the first diskette into your floppy drive and type

X:INSTALL Y:

where X is the floppy drive and Y is the drive onto which the system is to be installed.

Several forms requiring various responses will be displayed until you finally come to Figure XXX. Use <F2> to unmark the tools you do not wish to install. Following is a list of where each tool will be placed. If you wish, you may change these directories.

\ADA\APPDS - This directory is created by the family manager and contains the Ada family information for theSage-ST ^TM system.

\ADA\SAGELIB - This directory contains the Sage-ST ^TM libraries that are linked with the user application during the bind process.

\ADA\TEST - This directory contains a test program and library to determine if Sage-ST ^TM was properly installed.

C:\ADA\GRAPHICS - This directory contains the Sage-ST ^TM Graphics libraries.

C:\ADA\GRAPH - This directory contains the graphics fonts (FNT files) and the graphics tools, SAGERC.EXE and SAGERDIR.EXE, as well as the skeleton body of SGKDRIVE.ADB. SGDemo.EXE is also included for demonstration. A library (C:\ADA\GRAPH\ADA.LIB) is also linked to both \ADA\SAGELIB\ADA.LIB and \ADA\GRAPHICS\ADA.LIB for use as a development directory. Common Directories

\ADA\THOR - This directory contains the THOR and REBUILD utilities.

\ADA\PROGRAM - This directory contains the CONFIGUR, MONITOR, and LOG utilities.

\ADA\GRAPL - This directory contains the GRAPL utility.

\ADA\SDI - This directory contains the SDI utility.

\ADA\SQL - This directory contains the SQL utility.

\ADA\TOOLS - This directory contains a group of tools that are largely used in-house, but which others have occasionally found useful. These include:

BREAKUP - Breakup very large files into ones that will fit in available disk space.

ADDFILE - Recreate a file that was subdivided using BREAKUP.

COLOR - Changes the color of the monitor. Syntax is "COLOR xx" where xx is some number greater than or equal to zero.

SAGESTAT - Produces various metrics on Sage-ST ^TM code. Uses the TOKEN.LST file.

LOCATE - Locates all occurrences of a string in a file.

DOCUPROC - Generates a source code listing with table of contents and index. DOCUPROC uses the DP.DFL.

\ADA\DOC - This directory contains the ADS documentation and reference manuals in ASCII format. The complete documentation in hypertext format is provided on a separate disk. Batch files (*.BAT) for most of these utilities can be found in your root directory after installation has been completed. These may be moved to a \BATCH or \UTILITY directory if desired.

When binding, you must provide Alsys with binder defaults (refer to the Alsys documentation for setting binder defaults). During the Sage-ST ^TM installation, the following files will be placed in the C:\ADA directory:

ASMLIB.LIB - contains the assembler code for SAGE

GRASMLIB.LIB - contains the assembler code for SAGE Graphics

VMDOSI.OBJ - contains the code for the 286 extended mode

Depending on what you are using, you must bind these libraries into your application. These bind options can be passed in on the bind command line or in a batch file or set in the defaults file. If you are using Sage and SAGE Graphics, you must provide the following command when binding:

for the INTERFACE SEARCH parameter, type "C:\ADA\ASMLIB + C:\ADA\GRASMLIB".

If you are operating in a 286 extended mode, supply the following:

for the INTERFACE MODULE parameter, type "C:\ADA\VMDOSI.OBJ".

If you do not supply these parameters, your bind will not be successful. Go Back To Sage-ST TABLE OF CONTENTS