1. Home
  2. LIBFILENAME procedure

LIBFILENAME procedure

Supplies the names of information files for library procedures (R.W. Payne).

No options

Parameters

FILENAME = texts Text in which to store the name of the backing-store file containing the required information
CONTENTS = string tokens Indicates which file is required (procedures, adesign, afraction, acyclic, agenerator); default proc

Description

The source code of the procedures in the Genstat Procedure Library is stored in a backing-store file for use by the LIBEXAMPLE procedure. Other backing-store files store information that is used by some of the Genstat procedures for design of experiments. When a procedure needs to access any of this information, it calls LIBFILENAME to ascertain the name and location of the relevant file. (It then opens the file on the first free backing-store channel, reads the required information, and closes the file again.)

Options: none.

Parameters: FILENAME, CONTENTS..

Method

The procedure contains a text structure containing the various filenames, and the POSITION function of CALCULATE is used to set FILENAME to the appropriate one.

Action with RESTRICT

Any restriction on the FILENAME text will be cancelled.

See also

Directive: HELP.

Procedures: LIBEXAMPLE, LIBHELP, LIBVERSION.

Example

CAPTION 'LIBFILENAME example'; STYLE=meta
LIBFILENAME where
PRINT [IPRINT=*; STYLE=plain]\ 
     'The source code of Library procedures is stored in backing-store file',\
      where,'.'; FIELD=1
Updated on March 7, 2019

Was this article helpful?