XREFANALYZER Utility

The SYSTEM/XREFANALYZER utility is a system software utility that constructs detailed information about all identifiers declared in a program.

The cross-reference files (XREF files) generated by XREFANALYZER contain entries for each identifier in a program. Each separate entry is referred to as the header line information. The header line contains the following information about the identifier:

  • The alphanumeric name

  • The environment

  • The declared type

  • The stack location

  • The sequence number of the declaration

This information is helpful in developing, debugging, and updating programs.

Cross-reference information is generated by a compiler during the compilation of a particular version of a program. Thus, the XREF files do not reflect changes that are made to a file after the compilation was performed. Also, if any syntax errors are encountered during the compilation of a program, XREFANALYZER is not run.

The language compilers that have the capability to execute XREFANALYZER are ALGOL, DCALGOL, FORTRAN, Pascal, and COBOL74. FORTRAN does not keep track of environment information; therefore, no environment information is included in the header line.

When XREFANALYZER is executed, it makes two passes through its input file. The first pass builds the REFERENCES file. The second pass alphabetically sorts the identifiers and writes the actual cross-reference listing.