The INTERACTIVEXREF utility obtains information from files generated by the SYSTEM/XREFANALYZER utility.

These files are called XREFFILES (or cross-reference files) and have the titles XREFFILES/<code file name>/DECS and XREFFILES/<code file name>/REFS. The code file name is the name of the code file that was being generated by the compiler when the XREFFILES were created. When compiled through the Command and Edit (CANDE) message control system (MCS), the code file name is normally prefixed by OBJECT followed by a slash (/).

You can produce XREFFILES by using the XREFFILES compiler control option. When you use this option, the compiler either generates the XREFFILES itself or else runs SYSTEM/XREFANALYZER to produce them. Compiler Control Options for Producing XREFILES describes the compiler control option settings that produce either the XREFFILES, or printed output of the cross-reference information, or both.

These options are available in the following compilers:

If any syntax errors are encountered, the XREFFILES are not produced.

For compilers that use XREFANALYZER to produce their cross-reference files, the XREFFILES can also be produced by running XREFANALYZER with a negative task value. To do this, the XREFANALYZER input file TITLE=XREF/<code file name> must be specified during initialization.

Version information is included in the XREFFILES. INTERACTIVEXREF checks the version compatibility of the XREFFILES and displays an appropriate error message if the XREFFILES were created with an incompatible compiler or XREFANALYZER. These files must be present for INTERACTIVEXREF to run.

Information from the original symbol file used in the compilation is needed by several commands.