A Starlink HELP library giving general descriptions of all Starlink packages will be maintained in
/star/help/adam_package.shl by the Starlink Software Librarian. The top-level topic will give a list,
with a single line description, of all the standard and option packages and will be displayed if the user
The second level will be subtopics for the individual packages. Each subtopic will give a brief description of the package and describe how to start using it. Before any packages have been started up by the user, the command:
ICL> HELP package
will display the appropriate subtopic.
Environment variable ADAM_PACKAGES points to this help file.
ICL uses environment variables to identify files containing commands which it will obey automatically before taking input from any file specified as a parameter of the ICL command, or prompting for input. The environment variables, in the order they are accessed, are:
|ICL_LOGIN_SYS||Intended for ‘system’ login commands|
|ICL_LOGIN_LOCAL||Intended for local site login commands|
|ICL_LOGIN||Intended for user’s login commands|
For Starlink sites, ICL_LOGIN_SYS points to a file, controlled by the Starlink Software Librarian which contains ICL commands which:
For example, for KAPPA (a standard package), on Unix it will contain:
For CCDPACK (an option package), it contains:
Where NOTINSTALLED is a procedure which politely tells the user that the package is not available. Note that, because IF statements can only be included in ICL procedures (and not directly in command files), the command file first defines a hidden procedure containing the appropriate code for all option packages and then obeys it to define the required Package Startup Command.
This is an environment variable pointing to an ICL command file which, if it exists, will be LOADed during the ICL_LOGIN_SYS sequence. The file is intended to define both the Package Startup Command and the source of introductory help for local packages.
LADAM_PACKAGES will be controlled by the local Site Manager and may also contain any other site-specific login commands.
The following environment variables are defined in
/star/etc/login which must be ‘source’ed in
order to use any Starlink software.
|Variable name||Normal setting|
|and for standard packages|
For option packages, the existence of an appropriate file within the package is checked to determine whether or not the package is installed. If it is, package_DIR and package_HELP for the package will be defined.
Shell Package Startup Commands are defined in
/star/etc/cshrc which must be ‘source’ed in order to
use any Starlink software. For standard packages a command is defined which will ‘source’ the
Package Startup Script to start up the package for use from the shell. For option packages, the
existence of an appropriate file within the package is checked to determine whether or not the
package is installed. If it is, a Startup Command is defined as for standard packages; if
not, a command is defined which will politely tell the user that the package has not been
1As a temporary measure, this is also done for standard packages which have not yet been set up to run from ICL.