All cross-reference (XRef) data stored in the Predict system file for a cataloged programming object (not applicable to DDMs) can be processed with SYSMAIN.
The Predict system file is determined by the value assigned to the profile parameter
FDIC (see FDIC - Predict
System File in the Parameter Reference
documentation) in the parameter file or at the start of the Natural session.
You can override the current FDIC settings for the duration of the current SYSMAIN
function by replacing the values in the XREF window (database ID and
file number 0 denote the current FDIC) or by specifying the DIC
keyword in the where-clause of a
command.
The XREF field in an object-specification window or the
XREF keyword in a command indicates whether SYSMAIN should process XRef
data.
If Predict has not been installed, enter N in the XREF
field (or specify XREF=N) to not process XRef data in Predict files. This is
the default setting.
The section below covers the following topics:
No XRef data is processed if the XREF field contains an
N (or XREF=N).
However, regardless of what setting you choose, XRef data is always deleted when a programming object is deleted.
XRef data is processed if Y is entered in the XREF
field (or XREF=Y).
If XRef data is to be processed, the following actions are applied during SYSMAIN processing:
SYSMAIN checks whether XRef data exists in the Predict source system file for the specified programming object.
If a programming object is to be deleted from the target environment, XRef data is deleted from the Predict target system file.
If a programming object is copied to a new environment, the XRef data of the programming object is copied from the Predict source system file to the Predict target system file. The library name is changed accordingly and, in the case of the rename function, the object name is also changed.
If the move function is executed, the XRef data of the programming object is deleted from the Predict source system file.
If file security has been defined for the FDIC system file, you need to specify a password and a cipher code for the required source and/or target system file before you perform a SYSMAIN function. Otherwise, an appropriate error message appears. You do not have to provide security information for the default system files assigned to you at the start of the SYSMAIN utility.
If any of the following inconsistencies occur during SYSMAIN processing of XRef data, all processing for the object or function is terminated and an error message is displayed:
The value of the XREF option in Natural Security is set to Y and the
XREF field contains an N (or XREF=N).
The XREF field contains a Y (or
XREF=Y) and the FDIC file(s) being used are not valid Predict
files.