OSM Composer Installation Guide

Getting the Installation Set

OSM Composer and other OSM tools are research-oriented projects developed at Brigham Young University. These tools come "as is." They are packaged together and are currently compiled and available for the following platforms:

HP 9000/700 HP-UX 10.X ( composer-hp-700.hpux10.tar.gz, 1.5MB) (Composer only)

HP 9000/700 HP-UX 9.X ( composer-hp-700.tar.gz, 3.6MB)

DEC Alpha OSF1 3.2 ( composer-dec-alpha-osf-3.2.tar.gz, 1.4MB) (Composer and OSM-QL only)

These installation file sets are also available through anonymous ftp to osm7.cs.byu.edu in the osm subdirectory.

Installing

The installation file set contains the following files:

    COPYRIGHT
    bin/compose
    bin/Ipost
    bin/Normalize
    osm/{a whole lot of files}

You must read the license agreement before downloading OSM Composer.

After reading the license agreement and downloading the installation file set, uncompress the file set and extract the contents of the tar file into a directory you have chosen for installation. We recommend /usr/local as the installation location. For example:

    cd /usr/local
    -- use anonymous ftp to download the installation file set
    gunzip composer-hp-700.tar.gz
    tar xvf composer-hp-700.tar

Make sure the bin directory is in your path, and type compose to start the OSM Composer. The Composer window should appear on your screen.

Setting Up Environment Variables

There are a number of environment variables you can use to customize OSM Composer's operation:

OSMFILES -- the full path of the configuration-file directory. The default value is /usr/local/osm. If you install OSM Composer is some location other than /usr/local, you must set this variable accordingly.

OSMPATH -- the full path of the directory where your diagram files are stored. The default value is the current working directory.

OSMPRT -- the command used to print PostScript files on your system. For HP systems, the default value is "lp %s", and for SPARC systems it is "lpr -h %s". Your command must contain a single "%s". The "%s" is replaced at run time by the name of the file to print.

OSMTMP -- the full path of the directory OSM Composer will use for temporary working space (e.g., for temporary print files, etc.).

OSMQL_COMPILE -- the command used to compile an OSM-QL query program. The default value is "gcc %s/queryCode%d.C -L%s -L/usr/local/lib -lsf -lg++ -I%s -I. -o %s/queryCode%d". We have tested OSM-QL with the Gnu gcc compiler, version 2.6.3.

OSMHELP -- the command used to view the OSM Composer help that is accessible through the World-Wide Web at URL http://osm7.cs.byu.edu/composer/home.html. This command needs to contain a single "%s". The "%s" is replaced at run time by the URL of the help document. If you do not specify OSMHELP, the default help command is "netscape %s &".

OSM_RESIZE_ENABLE -- this variable is only effective for HP systems. It places Motif resize decorations on OSM Composer's dialog boxes. The default is for resize decorations to be absent for HP systems.

Note for Non-Motif Users

We have experienced difficulty using the Art user-interface mechanism on non-Motif X-Window systems. If you have difficulty getting the keyboard focus in text type-in boxes, try changing your X-Window focus policy from click focus to mouse focus. (That is, have the focus follow the mouse cursor, rather than change when you click the mouse in a window.)

Bug Reports

There are bugs in OSM Composer. This is a research project, and you will find bugs and/or quirks as you use this software. You may send bug reports and other suggestions to osm@osm7.cs.byu.edu.