Die option-setting-Klausel wird verwendet, um die Standardwerte der Object Handler-Kommando-Optionen zu ändern.
Die Syntax, die für die option-setting-Klausel gilt, wird im folgenden Abschnitt dargestellt und erläutert. Die in den Syntaxdiagrammen enthaltenen Schlüsselwörter und Variablenwerte stellen die Parameter dar, die zur Angabe der Standardwerte verwendet werden. Ein Variablenwert (wenn angegeben) muss zusammen mit einem Schlüsselwort angegeben werden.
WHERE
|
||
|
|
(option-workplan) |
|
Das Syntaxdiagramm, das für option-workplan gilt, ist unter Arbeitspläne referenzieren im Kapitel Arbeitspläne (Workplans) dargestellt und beschrieben.
Die Syntax der option-clause ist im folgenden Abschnitt dargestellt.
|
|
REPLACE
|
|
|
|
|||||||||||
|
|
|
||||||||||||||
|
|
|
|
|||||||||||||
[ |
{REPORT-LIBRARY|REP-LIB}
library-name
|
||||||||||||||
[REP-LIB-DBID
dbid [REP-LIB-FNR fnr]]
[REP-LIB-NAME
vsam-name]
|
|||||||||||||||
[{REP-LIB-PASSWORD|REP-LIB-PSW}
password] [REP-LIB-CIPHER
cipher]
|
|||||||||||||||
] |
|||||||||||||||
|
|
REPORT-OPTION-1 |
|
|
|
|
||||||||||
|
|
REPORT-FORMAT |
|
|
|
|
||||||||||
|
|
REPORT-MODE |
|
|
|
|
||||||||||
|
|
|
||||||||||||||
[NUMBERPROCESS
number] |
|||||||||||||||
[FIXEDLENGTH] |
|||||||||||||||
[FDIC
(dbid,fnr,password,cipher)] |
|||||||||||||||
[FSEC
(dbid,fnr,password,cipher)] |
|||||||||||||||
|
|
|
|
|
|
|
||||||||||
|
|
|
|
command-file-number |
|
|||||||||||
Kommas müssen als Trennzeichen zwischen den Werten nach den
Schlüsselwörtern FDIC und FSEC verwendet werden, oder
wenn ein Wert weggeleassen wird. Zum Beispiel: FDIC
(10,21,,2a).
Wenn der Session-Parameter ID (siehe
ID -
Input-Begrenzungszeichen in der
Parameter-Referenz-Dokumentation) auf ein Komma gesetzt
wurde, müssen Sie einen Schrägstrich (/) als Trennzeichen zwischen den Werten
verwenden.
TRANSFER
|
|||||
|
|
CONVERSION-TABLE
|
|
|
|
|
[SUBSTITUTE] |
|||||
[INCLUDE-LINE-NUMBERS]
|
|||||
[UPPERCASE-TRANSLATION] |
|||||
[INCORPORATE-FREE-RULES] |
|||||
[LOAD-CODE-PAGE
code-page-name]
|
|||||
[DA-FORMAT
data-area-format]
|
|||||
[UNSHAPE] |
|||||
[USE-LINE-NUMBER-INCREMENT] |
|||||
|
|
XREF |
|
|
|
||
[DELETEALLOWED] |
||||||
[NOSYMBOLTABLE] |
||||||
[VERSIONCHECK]
|
||||||
Im folgenden Abschnitt werden die Schlüsselwörter und die Variablenwerte (sofern relevant) für option-setting erläutert:
| Option | Erläuterung | Nur für Kommando | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
REPLACE |
Ersetzt vorhandene Objekte entsprechend der angegebenen
Option:
|
|
|||||||||
TRANSFER |
Setzt den Übertragungsmodus.
Die Daten werden im Transfer-Format gelesen und geschrieben. Gültige Optionen finden Sie unter Erläuterung der Schlüsselwörter für transfer-options. |
|
|||||||||
NOREPORT |
Gibt die Einstellung für die Reportdatei an:
Es werden keine Daten in einer Reportdatei aufgezeichnet.
Dies ist die Standardeinstellung für die
Kommandos |
||||||||||
NEWREPORT |
Gibt die Einstellung für die Reportdatei an:
Die Reportdaten werden aufgezeichnet und in ein Natural Text Member geschrieben, das in der Arbeitsplan-Bibliothek gespeichert ist. Eine vorhandene Datei wird überschrieben. |
||||||||||
REPORT
|
Gibt die Einstellung für die Reportdatei an:
Die Reportdaten werden aufgezeichnet und in ein Natural
Text Member geschrieben, das in der Arbeitsplan-Bibliothek gespeichert ist.
Dies ist die Standardeinstellung für die die Kommandos
Zum Ändern der Standardeinstellungen siehe Profilparameter
|
||||||||||
BATCHREPORT |
Gibt die Reporteinstellung für die
Batch-Verarbeitung oder bei Verwendung der Anwendungsprogrammierschnittstelle
OBJHAPI an:
Die Reportdaten werden entweder nach SYSOUT geschrieben oder auf dem Bildschirm ausgegeben (die Reportdaten werden nicht in eine Datei geschrieben). |
||||||||||
Gibt die Library an, in der das
Reporttextobjekt gespeichert wird, wenn die Option
REPORT oder
NEWREPORT
angegeben ist.
Wenn diese Option nicht angegeben ist, wird die Library
|
|||||||||||
REP-LIB-DBID |
Die Datenbankkennung der Systemdatei, in
der sich die REPORT-LIBRARY befindet.
( |
||||||||||
REP-LIB-FNR |
Die Dateinummer der Systemdatei, in der
sich die REPORT-LIBRARY befindet.
( |
||||||||||
REP-LIB-NAME |
Der VSAM-Name der Systemdatei, in der
sich die REPORT-LIBRARY befindet.
|
||||||||||
Das Adabas-Passwort der Systemdatei, in
der sich die REPORT-LIBRARY befindet.
|
|||||||||||
REP-LIB-CIPHER |
Der Adabas-Chiffrierschlüssel für die
Systemdatei, in der sich die REPORT-LIBRARY befindet.
|
||||||||||
|
|
Gibt die Reportoption an, die verwendet
werden soll, wenn ein Direktkommando ausgeführt wird und ein Report geschrieben
werden soll:
|
|
|||||||||
|
|
Gibt das Reportformat an, das verwendet
werden soll, wenn ein Direktkommando ausgeführt wird und ein Report geschrieben
werden soll:
|
|
|||||||||
|
|
Gibt den Reportmodus an, der verwendet
werden soll, wenn ein Direktkommando ausgeführt wird und ein Report geschrieben
werden soll:
|
||||||||||
NORESTART
|
Es werden keine Restart-Informationen in eine Datei geschrieben. | LOAD |
|||||||||
RESTART
|
Die Restart-Informationen werden in ein Natural Text Member geschrieben, das in der Arbeitsplan-Bibliothek gespeichert ist. | LOAD |
|||||||||
NUMBERPROCESS
|
Gibt die Anzahl der zu verarbeitenden Objekte an.
Das Kommando |
|
|||||||||
FIXEDLENGTH
|
Legt das Format der Entladearbeitsdatei auf eine
maximale Satzlänge fester Größe fest.
Jeder Datensatz enthält 256 Bytes, wenn er im internen Format geschrieben wird, oder 100 Bytes im Transferformat. |
UNLOAD |
|||||||||
FDIC |
Gibt die Systemdatei FDIC an, die für die Verarbeitung
verwendet werden soll:
Datenbankkennung (dbid), file number (fnr), Passwort (password) und Chiffrierschlüssel (cipher) der Adabas-Datei. Wenn keine Werte (oder |
|
|||||||||
FSEC |
Gibt die Systemdatei FSEC an, die für die Verarbeitung
verwendet werden soll:
Datenbankkennung (dbid), Dateinummer (fnr), Passwort (password) und Chiffrierschlüssel (cipher) der Adabas-Datei. Wenn keine Werte (oder |
|
|||||||||
Der Arbeitsdateityp von Natural Work File 1, wenn Daten
gelesen und in die Arbeitsdatei geschrieben werden:
Wenn |
UNLOAD |
||||||||||
| Gilt nur, wenn Entire Connection
installiert ist.
Schreibt Daten in eine Entire-Connection-Arbeitsdatei oder liest Daten daraus. file-name bezeichnet den vollständigen Pfadnamen, der der Entire-Connection-Arbeitsdatei zugeordnet ist. Wenn Ihre Systemumgebung keinen Backslash (\) als Trennzeichen akzeptiert, verwenden Sie stattdessen einen Schrägstrich (/). Wenn Sie file-name nicht angeben, werden Sie von Entire Connection aufgefordert, den Namen einer Arbeitsdatei einzugeben. Wenn Siehe auch Zuweisung von Arbeitsdateien in Arbeitsdateien (Work Files). |
|
||||||||||
| Gilt nur, wenn Entire Connection installiert ist.
Gibt die Nummer der Arbeitsdatei an, die für die Verarbeitung von Entire Connection-Kommandos verwendet wird. Der Standardwert ist 8 für Work File 8, das als Entire Connection-Arbeitsdatei definiert sein muss. Siehe auch Zuweisung von Arbeitsdateien in Arbeitsdateien (Work Files). |
|
Die Schlüsselwörter und die variablen Werte (falls relevant) von transfer-options und internal-format-options werden im folgenden Abschnitt erläutert:
Wenn Sie das Schlüsselwort TRANSFER verwenden, können
Sie die folgenden Optionen angeben:
| Option | Erläuterung | Nur für Kommando | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
CONVERSION-TABLE |
Konvertiert Daten, die im Transferformat verarbeitet
werden, unter Verwendung einer der folgenden Konvertierungstabellen:
Die Natural-interne Konvertierungstabelle. Eine benutzerdefinierte Konvertierungstabelle, wenn ein
Konvertierungsprogramm (conversion-program)
angegeben wurde. Dieses Programm muss in der Library SYSOBJH oder einer ihrer
Steplibs abgelegt sein. Siehe die Beispielprogramme |
|
||||||||
SUBSTITUTE
|
Ersetzt beim Entladen im Transferformat die
Zeilenreferenzen durch Labels.
Diese Option gilt nur, wenn Ihre Quellcode-Zeilennummern für Statement-Referenzen verwendet werden. Ist dies der Fall, werden die Zeilennummern der referenzierten Zeilen und die Zeilennummernreferenzen durch Labels ersetzt. Die Quellcodes werden in der Datenbank nicht verändert. |
UNLOAD |
||||||||
INCLUDE-LINE-NUMBERS |
Überträgt Zeilennummern während des Entladens im
Transferformat. |
UNLOAD |
||||||||
|
|
|
|
||||||||
UPPERCASE-TRANSLATION |
Setzt jeden Quellcode beim Laden im Transferformat
in Großbuchstaben um. |
LOAD |
||||||||
INCORPORATE-FREE-RULES |
Übernimmt beim Entladen im Transferformat den Quellcode von Predict Free Rules, die mit einer Map verbunden sind, in den Map-Quellcode, wenn Predict installiert ist. | UNLOAD |
||||||||
LOAD-CODE-PAGE |
Gibt die Codepage an, die für die Konvertierung von
in Unicode/UTF-8 (Universal Transformation Format, 8-Bit-Form) kodierten
Objektquellcodes verwendet werden soll.
Wenn Sie diese Option verwenden, werden alle Objektquellcodes, die in eine Arbeitsdatei in UTF-8 entladen werden, mit der angegebenen Codepage konvertiert, wenn sie in eine Arbeitsdatei geladen werden. Wenn Sie Wenn |
|
||||||||
DA-FORMAT |
Legt die Formatkonvertierung von
Datenbereichsquellcodes fest.
Mögliche Werte:
Siehe Data area format in Übertragungsoptionen in Einstellungen (Settings). |
|
||||||||
UNSHAPE |
Ersetzt geformte arabische Zeichen (Codepage IBM420) durch die entsprechenden ungeformten Zeichen in den folgenden Quellcodeobjekten: Natural-Programme, benutzerdefinierte Fehlermeldungen und Systemfehlermeldungen. |
|
Wenn Sie internal-format-options verwenden, können Sie die folgenden Optionen angeben:
| Option | Erläuterung | Nur für Kommando | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
XREF |
|
|
||||||||||||||||||||||
DELETEALLOWED |
Verarbeitet Löschanweisungen aus Arbeitsdateien beim Laden von Objekten im internen Format. | LOAD |
||||||||||||||||||||||
NOSYMBOLTABLE |
Entlädt katalogisierte Natural-Library-Objekte ohne ihre entsprechenden internen Natural-Symboltabellen. Dadurch wird der benötigte Plattenspeicherplatz
reduziert. Dies ist jedoch nur für eine Produktionsumgebung sinnvoll, da dann
einige Anwendungsentwicklungsfunktionen, die die Symboltabellen benötigen,
nicht zur Verfügung stehen. Außerdem ist der Profilparameter
|
UNLOAD |
||||||||||||||||||||||
VERSIONCHECK |
Prüft die Natural-Version des zu ladenden katalogisierten Objekts. Dabei wird die Natural-Version, unter der die Objekte katalogisiert und in die Arbeitsdatei geschrieben wurden, mit der aktuellen Natural-Version verglichen. Objekte, die unter einer höheren Natural-Version als der aktuellen katalogisiert wurden, werden abgelehnt.
|
LOAD |
||||||||||||||||||||||
