INCLUDE files

The programming interface to the CAT library includes two INCLUDE files: CAT_PAR and CAT_ERR. These INCLUDE files define symbolic constants which your application programs may use:

CAT_PAR

contains general constants pertaining to the CAT library,

CAT_ERR

contains constants corresponding to the various error codes which can be set by the CAT library.

All the symbolic constants defined in both these files begin with the prefix CAT__ (in conformance with normal Starlink practice).

You can INCLUDE either or both of these files in a subroutine by including either or both of the following lines in the subroutine, as appropriate:

      INCLUDE 'CAT_PAR'   ! CAT symbolic constants.
      INCLUDE 'CAT_ERR'   ! CAT error codes.

If you are using a standard ADAM prologue for the subroutine these lines will go in the `global constants' section.

The example applications included with CAT (see Section ), and probably your own applications, also need to access the standard ADAM INCLUDE file SAE_PAR. For convenience the instructions given below include setting up access to this file.

The following description applies to all the variants of Unix supported by Starlink. The files are kept in directory /star/include with names cat_par and cat_err. You should set up soft links to these files, following the normal Starlink procedure, which is described in SUN/111.2[8]. See in particular Section 4.4, p6. Simply type:

star_dev
cat_dev