# @(#)LIMS	2.1 10/7/93
#
# Copyright (c) 1993 Alias Research Inc. All rights reserved.
# This is unpublished proprietary source code of Alias Research Inc.
# The copyright notice does not evidence any actual or intended
# publication of such source code.  Alias Research Inc. cannot  be
# held responsible for any inaccuracies contained herein.
#

.H Alias LIMS 


.H Introduction
.fi
This document accompanies a upgrade version of 
"LIMS".  We are providing this upgrade
in order to provide better transition support for our
customers currently using LIMS for Scantronix and MegaShuttle.
.nf


.H Hardware Installation
.fi
Choose a SCSI address that is unused in your system. To see the
addresses that are used, open a shell and type hinv. The system
will display a list of its hardware inventory. Look for lines
like:


Tape (or Disk) drive: Unit N on SCSI controller 0


The N is the addresss of the particular device. Make a list
of all those in use on the SCSI controller. Add 0 (the controller's
address) and 1 (the system disk) to the list since they are in
use. You can use any unused address up to 7.


Connect the remote drive while the SGI computer and all peripherals
are powered off. Then power up all the peripherals and the computer.
.nf


.H System
.fi
Login as root. Cd to /dev/scsi. Type ls -al. You should see a
listing of the generic SCSI devices. Change the permission of the
one corresponding to the address you have chosen above. Make the
permissions RW for everbody. Type:


    chmod 666 sc0dNl0         (where the N is the N from above)
.nf


.H Software Installation
.fi
Although Alias Eclipse is not included with this special version of
LIMS, load the product tape by following the directions for loading
Alias Eclipse Beta. After loading, follow the instructions for obtaining
your encryption.
.nf


.H Operation


.H The Menu Bar
.fi
Use Open under the File menu to Open the disk with the SCSI
id currently set. (See SCSI address below)  By default, LIMS
will open the disk automatically if it can. If LIMS encounters
difficulty opening the disk, it will display a message and wait
for you to respond with either OKAY or CANCEL. OKAY will cause
LIMS to try again, CANCEL will cause LIMS to either wait for 
a new SCSI address or exit depending on the nature of the problem.


If you need to change the SCSI address LIMS is using, select 
CANCEL and change the SCSI address and then Open again.


Use Close to close the disk before removing it and inserting
another, or to change SCSI addresses.


Use Quit under the File menu to exit LIMS. You may also exit
by double clicking on the window close bar.


Set the SCSI Address of the remote disk you are connecting to 
in the SCSI Address entry box. You may only change SCSI Address
after Closing the disk, if it is open.
.nf


.H Unix Side
.fi
The left side of the LIMS dialog box represents the Unix
file system. The currently active IMAGE PATH is displayed and its
contents are listed beneath it in the PATH LIST. Items in the
list are displayed according to the following convention:
.nf


TYPE            END CHARACTER
-----           -----------------
Data File       none
Directory       /
Executable program  *
Symbolic Link       @


.fi
If LIMS can find an image path set by Alias Eclipse, then it will
use that path for the IMAGE PATH and will operate in Alias Eclipse
compatible mode. If there was no path set by Alias Eclipse, it will
start with the last path used in Alias Retouch and operate in Alias Retouch
compatible mode. If there was no path set by Alias Retouch, it will
default to /usr and operate in Alias Eclipse compatible mode.
.nf


.fi
Clicking on a directory will select it. Its name will be appended
to the current image path and then its contents will be
displayed. This is the same as issuing the "cd" command in a
shell.  Clicking the "GO UP" button brings you one level up in
the directory stucture.
.nf


.fi
Clicking on a tile image file, will result in it being selected
as the current image. Its parameters will be displayed in the
Parmater display below. Clicking on any other type of file will
result in an error and no action will occur.
.nf


.fi
Double clicking (clicking twice rapidly) will open a small window
and display the image. Double click on the upper left corner of the
display window to close it.
.nf


.fi
The DELETE button will delete the current file from the disk!. It
will ask for confirmation first.
.nf


.fi
Beneath the Unix PATH LIST, it the Unix FILE NAME. This is the
name of the current unix file.
.nf


.H Remote Side
.fi
The Right side represents the Remote Disk. At the top is the
SCSI ID (or address) to be used. Below that are two fields that
display the identified format and volume name (if any) found on
the disk.
.nf


.fi
Next, similar to the Unix side, are the PATH, PATH LIST, and
FILE NAME displays. If the Remote disk does not contain a
directory structure and all the files are in the "root"
directory, then the path widgets on the Remote side will not be
active.
.nf


.fi
Like the Unix side, you may click on a directory or file to select
it. Double clicking on a file will display it, assuming it is a
valid image file.
.nf


.H Starting a single file transfer
.fi
In the center, between the Unix directory list on the left and
the Remote directory list on the right, are the two TRANSFER
BUTTONS, one pointing left, indicating a transfer from the
Remote to Unix, and the other pointing right, indicating a
transfer from Unix to Remote. Only one of these will be active
at any one time. If you last selected an image from the Remote
disk, then the transfer from Remote to Unix will be active and
highlighted. If you last selected an image from the Unix side,
the the transfer from Unix to Remote will be active and
highlighted.
.nf


.fi
Click on the highlighted TRANSFER button to initiate the transfer
of the selected image. The file names have been filled in with
for you: the name on the source side is copied from the list
above as you selected the image. The destination side
is filled in with the same name by default, but you may change
it before initiating the transfer. If LIMS is in Alias Eclipse
compatible mode filenames will not
have a .tile appended to them on the Unix side. If it is in
Alias Retouch compatible mode, then filenames on the Unix side will
have .tile appended to them. Filenames going to the Remote side
will have paths and extensions stripped off.
.nf


.H Image Parameters
.fi
Below the file name widgets, is a display of the current IMAGE
PARAMETERS. Image dimensions in millimeters, resolution in
pixels/mm, pixels, number of colors, and size in KB (kilobytes)
are displayed. This display will reflect the currently selected
image, either from the Unix side or the Remote side, whichever
was last selected.
.nf


.H Status
.fi
At the bottom is a STATUS DISPLAY used to indicate, for
example, transfers in progress or the recent completion of a
transfer.
.nf


.H Batch Transfers
.fi
To the right of the image parameter display is the BATCH mode
selector. Batch mode is for transferring multiple files
unattended. Enabling batch mode brings up the BATCH LIST dialog
box and reveals the batch EXECUTE button. Selecting files from
the currently active side, either Unix or Remote, will build a
list in the BATCH LIST dialog. After you have added the files you
want to transfer to the list, clicking the EXECUTE button will
begin the batch transfer.
.nf


.H Editing the BATCH LIST:
.fi
The Batch list dialog box has several buttons:
.nf


.fi
DELETE - for deleting one item from the list (it doesn't delete
the file from the disk, just from the batch list).
.nf


.fi
UP - to move the highlighted file higher in the list.
.nf


.fi
DN - to move the highlighted file lower in the list.
.nf


.fi
When you are finished with batch mode, Deselect BATCH in the main
LIMS dialog box to close the BATCH LIST dialog.
.nf
