XREFFILES Option

<xreffiles option>

──┬─ $ ──┬─┬─────────┬─ XREFFILES ────────────────────────────────────┤
  └─ $$ ─┘ ├─ RESET ─┤
           └─ SET ───┘

Explanation

If set, the compiler generates files containing analyzed cross-reference information in the program. These files can be used in EDITOR and INTERACTIVEXREF. The files have the titles XREFFILES/OBJECT/<file title>/DECS and XREFFILES/OBJECT/<file title>/REFS where <file title> is the title of the file containing the job.

The cross-reference information is written to a disk file in raw form. The compiler initiates SYSTEM/XREFANALYZER to process this file to generate the XREFFILES. This information is discarded if any syntax errors occur during compilation.

If used, this option should be SET before any source input is processed. Once SET, attempts to RESET it are ignored.

WFL is unlike other languages in that certain statements often continue for many lines. For example, the DATA statement continues until the <invalid> character is seen. The COMPILE statement can have multiple task and file equations to both the compiler and the resulting code file. These are declared in their own environment to make it easier to find the begin and end of the statement. The name of the environment is <statement>#<number>. For example, COMPILE#0 or DATA#10.

Example

The following partial job sets the XREFFILES option to generate xref files.

$SET XREFFILES
BEGIN JOB ZZZ;
...
END JOB