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