 1.3 OS/2 Installation

This section describes how to install MIT Scheme on a machine running OS/2 2.1 or later. This release of MIT Scheme has been tested only on OS/2 Warp 4.0. It was compiled using IBM Visual Age C++ version 3.0 and the OS/2 Toolkit version 4.0.

1.3.1 OS/2 Installation Procedure   
1.3.2 Environment Variables   

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]
1.3.1 OS/2 Installation Procedure

After unpacking the ZIP file, `os2.zip', you will have these directories containing the following files:

`exe'
    The executable programs `scheme.exe' and `bchschem.exe'.

`dll'
    The dynamic link libraries `blowfish.dll', `gdbm.dll', and `md5.dll'.

`doc'
    Documentation files in HTML.

`lib'
A directory containing the data files needed by Scheme when it is running.

Perform the following steps to install Scheme:

   1. Move the executable files `scheme.exe' and `bchschem.exe' from `exe' to any directory that appears in your PATH environment variable. You may either add the `exe' directory to your path by editing `config.sys' and rebooting, or you may move the files in `exe' to an existing directory that is already on your PATH.

      Depending on your needs, you may want to keep only one of these files; chances are you'll only be using one of them. Of course, you may also keep both programs around if you think you might use them both. See section 2.3 Memory Usage, for more information about the tradeoffs between these two programs.

   2. Move the dynamic link libraries from `dll' to any directory that appears in your LIBPATH environment variable. As above, you may either add `dll' to your LIBPATH, or move the files in `dll' to a directory that is already on your LIBPATH.

   3. You may move the `lib' directory anywhere you like. You may rename it to anything you like. (Here at MIT, we use `c:\scheme\lib'.) After you have chosen where it will be located, set the MITSCHEME_LIBRARY_PATH environment variable in `config.sys' to be that location.

      For example, if you decide to store the directory as `c:\schdata', you would add the following to `config.sys':

       

SET MITSCHEME_LIBRARY_PATH=C:\SCHDATA

      (Remember that you must reboot OS/2 after editing `config.sys' in order for the changes to take effect.)

      You can override the setting of this environment variable with the -library command-line option to Scheme, for example:

       

scheme -library d:\myscm\mylib

      If you supply a -library option, it is not necessary to have the environment variable defined. For example, instead of editing `config.sys', you might create a `.cmd' file to invoke Scheme and pass it the -library option automatically.

   4. Optional: Move the `doc' directory anywhere you like, or delete it if you do not want to keep the documentation.

   5. Optional: Consider setting some of the environment variables described below. 

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]
1.3.2 Environment Variables

This section documents several of the environment variables that Scheme uses, and gives an example for each one. These are the environment variables that must usually be defined when installing Scheme under OS/2. For complete documentation of all of the environment variables used by Scheme, see 2.6 Environment Variables.

Note that environment variables are usually defined in the OS/2 `config.sys' file. After editing the `config.sys' file, it is necessary to reboot OS/2 before the changes will take effect.

MITSCHEME_LIBRARY_PATH
    says where to find Scheme's data files. This is the only required environment variable (but is not required when Scheme is invoked with the -library command-line option).

     

SET MITSCHEME_LIBRARY_PATH=C:\SCHEME\LIB

MITSCHEME_INF_DIRECTORY
    tells Scheme where to find debugging information for the runtime system. The default value for this environment variable is a subdirectory `src' located in the directory specified by MITSCHEME_LIBRARY_PATH.

     

SET MITSCHEME_INF_DIRECTORY=C:\SCHEME\LIB\SRC

TMPDIR
    tells Scheme the name of a directory where it can store temporary files.

     

SET TMPDIR=C:\TMP

HOME
    tells Scheme where your "home" directory is located. This is where Scheme looks for init files, and it is also what the `~/' (or `~\\') filename prefix expands to. If not specified, Scheme uses the root directory of the current drive.

     

SET HOME=C:\CPH

USER
    tells Scheme your user name. This is used for several purposes, including the name that will be used as your email address.

     

SET USER=cph

SHELL
    tells Edwin what shell program to use in shell buffers and for running shell commands. If not specified, this defaults to the standard OS/2 shell, `cmd.exe'.

     

SET SHELL=C:\4OS2251\4OS2.EXE

