Next: , Previous: Data Structures, Up: Usage


2.6 Directory Names

In order to simplify the use of CONGEN, all the directories used for storing CONGEN executables, sources, parameter sets, test inputs, etc., are defined with either environment variables (on UNIX) or logical names (on VAX/VMS).

On Unix machines, the CONGEN directories have separate trees for each machine on which CONGEN can be run. These trees begin under the root CONGEN directory. This structure allows one directory tree to be shared using the Network File System (NFS) by multiple hardware architectures. The program, $CGROOT/update_tree, is used to update different machine trees from the master copy. See UNIX Installation, for more information about the machine designations.

The OPEN command, see Open Command, is designed to allow the usage of identical syntax on either VMS or UNIX for using these directory names. The directory is placed before the file name with a colon, :, separating the two. E.g. CGDATA:RTOPH8.MOD. Also, all file names are converted to lower case.

When referring to the directory names in operating system commands, it is necessary to keep the operating system in mind. On VMS, one uses a colon to separate the two as above. On UNIX running the C-shell, one uses a dollar sign prefix and a slash. For example, $CGDATA/rtoph8.mod.

The directory names are given below. Unix syntax is used for the directory names, but a similar structure is also used under VMS.

MM
Specifies the disk where CONGEN is kept. This is used only on VMS.
CGROOT
Specifies the root directory for CONGEN. This is used only on Unix.
CG
$CGROOT/<machine>/v<version-number>/
Top level for a particular implementation of CONGEN.
CGBIN
$CG/bin/
Location of executables. This directory will be put into your path by initialization file such as cgdefs, see UNIX Installation.
CGD
$CGROOT/doc/
Documentation and INFO.
CGDATA
$CGROOT/data/
Data files for normal execution.
CGLIB
$CG/lib/
Object libraries and files for building user versions of CONGEN and for the support programs.
CGP
$CG/support/
Support programs for use with CONGEN. See Support, for details.
CGPS
$CG/support/src/
Source code for support programs for use with CONGEN. There are several subdirectories under this one which contain larger support programs, too bulky to keep in this directory.
CGS
$CG/source/
Source code for CONGEN.
CGT
$CG/test/
Test cases.
CGTD
$CG/testdat/
Data files for testing the recent production version.