| SimCon Home | Reference Manual Home |

PRIMARY INPUT SEARCH PATH

Syntax:

[ADD TO] PRIMARY [INPUT] [FILE] [SEARCH] PATH [:] <string> ...

Function:

Specifies a sequence of directories in which the primary Fortran input files are to be sought. Primary files, in this context, are files which are not referenced by INCLUDE statements in the code. The search continues until one instance of the required file has been identified.

The directories are written as quoted strings. Note that command continuation characters must be used if the sequence of directories extends over two or more lines.

If ADD TO PRIMARY INPUT SEARCH PATH is specified, the argument is added to the existing path (if any). Otherwise the new path replaces the old path.

The command is position sensitive in the FSP files. It applies to the file names which follow it, and different search paths may be specified for different groups of files.

The command may be used to layer library directories over one another, resolving each reference from the first file encountered with a specified name.

The command PRIMARY INPUT DIRECTORY specifies a single directory from which the primary files are to be read.

The command ADD TO PRIMARY INPUT SEARCH PATH appends additional directories to the current search path.

Where to use this command:

Operating system command line	Yes
Configuration file, config.fsp	Yes
Specification (FSP) files, *.fsp	Yes
Interactively, to FPT> prompt:	No
Interactive command files	No
Embedded in the Fortran code	Yes

Default:

By default, an input file is sought only in the current working directory.

Example:

FSP file:

    ! eagle.fsp
 
    %primary input search path:                 -
    ../eaglelib                                 -
    /usr/people/davidc/libs/source/aerolib      -
    /usr/simlib/matvec/source
 
    controls.f
    totalf.f
    totalm.f
    ail.f
    rudd.f
    flaps.f
    eng1.f
    engcont.f
    engbda.f
    matmul.for
    fcng1.for
    fcng2.for
    leadlag.f
    integinit.f
    integ.f
 
    ! end of eagle.fsp

See also:

PRIMARY INPUT DIRECTORY

ADD TO PRIMARY INPUT SEARCH PATH