You can also obtain cross-reference information by running XREFANALYZER explicitly. The input file TITLE=XREF/<code file name> must be specified during initialization, and you should be aware of the following:
Files
XREFFILE
This is the input file and it should be label-equated to a valid XREF file produced by a compiler. This file is purged when XREFANALYZER is done with it unless the compile-time option DEBUG is TRUE. The title of this file should normally begin with XREF/. If an invalid XREF file is used, an error message is printed and XREFANALYZER is terminated.
XREFANALYZER can be invoked with XREFFILE file equated to KIND=PORT. When this is done, the title information is equated using the YOURNAME attribute instead of the TITLE attribute.
LINE
This is the output file.
DECLARATIONS
This file contains information about all declarations and can optionally be saved for later use. Its title is constructed from the XREF file by replacing XREF/ with XREFFILES/ and appending /DECS to the end of the title.
REFERENCES
This file contains information about all references and can optionally be saved for later use. Its title is constructed from the XREF file by replacing XREF/ with XREFFILES/ and appending /REFS to the end of the title.
Parameters
LINEWIDTH
XREFANALYZER is a procedure that has one REAL parameter: the line width of the output file LINE. The value of this parameter can be set between 72 and 132 characters. If it is set at less than 72, then the value is adjusted to 72. If it is set at more than 132, then the value is adjusted to 132. If it is set at 0, then printed output is not produced.
TASKVALUE
If the task value for XREFANALYZER is set to a negative number, then cross-reference information is saved in the DECLARATIONS and REFERENCES files.
When XREFFILE is file equated to KIND=PORT, the magnitude of TASKVALUE should be set to an approximation of the number of references that will occur in that file. If this approximation is significantly less than the number of references, XREFANALYZER terminates after reporting the following message:
SORT ERROR # 4 : SORT DISK EXHAUSTED DURING STRINGING