This Natural profile parameter is used to
enable/disable the creation of XRef data for Natural. This parameter also determines how
XRef data are treated when Natural members are processed with the Natural utilities
SYSMAIN
or INPL
or with the Object Handler.
Possible settings | ON |
XRef data are generated in the cases described above. Documentation premise is not checked. | |
---|---|---|---|
OFF |
XRef data are not generated. Documentation premise is not checked. | ||
FORCE |
A Natural object can only be cataloged if a documentation object already exists for this implementation object. XRef data are generated in the cases described above. | ||
DOC |
A Natural object can only be cataloged if a documentation object already exists for this object. XRef data are not generated. | ||
Default setting | OFF |
||
Dynamic specification | yes | ||
Specification within session | yes | ||
Applicable statements | none | ||
Applicable commands | XREF |
The following topics are covered below:
There are different ways to set the Natural XREF
parameter:
In the Natural parameter module.
As a dynamic parameter when starting a Natural session.
In Natural Security. If Natural Security has been used to set the
XREF
parameter, the XREF
command
may only be used to enforce this setting (by changing from ON
to
FORCE
, from OFF
to ON
or
FORCE
).
With the Natural XREF
command. If Natural Security is not
installed, the XREF
parameter is usually set with the Natural
XREF
command. The Natural command XREF
?
displays the current setting of the XREF
parameter.
XRef data is generated in two cases:
The Natural compiler writes XRef data for Natural programs and data areas when these
are cataloged (provided that the XREF
parameter has been set to
either ON
or FORCE
, see below).
Natural Security writes XRef data for programs that are used as Startup, Restart or
Error-Transaction in an application or as a special link if the
XREF
parameter is set to ON
or
FORCE
in the application's Natural Security definition and a user
system file is defined for the application.
The XREF
parameter controls the compilation in two aspects:
generation of XRef data in the cases described above and
fulfilment of premise to document implementation objects. The adherence to this
premise can be ensured by allowing the completion of the catalog operation only for
objects that are documented in the Predict FDIC
system file or in the
development server file used in Natural Single Point of Development (SPoD).
The extended XREF
parameter is reserved for internal use by
Natural.