XREF

#### Search Results

Search

# XREF

`XREF` |  | `ON` |
`OFF`
`FORCE`
`DOC`

This command is only available if Predict has been installed. It controls the usage of the Predict function "active cross-references".

The active cross-reference facility automatically creates documentation in the Data Dictionary about the objects with a program/data area reference. These objects include programs, subprograms, subroutines, helproutines, maps, data areas, database views, database fields, user-defined variables, processing rules, error numbers, work files, printers, classes and retained ISN sets.

The active cross-reference is created when a program/data area is cataloged.

To look at cross-reference data, you use the `XREF` option of the system command `LIST`.

For further information on active cross-references, see the Predict documentation.

The following command options are available:

`XREF` | If you enter the `XREF` command without parameters, a menu/dialog is displayed where you specify the desired option.
`XREF ON` | This command activates the active cross-reference function. Cross-reference data will be stored in the respective Predict entries each time a Natural program/data area is cataloged.
`XREF OFF` | This command deactivates the active cross-reference facility. No cross-reference data will be stored. Existing cross-reference data for the object being cataloged will be deleted.
`XREF FORCE` | The object can only be cataloged if a Predict entry exists for it. When the object is cataloged, its cross-reference data will be stored in Predict. If no Predict entry exists, the object cannot be cataloged.
`XREF DOC` | The object can only be cataloged if a Predict entry exists for it. However, when the object is cataloged, no cross-reference data will be stored in Predict, and existing cross-reference data for the object will be deleted. If no Predict entry exists, the object cannot be cataloged.

#### Natural Security Considerations

If Natural Security is installed, the setting for `XREF` may be set for each library in the library security profile. Depending on the security profile, some options of the `XREF` command may not be available to you.