Cross-reference table

A cross-reference table of the program module is provided if the XREF option was specified for the run. The table does not depend upon nor does it automatically generate a module map.

The table contains one entry for each address constant in the module. The left half of the table describes the reference (address constant), showing module location, section name, section offset, and address constant type. The right half of the table describes the external symbol being referenced. Table entries appear in the same sequence as the location of the address constants within the overlay segment.

Figure 1 shows a sample cross-reference table. The columns contain the following information:

CLASS OFFSET - The offset of the address constant relative to the start of the class.
SECT/PART - The name of the section or part containing the address constant.
SEG - The segment number if the module is in overlay format.
RG - The region number if the module is in overlay format.
ELEMENT OFFSET - The offset of the address constant relative to the start of the section component of the class.
TYPE - Address constant type. One of six types may appear:
- V-CON - An adcon normally used for program branching
- A-CON - An adcon normally used for data reference
- Q-CON - An adcon that references a pseudoregister or other part by its offset within the class
- C-LEN - An adcon that will receive the cumulative length of the pseudoregister vector or other class.
- L TOKE - loader token: represents a unique instance of the module on DASD.
- R-CON - An adcon referencing the associated data (environment) of the target symbol.
SYMBOL - The external symbol being referenced.
SECTION - The name of the section containing the referenced symbol. If the symbol is unresolved or nonrelocatable, this field is set to one of the following:
- $NON-RELOCATABLE - The address constant contains a nonrelocatable value, such as a pseudoregister offset or PRV length.
- $UNRESOLVED - The referenced symbol is unresolved.
- $UNRESOLVED(W) - The referenced symbol is an unresolved weak external reference (WXTRN).
- $NEVER-CALL - The referenced symbol was identified as never-call.
- $IMPORTED - The referenced symbol was dynamically resolved.
SEG - The number of the overlay segment containing the referenced symbol if the module is in overlay format.
RG - The number of the overlay region containing the referenced symbol if the module is in overlay format.
ELEMENT OFFSET - The offset of the referenced symbol relative to the start of its containing element, identified by section and class names.
CLASS NAME - The target class.

The cross reference table contains one segment for each text class containing address constants. A separator line containing the class precedes the adcon listing. Text classes that are not loaded with the module, such as B_PRV, will never contain address constants and will not appear in this report.

Figure 1. Sample binder cross-reference table

                                        C R O S S - R E F E R E N C E  T A B L E
                                        _________________________________________

 TEXT CLASS = B_TEXT

 ---------------  R E F E R E N C E  --------------------------  T A R G E T  ---------------------
   CLASS                       ELEMENT       |                                    ELEMENT
   OFFSET SECT/PART (ABBREV)    OFFSET  TYPE | SYMBOL(ABBREV) SECTION (ABBREV)    OFFSET CLASS NAME
                                             |
       48 SD1                     48   A-CON |                SD1                   0    B-TEXT
       C4 SD1                     C4   V-CON | LD1            SDX                  A8    B_TEXT
      126 SD1                    126   Q-CON | GFLGA          $NON-RELOCATABLE      0    B_PRV
      18E SD1                    18E   Q-CON | B-TOKEN        $NON-RELOCATABLE     10    B_PRV
      1F6 SD1                    1F6   Q-CON | GFLGC          $NON-RELOCATABLE      2    B_PRV
      25E SD1                    25E   Q-CON | MASTER         $NON-RELOCATABLE      8    B_PRV
      2C6 SD1                    2C6   Q-CON | GFLGE          $NON-RELOCATABLE      1    B_PRV
      32E SD1                    32E   Q-CON | COUNTF         $NON-RELOCATABLE      4    B_PRV
      396 SD1                    396   Q-CON | GFLGG          $NON-RELOCATABLE      3    B_PRV
      3FC SD1                    3FC   CXD   |                $NON-RELOCATABLE           B_PRV
      490 SD1                    490   V-CON | SD2            SD2                   0    B_TEXT
      568 SD2                     48   A-CON |                SD2                   0    B_TEXT
      5E4 SD2                     C4   V-CON | LD2            SDX                  AC    B_TEXT
      644 SD2                    124   V-CON | LD3            $PRIVATE              0    B_TEXT
      6A4 SD2                    184   V-CON | LD4            $PRIVATE              4    B_TEXT
      704 SD2                    1E4   V-CON | CM1            CM1                   0    B_TEXT
      7B4 SD2                    294   V-CON | CM1            CM1                   0    B_TEXT
      860 SDX                     48   A-CON |                SDX                   0    B_TEXT