XREF - Erzeugung von XRef-Daten für Natural

Dieser Natural-Profilparameter dient zum Ein- und Ausschalten der Erzeugung von Verweistabellendaten (XRef Data) für Natural. Dieser Parameter bestimmt außerdem, wie die XRef-Daten behandelt werden, wenn Natural Member mit den Natural Utilities SYSMAIN oder INPL oder mit dem Object Handler verarbeitet werden.

Mögliche Werte ON XRef-Daten werden in den oben aufgeführten Fällen erzeugt. Die Dokumentationsvorbedingung wird nicht abgeprüft.
OFF XRef-Daten werden nicht erzeugt. Die Dokumentationsvorbedingung wird nicht abgeprüft.
FORCE Ein Natural-Objekt kann nur dann katalogisiert werden, wenn für dieses Implementuerungsobjekt schon ein Dokumentationsobjekt existiert. XRef-Daten werden in den oben aufgeführten Fällen erzeugt.
DOC Ein Natural-Objekt kann nur dann katalogisiert werden, wenn für dieses Implementierungsobjekt schon ein Dokumentationsobjekt existiert. XRef-Daten werden nicht erzeugt.
Standard-Einstellung OFF  
Dynamische Angabe ja  
Angabe innerhalb der Session ja Gültige Statements: keine
Gültige Kommandos: XREF

Folgende Themen werden nachfolgend behandelt:


Möglichkeiten, den XREF-Parameter zu setzen

Es gibt mehrere Möglichkeiten, den Natural-Profilparameter XREF zu setzen:

  • Im Natural-Parametermodul.

  • Als dynamischen Parameter beim Starten einer Natural-Session.

  • In Natural Security. Falls Natural Security verwendet wurde, um den XREF-Parameter zu setzen, kann das Kommando XREF nur verwendet werden, um diese Einstellung zu erzwingen (indem von ON auf FORCE, von OFF auf ON oder FORCE umgeschaltet wird).

  • Mit dem Natural-Systemkommando XREF. Falls Natural Security nicht installiert ist, dann wird der XREF-Parameter üblicherweise mit dem Natural-Kommando XREF gesetzt. Das Kommando XREF ? zeigt die aktuelle Einstellung des XREF-Parameters an

XRef-Datenerzeugung

XRef-Daten werden zwei Fällen erzeugt:

  • Der Natural Compiler schreibt XRef-Daten für Natural-Programme und Natural Data Areas, wenn diese katalogisiert werden (vorausgesetzt, der Parameter XREF wurde entweder auf ON oder FORCE gesetzt, siehe unten).

  • Natural Security schreibt XRef-Daten für Programme, die als Startup-, Restart- oder Error-Transaction-Programme in einer Anwendung verwendet werden oder als spezieller Link, wenn der Parameter XREF in der Natural Security-Definition der Anwendung auf ON oder FORCE gesetzt und eine Benutzersystemdatei für die Anwendung definiert ist.

Der XREF-Parameter steuert die Kompilierung in zweierlei Hinsicht:

  • Erzeugung von XRef-Daten in den oben beschriebenen Fällen und

  • Erfüllen der Vorbedingung, dass Impementierungsobjekte dokumentiert werden. Die Einhaltung dieser Vorbedingung kann dadurch sichergestellt werden, dass die Fertigstellung der Katalogisierungsoperation nur für Objekte erlaubt wird, die in der Predict-Systemdatei FDIC oder in der Development Server-Systemdatei in einer Natural Single Point of Development (SPoD)-Umgebung dokumentiert sind.

Erweiterte XRef-Datenerzeugung (nur für interne Verwendung)

Wichtig:
Der erweiterte XREF-Parameter ist für die interne Verwendung durch Natural vorgesehen.