The LOADXREF command associates a set of cross-reference information files with a segment dictionary stack or with the MCP. You can use cross-reference information files to display the identifier name and compiler class along with stack variables.

Before you can use the LOADXREF command, XREFSUPPORT must be established as a support library. If it is not, you can make it a support library with the SL (Support Library) system command.

If the code file was compiled without the LINEINFO option set, the identifier information cannot be displayed.

If LOADXREF is requested for a stack and the IDNAMES option is requested in the MODE command, DUMPANALYZER identifies the stack variables by using the BINDINFO information instead of using the cross-reference information files. For more information, see the discussion of the MODE command in this section.

If BINDINFO information does not exist for an environment, then the cross-reference information files are used. You cannot use the LOADXREF command to get identifier names for environments that are bound into the MCP.

Syntax

── LOADXREF ─┬─ MCP ────┬─<quoted code file title>─┬──────────┬───────
             └─<number>─┘                          └─ : ── C ─┘

Explanation

The following text describes the meaning of each construct. Refer to “Basic Constructs” earlier in this section for information about the <number> and the VIA <ASD number> constructs. Refer to “File Title” earlier in this section for an explanation of the rules for specifying a file title.

LOADXREF MCP <quoted code file title>

Associates the following cross-reference information files with the MCP code file and then displays the identifier name and compiler class along with stack variables:

LOADXREF <number> <quoted code file title>

Associates the following cross-reference information files with the specified stack, if the number specifies a segment dictionary stack. If the number does not specify a segment dictionary stack, DUMPANALYZER associates these files with the segment dictionary stack for the specified stack:

You can load cross-reference information files for a stack whose segment dictionary stack is the MCP stack only by using the LOADXREF MCP form of the command.

: C

Creates a LOCS file in your directory if a valid LOCS file is not found. The LOADXREF command needs the XREFFILES/<quoted code file title>/LOCS file to process cross-reference information files more efficiently.

You can also create a LOCS file by running the INTERACTIVEXREF utility with the SW1 task attribute set to TRUE. For further information, refer to the INTERACTIVEXREF section later in this manual.