outputPureQueryXml (Eigenschaft)

Gibt den vollständig qualifizierten oder relativen Pfad sowie den Namen der Datei(en) an, die der Prozess beim Erfassen von SQL-Anweisungen erstellt.

Der Wert, den Sie für diese Eigenschaft setzen, hat das Format Name.Erweiterung oder Name$X.Erweiterung.

Name
Gibt den Namen der Datei an. Geben Sie auch den absoluten oder relativen Pfad zur Datei an.
$X
Verwenden Sie dieses Suffix, wenn Sie mehrere pureQueryXML-Dateien für eine Clusteranwendung erstellen. pureQuery ersetzt diese Zeichen durch zwei Werte: durch die ID des ClassLoader-Objekts für die Anwendung und durch eine Zeitmarke, die angibt, wann pureQuery die betreffende Datei erstellt hat.
.Erweiterung
Die Erweiterung muss .pdqxml oder .xml lauten.

Wenn Sie SQL-Anweisungen erstmalig aus einer Anwendung ohne Cluster erfassen: Sie können die Eigenschaft outputPureQueryXml oder pureQueryXml verwenden. Sie müssen jedoch eine dieser Eigenschaften verwenden. Das von Ihnen angegebene Verzeichnis muss vorhanden sein. Sie müssen über die Berechtigung zum Erstellen von Dateien in diesem Verzeichnis verfügen.

Wenn Sie SQL-Anweisungen erstmalig aus einer Clusteranwendung erfassen: Verwenden Sie die Eigenschaft outputPureQueryXml mit dem Suffix $X.

Wenn Sie zusätzliche SQL-Anweisungen aus einer Anwendung ohne Cluster erfassen, für die Sie bereits eine pureQueryXML-Datei erstellt haben: Sie können mit der Eigenschaft pureQueryXml die Datei als Eingabedatei angeben und mit der Eigenschaft outputPureQueryXml zusätzliche SQL-Anweisungen erfassen, die nicht bereits in der Eingabedatei aufgeführt sind.

Wenn Sie zusätzliche SQL-Anweisungen aus einer Clusteranwendung erfassen: Verwenden Sie die Eigenschaft pureQueryXml, um als Eingabedatei die pureQueryXML-Datei anzugeben, die beim Mischen der beim letzten Erfassen von SQL-Anweisungen aus der Anwendung erstellten Dateien entstanden ist. Verwenden Sie die Eigenschaft outputPureQueryXml mit dem Suffix $X, um die Dateien anzugeben, in denen zusätzliche SQL-Anweisungen erfasst werden sollen.

Sie können diese Eigenschaft nicht verwenden, wenn eine Anwendung nur Anweisungen ausführen soll, die zuvor erfasst wurden. Sie müssen die Eigenschaft pureQueryXml verwenden, um die Datei anzugeben, in der diese Anweisungen erfasst werden.

Werden die Eigenschaften outputPureQueryXml und outputXmlRepository gesetzt, wird eine Ausnahmebedingung ausgelöst.

Wichtig: Wird erfasstes SQL in den in dem Dateisystem befindlichen Dateien gespeichert, müssen Sie sicherstellen, dass die Anwendung im Quiescemodus ist und dass nicht während des Abrufens der Dateien in die Dateien geschrieben wird. Wird die Anwendung nicht in den Quiescemodus versetzt, ist der Inhalt der Dateien möglicherweise nicht gültig oder die Anwendung ist möglicherweise nicht in der Lage, die Dateien zu aktualisieren, was zu einem E/A-Fehler führt. Sie können die Option -validateXml mit dem Dienstprogramm Merge oder dem Dienstprogramm Configure verwenden, um die Gültigkeit der Dateien sicherzustellen.

Feedback