OpenVMS

We suggest that all Femsys Limited software be placed in one ``master'' directory with separate subdirectories for the various programs. In this document we will refer to this master directory as FEMSYS

If you are installing FEMGV for several users you will probably wish to create FEMSYS as a top-level directory on an applications disc. A procedure for achieving this is given below.

Any text which appears in italics is site dependent and you may replace it with names of your own choosing.

1.

Check that you have sufficient free disc space and that the operating system software requirements have been met.

2.

If you do not already have a master directory create one now:

$ CREATE/DIRECTORY sys$sysdevice:[FEMSYS]
$ SET PROTECTION=(WORLD:RE) sys$sysdevice:[000000]FEMSYS.DIR

3.

Create a subdirectory within the master directory. This subdirectory will receive the contents of the distribution tape, and you should choose a name which reflects the FEMGV software release name; FGV5101, for example.

$ SET DEFAULT [FEMSYS]
$ CREATE/DIRECTORY [.femgv-release-name]

4.

Set your current working directory to be this newly created subdirectory.

$ SET DEFAULT [.femgv-release-name]

5.

If your distribution tape is in BACKUP format, read the contents into the master directory as follows:

Load the tape but do not MOUNT it.
$ BACKUP/REWIND dev:FGVnnn/SAVE [...]*.*

where dev is the name of the magnetic tape drive, and FGVnnn is the name of the Backup saveset, as detailed on the physical label which is attached to the tape.

6.

If your distribution tape is in VAX COPY format then read it as follows:

(a)

Mount the tape or cartridge
MOUNT dev label TAPE
where dev is the name of the tape drive and label is the magnetic tape label as detailed on the physical label which is attached to the tape.

(b)

Copy the contents of the media to the current working directory.
COPY TAPE:*.* *.*

(c)

Dismount the tape or cartridge.
DISMOUNT TAPE

7.

Demonstration Files

You will normally want to create a subdirectory which will hold all of the demonstration files supplied on the distribution tape. If your distribution was supplied in VAX BACKUP format this will normally have been performed for you, but if you do not have a subdirectory [.DEMO] you should create one, as follows:

(a)

Go to the ``master'' directory
SET DEFAULT [FEMSYS]

(b)

Create a subdirectory to hold the demonstration files
CREATE/DIRECTORY [.DEMO]

(c)

Move the demonstration files into the subdirectory.
RENAME *.BAT [.DEMO]*.*
RENAME *.FVI [.DEMO]*.*
RENAME *.FGI [.DEMO]*.*
RENAME *.DAT [.DEMO]*.*
RENAME *.UTI [.DEMO]*.*
RENAME *.ME [.DEMO]*.*

8.

Establish your security keyfile.

Each FEMGV installation will be issued with a program security file known as a keyfile. In general, a keyfile consists of ten lines with each line containing 11 characters.

The installation kit includes a demonstration keyfile and your customised keyfile will be provided as part of the covering documentation. If it is supplied in printed form only you will need to create the keyfile using your favourite text editor. The keyfile should be named FGVKEY.K60 and stored in the same directory as your FEMGV executables, [FEMSYS.FGV6101], for example. Note that if you are upgrading to FEMGV from FEMGV 4 you can simply copy your existing FGVKEY.K50 into FGVKEY.K60

Whenever FEMGV is executed the security file FGVKEY.K60 is examined. The pathname of the security file is obtained from an environment variable FGVKEY. If this variable does not exist then an attempt is made to open the file FGVKEY.K60 in the current directory.

The logical assignment can be made using the ASSIGN command, for example:

   $ ASSIGN  DBA0:[FEMSYS.FGV6101]  FGVKEY

This declaration could be placed in each user's login command procedure, or it may be added to the system wide command procedure, typically SYS$MANAGER:SYSLOGIN.COM

9.

Define a command which will allow users to run FEMGV

The mechanism by which users access the FEMGV executable is dependent upon your local customs. One possibility is to define a logical variable in the system startup command file. For example:

   FEMGV:==$DISK1:[FEMSYS.FGV6101]FEMGV.EXE

Users may then simply issue the command FEMGV in order to invoke the program.