XREF | NOXREF

Pragma equivalent

#pragma options(xref) (C only), #pragma options(noxref) (C only)

Purpose

Produces a compiler listing that includes a cross-reference listing of all identifiers.

Syntax


   .-NOXR-----------.   
>>-+-XR--+--------+-+------------------------------------------><
         '-(FULL)-'

Defaults

NOXREF

In the z/OS® UNIX System Services environment, this option is turned on by specifying -V when using the c89, cc, or c++ commands.

Parameters

FULL: (Only for C++) Reports all identifiers in the program. When XR is specified without FULL, the report is generated only for the referenced symbols.

Usage

The XREF option generates a cross-reference listing that shows file definition, line definition, reference, and modification information for each symbol. It also generates the External Symbol Cross Reference and Static Map.

IPA effects

During the IPA compile step, the compiler saves symbol storage offset information in the IPA object file as follows:

For C, if you specify the XREF, IPA(ATTRIBUTE), or IPA(XREF) options or the #pragma options(XREF)
For C++, if you specify the ATTR, XREF, IPA(ATTRIBUTE), or IPA(XREF) options

If regular object code or data is produced using the IPA(OBJECT) option, the cross-reference sections of the compile listing will be controlled by the ATTR and XREF options.

If you specify the ATTR or XREF options for the IPA link step, it generates External Symbol Cross Reference and Static Map listing sections for each partition.

The IPA link step creates a Storage Offset listing section if during the IPA compile step you requested the additional symbol storage offset information for your IPA objects.

Predefined macros

None.