Dieser Natural-Profilparameter gestattet es Ihnen, die maximale
Anzahl an Arbeitsdateien (Workfiles) festzulegen, die während der Session
verwendet werden soll. Der Parameter WORK entspricht dem
Makro NTWORK im
Natural-Parametermodul.
| Mögliche Werte | Siehe WORK-Parameter-Syntax. | |
|---|---|---|
| Standard-Einstellung | Siehe Standardwerte der weiter unten beschriebenen Schlüsselwort-Subparameter. Je nach Zugriffsmethode und Umgebung kann es unterschiedliche Standard-Einstellungen geben. | |
| Dynamische Angabe | ja | Der Parameter WORK kann nur
dynamisch angegeben werden. Im
Natural-Parametermodul
wird das Makro NTWORK verwendet.
|
| Angabe innerhalb der Session | nein | |
Anmerkungen:
AM festgelegt.
AM=STD definiert, können sie während der Session
dynamisch durch ein Natural-Programm mittels des
DEFINE WORK
FILE-Statements oder der Anwendungsprogrammierschnittstelle
(API) USR2021 (in der Library SYSEXT) zugewiesen
werden.
Dieses Dokument behandelt folgende Themen:
Mit dem Parameter WORK geben Sie zunächst
eine oder mehrere logische Arbeitsdateinummern an und danach mehrere
Schlüsselwort-Subparameter, mit denen Sie die Eigenschaften dieser
Arbeitsdateien festlegen:
| WORK=((work-file-numbers),keyword-subparameters,...) |
Dabei ist:
Anmerkung:
Der Profilparameter WORK kann mehrmals
(abgetrennt durch ein Komma oder ein Leerzeichen) angegeben werden, um
unterschiedliche Arbeitsdatei-Definitionen anzulegen.
WORK=((2,12,18),AM=STD,DEST='WORK**') WORK=((1,3,6-11,15),AM=COMP,OPEN=INITOBJ,CLOSE=CMD)
Mit einem Makro NTWORK geben Sie zunächst
eine oder mehrere logische Arbeitsdateinummern an und danach mehrere
Schlüsselwort-Subparameter, mit denen Sie die Eigenschaften dieser
Arbeitsdatei(en) festlegen:
NTWORK (work-file-numbers),keyword-subparameters,...
Dabei ist:
Anmerkung:
Das Makro NTWORK kann mehrmals angegeben
werden, um unterschiedliche Arbeitsdatei-Definitionen anzulegen.
NTWORK (2,12,18),AM=STD,DEST='WORK**'
NTWORK (1,3,6-11,15),AM=COMP,OPEN=INITOBJ,CLOSE=CMD
Die folgenden Schlüsselwort-Subparameter stehen für alle Umgebungen zur Verfügung:
AM |
DEST |
OPEN |
CLOSE |
LRECL |
TRUNC |
PAD |
PADCHRO |
PADCHRI
Mit AM=value geben Sie den
Typ der Zugriffsmethode an, die verwendet werden soll.
| Wert | Zugriffsmethode |
|---|---|
STD |
Sequenzielle Standard-Dateien (Batch, TSO, TIAM). |
COMP |
Com-plete-Arbeitsdateien. |
SMARTS |
SMARTS-Arbeitsdateien. Arbeitsdateien in einem SMARTS Portable File System (PFS). |
CICS |
Transiente CICS-Daten oder temporärer Speicher. |
PC |
Entire Connection. |
USER |
Drittanbieter-Arbeitsdatei-Interface. |
OFF |
Nicht zugewiesen. Keine automatische
Zuweisung, falls FAMSTD=OFF gesetzt ist.
Anmerkung: |
0 |
Nicht zugewiesen. Automatische
Zuweisung, falls FAMSTD=OFF gesetzt ist.
Dies ist die Standard-Einstellung. |
Anmerkungen:
AM=STD) zugewiesen,
vorausgesetzt sie wurden in der JCL vordefiniert. Siehe auch
FAMSTD - Überschreiben der
Arbeitsdatei-Zugriffsmethodenzuweisungen.
DEST=value gibt den
externen Dataset-Namen an.
| Wert | Erklärung |
|---|---|
| 1 - 8 Zeichen oder 1 - 7 Zeichen, je nach Zugriffsmethode und Umgebung. | Name des externen Dataset.
Anmerkung: |
Die Bedeutung des Subparameters DEST ist
abhängig von der Zugriffsmethode:
| Zugriffsmethode | Bedeutung des Schlüsselwort-Subparameters DEST |
|---|---|
AM=STD |
DEST ist der logische
Dataset-Name (DDNAME, LINK-Name, DTF-Name).
Anmerkungen:
|
AM=CICS |
Für Arbeitsdateien unter CICS gibt es keine
Standard-Einstellung. Hier ist der Subparameter DEST
zwingend erforderlich, d.h., dass CICS-Arbeitsdateien ohne gültige
DEST-Angabe ignoriert werden.
Das Natural CICS Interface unterstützt außerdem eine
Variable (siehe |
AM=COMP |
DEST definiert den Namen der
Com-plete SD-Datei. Die Länge ist auf maximal 8 Zeichen begrenzt.
Anmerkungen:
|
Mit OPEN=value bestimmen
Sie den Zeitpunkt der Datei-Öffnung.
| Wert | Die Datei wird geöffnet ... |
|---|---|
INIT |
für die Ausgabe bei der Initialisierung der Session. |
OBF |
gemäß der
OPEN-Standard-Einstellung für unterschiedliche
Umgebungen (Batch, CICS, Com-plete, TSO).
|
OBJ |
wenn die Ausführung des ersten Objekts, das auf die
Arbeitsdatei zugreift, beginnt.
Dies ist der Standardwert. |
INITOBF |
für die Ausgabe bei der Initialisierung der Session.
Bei jeder anschließenden erneuten Öffnung der Datei wird die
OPEN-Standard-Einstellung für unterschiedliche
Umgebungen (Batch, CICS, Com-plete, TSO) gesetzt.
|
OBJ1 |
wenn die Ausführung des ersten Objekts auf Ebene 1, das auf die Arbeitsdatei zugreift, beginnt. Andernfalls wird sie geöffnet, wenn zum ersten Mal auf sie zugegriffen wird. |
ACC |
wenn zum ersten Mal durch ein Statement auf sie zugegriffen wird. |
INITOBJ |
für die Ausgabe bei der Initialisierung der Session. Jede anschließende erneute Öffnung der Datei wird durchgeführt, wenn die Ausführung des ersten Objekts, das auf die Arbeitsdatei zugreift, beginnt. |
INITOBJ1 |
wenn die Ausführung des ersten Objekts auf Ebene 1, das auf die Arbeitsdatei zugreift, beginnt. Andernfalls wird sie geöffnet, wenn zum ersten Mal auf sie zugegriffen wird. |
INITACC |
für die Ausgabe bei der Initialisierung der Session. Jede anschließende erneute Öffnung der Datei wird durchgeführt, wenn zum ersten Mal durch ein Statement auf sie zugegriffen wird. |
Mit CLOSE=value bestimmen
Sie den Zeitpunkt der Datei-Schließung.
| Wert | Die Datei wird geschlossen ... |
|---|---|
OBJ |
entweder, wenn die Verarbeitung des Objekts, in dem
zuerst auf die Datei zugegriffen wurde, beendet ist, oder, wenn der
Kommandomodus, NEXT- oder MAINMENU-Modus erreicht
ist.
|
CMD |
wenn der Kommandomodus, NEXT- oder
MAINMENU-Modus erreicht ist.
Dies ist die Standard-Einstellung. |
FIN |
beim Session-Ende.
Anmerkung: |
USER |
Dieser Wert gibt an, dass die Arbeitsdatei nur dann geschlossen wird, wenn die Datei offen ist und eine der folgenden Bedingungen zutrifft:
|
Mit LRECL=value bestimmen
Sie die Datensatzlänge des Dataset.
| Wert | Erklärung |
|---|---|
0 oder 5 -
32767 |
Datensatzlänge in Bytes. |
0 |
Dies ist der Standardwert. |
Anmerkung:
Dieser Subparameter dient insbesondere zur Überprüfung auf
Trunkierung und Auffüllung. Weitere Informationen zu AM=STD siehe
Subparameter LRECL im Abschnitt
Schlüsselwort-Subparameter
für AM=STD in allen Umgebungen.
Mit TRUNC=value bestimmen
Sie, ob die Ausgabe-Datensätze trunkiert werden oder nicht.
| Wert | Erklärung |
|---|---|
ON |
Ausgabe-Datensätze, die länger sind als
die Datensatzlänge (LRECL) des Dataset, werden
trunkiert.
|
OFF |
Der Fehler NAT1512 wird ausgegeben,
wenn ein Ausgabe-Datensatz länger ist als die Datensatzlänge des Dataset.
Dies ist die Standard-Einstellung. |
Mit PAD=value bestimmen
Sie, ob die Ausgabe-Datensätze aufgefüllt werden oder nicht (gilt nur bei
Datasets mit fester Datensatzlänge).
| Wert | Erklärung |
|---|---|
ON |
Ausgabe-Datensätze, die kürzer sind als
die Datensatzlänge (LRECL) des Dataset, werden
aufgefüllt. Die mit Auffüllzeichen werden mit dem Schlüsselwort-Subparameter
PADCHRO
definiert.
Dies ist der Standardwert. |
OFF |
Der Fehler NAT1510 wird ausgegeben, wenn ein Ausgabe-Datensatz kürzer ist als die Datensatzlänge des Dataset. |
Mit PADCHRO=value
definieren Sie das Zeichen, das zum Auffüllen von Ausgabe-Datensätzen verwendet
wird, wenn für die Arbeitsdatei PAD=ON angegeben wurde.
| Wert | Erklärung |
|---|---|
|
|
Ein Zeichen
|
x'00' |
Dies ist der Standardwert. |
Mit PADCHRO=value
definieren Sie das Zeichen, das zum Auffüllen von Eingabe-Datensätzen verwendet
wird.
| Wert | Erklärung |
|---|---|
|
|
Ein Zeichen
|
x'40' |
Leerzeichen.
Dies ist der Standardwert. |
Die folgenden Schlüsselwort-Subparameter stehen für
AM=STD in allen Umgebungen zur Verfügung:
Mit RECFM=value bestimmen
Sie das Standard-Datensatzformat des Dataset.
Unterstützte Formate:
| Format | Erklärung |
|---|---|
F |
Fest |
V |
Variable |
U |
Undefiniert |
B |
In Blöcke unterteilt |
S |
Segmentiert |
A |
ASA |
M |
Machinensteuerzeichen |
Folgende Werte und Wertekombinationen sind möglich:
| Wert | Erklärung |
|---|---|
F, FA, FM, FB, FBA, FBM, V, VA,
VM, VB, VBA, VBM, VBS, VBSA, VBSM, U, UA, UM |
Diese Werte bzw. Wertekombinationen können angegeben werden. |
VB |
In variable Blöcke unterteilt.
Dies ist der Standardwert. |
Anmerkung:
Die RECFM-Angabe gilt nur, wenn in der
JCL oder (nur bei z/OS) im Dataset-DCB kein Datensatzformat vordefiniert
ist.
Mit BLKSIZE=value
bestimmen Sie die Standard-Blockgröße des Dataset.
Mögliche Werte:
| Wert | Erklärung |
|---|---|
|
|
Standard-Blockgröße in Bytes. |
4628 |
Dies ist der Standardwert. |
Anmerkung:
Die BLKSIZE-Angabe gilt nur, wenn in der
JCL oder (nur bei z/OS) im Dataset-DCB keine Blockgröße vordefiniert
ist.
Mit LRECL=value bestimmen
Sie die Standard-Datensatzlänge des Dataset.
Mögliche Werte:
| Wert | Erklärung |
|---|---|
|
|
Datensatzlänge des Dataset in Bytes. |
0 |
Dies ist der Standardwert. |
Anmerkungen:
RECFM=V(B) enthält der
LRECL-Wert ein 4-Byte-Datensatz-Deskriptorwort.
LRECL=0 gilt folgendes: Bei
RECFM=V (B) nimmt LRECL den Standardwert
BLKSIZE-4 an. Bei RECFM=U nimmt
LRECL den Standardwert BLKSIZE an. Bei
RECFM=F (B) wird die maximale Datensatzlänge in dem momentan
ausgeführten Natural-Programm genommen, wenn die Datei geöffnet wird, z.B.
führt dies bei OPEN=INIT zu einem Fehler.
OPEN=INIT definiert
ist, muss ein ausreichend großer LRECL-Wert in der JCL
oder mit dem für die Datei definierten Subparameter
LRECL angegeben werden.
LRECL-Angabe gilt nur, wenn in
der JCL oder (nur bei z/OS) in der Dataset-DCB keine Datensatzlänge
vordefiniert ist.
Die folgenden Schlüsselwort-Subparameter stehen nur für
AM=STD in z/OS-Umgebungen
zur Verfügung:
REREAD |
FREE |
BUFNO |
DISP |
VMAX
Mit REREAD=value setzen
Sie die REREAD-Option für das Schließen der
Banddatei.
| Wert | Erklärung |
|---|---|
ON |
Die
REREAD-Option wird für CLOSE SVC gesetzt.
Damit wird das Volume repositioniert, um den Dataset erneut zu verarbeiten.
Dies ist der Standardwert. |
OFF |
Die
REREAD-Option wird für CLOSE SVC nicht
gesetzt.
|
Mit FREE=value bestimmen
Sie, ob die Zuordnung des Dataset aufgehoben wird, wenn die Datei geschlossen
wird.
| Wert | Erklärung |
|---|---|
ON |
Die FREE-Option
wird für CLOSE SVC gesetzt. Dadurch wird die Zuordnung des Dataset
aufgehoben, wenn er geschlossen wird (und nicht bei der Beendigung des
Schritts).
|
OFF |
Die FREE-Option
wird für CLOSE SVC nicht gesetzt.
Dies ist der Standardwert. |
Mit BUFNO=value legen Sie
die Standard-Anzahl der z/OS-E/A-Pufferspeicher des Dataset fest.
| Wert | Erklärung |
|---|---|
0 oder 1 -
255 |
Standard-Anzahl der z/OS-E/A-Pufferspeicher des Dataset. |
0 |
Bei BUFNO=0 weist z/OS
standardmäßig fünf E/A-Pufferspeicher zu.
Dies ist der Standardwert. |
Anmerkungen:
BUFNO-Angabe gilt nur, wenn der
BUFNO-Parameter nicht in der JCL für den Dataset angeben
ist.
Mit DISP=value geben Sie
an, dass die Arbeitsdatei zur Änderung geöffnet wird.
| Wert | Erklärung |
|---|---|
MOD |
Neue Datensätze werden am Ende der
Arbeitsdatei hinzugefügt.
Anmerkung: |
NOMOD |
Die Arbeitsdatei wird von Beginn an neu
geschrieben.
Dies ist der Standardwert. |
VMAX=value steuert die
LRECL-Einstellung für eine Ausgabedatei mit variablem
Datensatzformat (RECFM=V).
| Wert | Erklärung |
|---|---|
ON |
Vorausgesetzt, dass für die Datei ein
BLKSIZE-Wert existiert, der nicht Null ist, wird mit
VMAX=ON für variables Datensatzformat LRECL=BLKSIZE-4
gesetzt, unabhängig von der Einstellung in der DCB oder im
LRECL-Subparameter.
|
NAT |
LRECL wird auf
die Länge +4 des größten Datensatzes im Anwendungsprogramm
gesetzt, wenn dieser Wert kleiner ist als im LRECL in
der DCB für den Dataset.
|
OFF |
Es wird die
LRECL-Einstellung aus der DCB für den Dataset verwendet.
Dies ist der Standardwert. |
Die folgenden Schlüsselwort-Subparameter stehen nur für
AM=STD in z/VSE-Umgebungen
zur Verfügung:
SYSNR |
LABEL |
REWIND |
BLOCKS |
DISP
SYSNR=value bestimmt die
logische VSE SYS-Nummer.
| Wert | Erklärung |
|---|---|
1 - 99 |
Logische VSE SYS-Nummer.
Standardmäßig ist die SYS-Nummer identisch mit der Arbeitsdateinummer. |
LABEL=value bestimmt die
Verarbeitung der Bandkennzeichnung.
| Wert | Erklärung |
|---|---|
ON |
Das Band ist im
Standard-Bandkennzeichnungsformat.
Dies ist der Standardwert. |
OFF |
Das Band ist ohne Bandkennzeichnung mit vorderer Bandmarke. |
NOTM |
Das Band ist ohne Bandkennzeichnung mit vorderer Bandmarke. |
REWIND=value bestimmt die
beim Schließen der Datei durchzuführende Maßnahme.
| Wert | Erklärung |
|---|---|
ON |
Das Band wird beim Schließen der Datei
zurückgespult.
Dies ist der Standardwert. |
OFF |
Das Band wird beim Schließen der Datei nicht zurückgespult. |
UNLOAD |
Das Band wird beim Schließen der Datei entladen. |
Mit BLOCKS=value geben Sie
die Anzahl der Dateiblöcke oder Dateispuren, die für eine dynamische
NATVSE-Arbeitsdatei zugeordnet werden soll.
| Wert | Erklärung |
|---|---|
1 - 9999 |
Anzahl der zuzuordnenden Dateiblöcke oder Dateispuren. |
20 |
Dies ist der Standardwert. |
Siehe NATVSE Dynamic Work File Allocation (DYNALLOC) Support in der Operations-Dokumentation.
Mit
DISP=(value1,value2)
geben Sie die Disposition einer dynamischen NATVSE-Arbeitsdatei
an, die durch VSAM/SAM gesteuert wird.
| Wertepaar | Erklärung |
|---|---|
(NEW,KEEP) |
Die Datei soll beim OPEN
zurückgesetzt und beim CLOSE beibehalten werden.
Dies ist der Standardwert. |
(NEW,DELETE) |
Die Datei soll beim OPEN
zurückgesetzt und beim CLOSE unzugänglich gemacht werden.
|
(OLD,DELETE) |
Die Datei soll beim OPEN
nicht zurückgesetzt und beim CLOSE nicht unzugänglich gemacht
werden.
|
(OLD,KEEP) |
Die Datei soll beim OPEN
nicht zurückgesetzt und beim CLOSE nicht beibehalten werden.
|
Siehe NATVSE Dynamic Work File Allocation (DYNALLOC) Support in der Operations-Dokumentation.
Der folgende Schlüsselwort-Subparameter steht nur für
AM=STD in
BS2000-Umgebungen zur Verfügung:
DISP
DISP=value bestimmt den
Öffnungsmodus der Datei.
| Wert | Erklärung |
|---|---|
EXT |
Der Öffnungsmodus der Datei soll auf
EXTEND gesetzt werden.
|
NOEXT |
Der Öffnungsmodus der Datei soll auf
den Standardwert OUTPUT gesetzt werden.
Dies ist der Standardwert. |
Die folgenden Schlüsselwort-Subparameter stehen nur für
AM=CICS zur Verfügung:
TYPE=value gibt den zu
verwendenden Typ des CICS-Speichermediums an.
| Wert | Erklärung |
|---|---|
MAIN |
Temporärer Hauptspeicher. |
AUX |
Temporärer Hilfsspeicher. |
TD |
Transiente Daten. |
Der verwendet Standardwert hängt von der Einstellung des
Subparameters DEST ab. Wenn der Wert
des Subparameters DEST mit einer gültigen
transienten CICS-Datenwarteschlange übereinstimmt, nimmt der Subparameter
TYPE die Standard-Einstellung TD an,
andernfalls wird MAIN als Standard-Einstellung angenommen.
DISP=(value1,value2)
gibt die temporäre CICS-Speicherwarteschlangen-Disposition an.
| Wertepaar | Erklärung |
|---|---|
(NEW,KEEP) |
Die Speicherwarteschlange wird
gelöscht, wenn die Datei geöffnet wird.
Dies ist der Standardwert. |
(NEW,DELETE) |
Die Speicherwarteschlange wird gelöscht, wenn die Datei geöffnet und wenn sie geschlossen wird. |
(OLD,DELETE) |
Die Speicherwarteschlange wird gelöscht, wenn die Datei geschlossen wird. |
(OLD,KEEP) |
Die Speicherwarteschlange wird nicht gelöscht. |
Anmerkung:
Die DISP-Angabe gilt nicht für
CICS-Temporärdaten-Warteschlangen außerhalb der Partition.
Die folgenden Schlüsselwort-Subparameter stehen nur für
AM=COMP zur Verfügung:
TYPE=value gibt die zu
verwendende Art des Speicherzugriffs an.
| Wert | Erklärung |
|---|---|
SHR |
Gemeinsam genutzter Zugriff, d.h. auf die Arbeitsdatei können alle Benutzer zugreifen. |
TID |
Die Arbeitsdatei steht nur für die aktuelle Com-plete-Terminalkennung zur Verfügung. |
DYN |
Die Arbeitsdatei steht nur für die aktuelle Terminal-Stack-Ebene zur Verfügung. |
BLOCKS=value gibt die
Anzahl der zuzuweisenden Speicherblöcke an.
Mögliche Werte:
| Wert | Erklärung |
|---|---|
1 - 9999 |
Anzahl der zuzuweisenden Speicherblöcke. |
20 |
Dies ist der Standardwert. |
BLKSIZE=value gibt die
Größe der Speicherblöcke des Dataset an.
| Wert | Erklärung |
|---|---|
|
|
Größe der Speicherblöcke in Bytes. |
4628 |
Dies ist der Standardwert. |
Die folgenden Schlüsselwort-Subparameter stehen nur für
AM=SMARTS zur
Verfügung:
DEST=value gibt den Namen
der Arbeitsdatei an.
| Wert | Erklärung |
|---|---|
| 1 - 8 Zeichen. | Name der Arbeitsdatei. |
Anmerkungen:
DEST-Klausel auf maximal 8
Zeichen eingeschränkt ist, ist es nutzlos, eine Datei mit absoluter
PFS-Pfadangabe zu definieren.
DEST-Klausel angegebene
Name bezieht sich auf das Wurzelverzeichnis der Arbeitsdatei. Dieses
Verzeichnis wird mit der Umgebungsvariablen
NAT_WORK_ROOT angegeben.
DEFINE WORK
FILE verwendet werden.
TYPE=value gibt die zu
verwendende Art des Speicherzugriffs an.
| Wert | Erklärung |
|---|---|
BIN |
Jede Zeile wird ohne abschließendes
Zeilenendezeichen in die Arbeitsdatei geschrieben.
Dies ist der Standardwert. |
TXT |
Jede Zeile wird mit einem
abschließenden Zeilenendezeichen (x'15') in die Arbeitsdatei
geschrieben.
|
DISP=(value1,value2,value3)
gibt den Öffnungsmodus der Arbeitsdatei an.
| Wert | Erklärung | |
|---|---|---|
value1 |
value1 gibt an, ob eine
vorhandene Datei gelöscht werden soll oder ob neue Daten an die Datei angehängt
werden sollen.
|
|
NEW |
Eine vorhandene Datei wird gelöscht,
wenn die Datei zum Schreiben geöffnet wird.
Dies ist der Standardwert. |
|
OLD oder
MOD |
Neue Daten werden am Ende der Datei angehängt. | |
value2 |
value2 gibt an, ob eine
Datei nach dem Zugriff beibehalten oder entfernt werden soll.
|
|
KEEP |
Permanente Datei, die nach
dem Schließen beibehalten wird.
Dies ist der Standardwert. |
|
DELETE |
Temporäre Datei, die nach dem Schließen entfernt wird. | |
value3 |
value3 gibt an, ob ein
Benutzer exklusiven Zugang zur Datei hat oder nicht.
|
|
SHR |
Gemeinsam genutzter Zugang, d.h. die
Arbeitsdatei ist für alle Benutzer zugänglich.
Dies ist der Standardwert. |
|
OWN |
Exklusiver Zugang, die Arbeitsdatei ist für die aktuelle Com-plete-Benutzerkennung zugänglich. Dateien mit exklusivem Zugang befinden sich in einem zusätzlichen Verzeichnis, das den Namen der aktuellen Benutzerkennung. | |
DISP=(NEW,KEEP,SHR)
Wenn Sie nur den ersten Wert (mit oder ohne Klammern) angeben, wird den übrigen Werten jeweils die Standardeinstellung zugewiesen:
DISP=(MOD)
oder
DISP=MOD
Beide Angaben entsprechen der folgenden Angabe:
DISP=(MOD,KEEP,SHR)