Die Parameter für z/VSE Batch können als Subparameter des Profilparameters VSEP oder des Makros NTVSEP angegeben werden.

Mögliche Werte	Siehe VSEP-Parameter-Syntax.
Standard-Einstellung	Siehe Standardwerte der Schlüsselwort-Subparameter.
Dynamische Angabe	ja
Angabe innerhalb der Session	nein

Dieses Dokument behandelt folgende Themen:

• VSEP-Parameter-Syntax

• NTVSEP-Macro-Syntax

• Schlüsselwort-Subparameter

• Beispiel für VSEP-Parameter

• Beispiel für NTVSEP-Macro

---

VSEP-Parameter-Syntax

Der Profilparameter wird wie folgt angegeben:

VSEP=(keyword-subparameter=value,keyword-subparameter=value,...)

Der Profilparameter VSEP umfasst eine Untermenge der Subparameter, die beim Makro NTVSEP zur Verfügung stehen. Folgende Schlüsselwort-Subparameter stehen bei VSEP zur Verfügung:

CANCEL | FILMNGR | FILSCAN | FLUSH | MAXABND | RCSIZE | RJEUSER | SEGMENT | TIOBSZ | USERID

Subparameter-Beschreibungen siehe Schlüsselwort-Subparameter.

NTVSEP-Macro-Syntax

Das Makro NTVSEP wird wie folgt angegeben:

         NTVSEP CANCEL=value,                                          *
               FILEID=value,                                           *
               FILMNGR=value,                                          *
               FILSCAN=value,                                          *
               FLUSH=value,                                            *
               LIBRID=value,                                           *
               MAXABND=value,                                          *
               RCSIZE=value,                                           *
               RJEUSER=value,                                          *
               SEGMENT=value,                                          *
               SPOOLID=value,                                          *
               TIOBSZ=value,                                           *
               USERID=value,                                           *
               WAITIME=value

Subparameter-Beschreibungen siehe Schlüsselwort-Subparameter.

Schlüsselwort-Subparameter

CANCEL | FILEID | FILMNGR | FILSCAN | FLUSH | LIBRID | MAXABND | RCSIZE | RJEUSER | SEGMENT | SPOOLID | TIOBSZ | USERID | WAITIME

CANCEL - Abbruch eines Natural-Jobs beim Beenden der Session

CANCEL=value gibt an, wie das Natural z/VSE Interface beim Beenden der Session vorgeht.

Wert	Erklärung
ON	Das Natural z/VSE Interface bricht den Natural Batch Job ab, falls beim Beenden der Session ein Fehler auftritt. Der Job wird nicht abgebrochen im Falle einer Beendigungsnachricht NAT9995 oder wenn der Benutzer die Session mit einem Natural-TERMINATE-Statement beendet.
OFF	Das Natural z/VSE Interface übergibt beim Beenden der Session immer einen Rückgabecode. Dies ist der Standardwert.

FILEID - Zeichenkette zum Ignorieren der z/VSE-Kennsatzinformation

Mit FILEID=value geben Sie eine Zeichenkette an, die gegen den Anfang einer DLBL- oder TLBL-Dateikennung abgeprüft wird.

Wert	Erklärung
Zeichenkette mit maximal 8 Zeichen.	Beliebige Zeichenkette, die in Hochkommas gesetzt werden muss, wenn sie Sonderzeichen enthält.
IGNORE	Dies ist der Standardwert.

Anmerkungen:

1. Dieser Subparameter kann nur im Makro NTVSEP angegeben werden. Er kann nicht dynamisch mit dem Profilparameter VSEP angegeben werden.
2. Bei Übereinstimmung wird diese Kennsatzinformation (Label) ignoriert. Dies besonders dann von Nutzen, wenn in den (Partitions-)Standard-Labels DLBL- oder TLBL-Statements für CMWKFnn* und/oder CMPRTnn* geliefert werden, aber nicht benutzt werden sollen.
3. Wenn beispielsweise ein // DLBL CMPRT01,'...'-Statement gefunden wird, ist es nicht möglich, eine WRITE(1)-Ausgabe an ein Drucker-SPOOL-System zu leiten. Dazu benutzen Sie das JCS-Statement // DLBL CMPRT01,'IGNORE' und eine geeignete Druckerzuordnung des relevanten SYSnnn.

FILMNGR - Verwaltung der Druck- oder Arbeitsdatei in Natural

Mit FILMNGR=value geben Sie an, wie eine Druck- oder Arbeitsdatei in Natural verwaltet werden soll.

Wert	Erklärung
ON	Die Tatsache, dass eine Kennsatzinformation (Label) für eine Druck- oder Arbeitsdatei gibt, und die Tatsache, dass LABEL=ON oder LABEL=OFF für eine Arbeitsdatei ohne Kennsatzinformation angegeben ist, zeigt für Natural an, dass diese Datei zur Verfügung steht. Dies ist besonders relevant, wenn die Natural-Druck- oder Arbeitsdateien von einem Dateiverwaltungssystem verwaltet werden.
OFF	Die logische Einheitnummer der Natural-Druck- oder Arbeitsdatei muss dem geeigneten Gerätetyp zugeordnet werden. Dies ist der Standardwert.

FILSCAN - Suche in Druck- oder Arbeitsdateien

Mit FILSCAN=value geben Sie an, ob Druck- oder Arbeitsdateien durchsucht werden sollen.

Wert	Erklärung
ON	Das Natural z/VSE Interface durchsucht den z/VSE-Kennsatzinformationsbereich (Label) nach allen Natural-Druck- oder Arbeitsdateien, für die keine spezifische Dateizugriffsmethode über Natural-Profilparameter angegeben worden ist, denn dies kann Mehraufwand verursachen. Dies ist der Standardwert.
OFF	Der Zugang zu allen Natural-Druck- und Arbeitsdateien muss explizit über Natural-Profilparameter angegeben werden, damit sie zur Verfügung stehen. Dadurch werden alle Dateizugangsaufwände auf die definierten Dateien konzentriert.

FLUSH - Flush-Abschluss für Karteneingabedateien

Mit FLUSH=value geben Sie an, wie das Natural z/VSE Interface beim Beenden der Session mit den Karteneingabedateien CMSYNIN/CMOBJIN umgehen soll.

Wert	Erklärung
ON	Beim Beenden der Session liest das Natural z/VSE Interface die Karteneingabedatei SYSIN/SYSRDR/SYSIPT bis zum Dateiende (EOF), wenn Natural kein EOF vorgefunden hat; d.h., wenn die Natural Batch Session vollständig mit Stack-Daten gesteuert wird, muss in der JCL zusätzlich ein "/*" für eine CMSYNIN/CMOBJIN-Null-Datei vorgesehen werden. Dies ist der Standardwert.
OFF	Es ist keine zusätzliche CMSYNIN/CMOBJIN-Karteneingabe-(Null-)Datei erforderlich, wenn die Natural Batch Session vollständig mit Stack-Daten gesteuert wird; die SYSIN/SYSRDR/SYSIPT-Karteneingabedatei wird dann unverändert gelassen, was möglicherweise INVALID STATEMENT-Operator-Aufforderungen oder einen Job-Abbruch wegen des INVALID STATEMENT zur Folge hat, wenn die Natural-CMSYNIN/CMOBJIN-Dateien noch nicht vollständig abgerufen worden waren.

LIBRID - Zeichenkette zum Auslösen des Trigger z/VSE Library-Zugangs

Mit LIBRID=value geben Sie eine Zeichenkette an, die gegen den Anfang einer DLBL-Dateikennung geprüft werden. Bei Übereinstimmung wird die restliche Dateikennung nach Informationen durchsucht, die ein Library Member in einer z/VSE Library oder Library-Kette angeben.

Wert	Erklärung
Zeichenkette mit maximal 8 Zeichen.	Beliebige Zeichenkette, die in Hochkommas gesetzt werden muss, wenn sie Sonderzeichen enthält.
LIBR:	Dies ist der Standardwert.

MAXABND - Maximale Anzahl Abbrüche

Mit MAXABND=value geben Sie die maximale Anzahl der Abbrüche (Abends) an, die NATVSE tolieriert (d.h., NATVSE fängt die Abbrüche ab und ruft den Natural Abend Handler auf), bevor NATVSE von einer nicht wiederherstellbaren Abbruchsituation oder einer Abbruchschleife ausgeht und selbst die Natural-Session beendet.

Wert	Erklärung
Numerisch.	Maximale Anzahl Abbrüche.
16	Dies ist der Standardwert.

RCSIZE - Standardgröße des Roll Cache für eine Server-Umgebung

Mit RCSIZE=value geben Sie die Standardgröße des Roll Cache für eine Server-Umgebung für den Fall an, dass die Roll Cache-Größe nicht mit der Umgebungsinitialisierungsanforderung übergeben wird.

Wert	Erklärung
Numerisch.	Standardgröße des Roll Cache in KB.
0	Dies ist der Standardwert.

RJEUSER - Benutzerkennung für Start per XPCC Makroanforderung

RJEUSER=value definiert, welche Benutzerkennung für den Start per XPCC Makroanforderungen gesetzt werden soll.

Wert	Erklärung
ON oder (ON,VSE)	Der Inhalt der Systemvariablen *INIT-USER wird als zwingend erforderliche Start-Benutzerkennung verwendet. RJEUSER=ON ist der Standardwert.
(ON,NAT)	Der Inhalt der Systemvariablen *USER wird als zwingend erforderliche Start-Benutzerkennung verwendet.
OFF	Die Benutzerkennung R000 wird verwendet.

SEGMENT - Verhalten beim Schließen der Ausgabe-SPOOL-Datei

Mit SEGMENT=value geben Sie an, wie sich das Natural z/VSE Interface beim Schließen einer Ausgabe-SPOOL-Datei (Drucken oder Lochen) verhalten soll.

Wert	Erklärung
ON	Gleichzeitig mit dem Schließen einer Datei wird ein POWER-Segment geschlossen, falls für diese Datei nicht die Einstellung CLOSE=FIN wirksam ist.
OFF	Beim Schließen der Spool-Datei wird das POWER-Segment nicht geschlossen. Dies ist der Standardwert.

SPOOLID - Zeichenkette zum Auslösen des direkten POWER SPOOL-Zugangs

Mit SPOOLID=value geben Sie eine Zeichenkette an, die gegen den Anfang der DLBL-Dateikennung eines DEFINE PRINTER- oder DEFINE WORK FILE-Statements geprüft wird.

Wert	Erklärung
Zeichenkette mit maximal 8 Zeichen.	Beliebige Zeichenkette, die in Hochkommas gesetzt werden muss, wenn sie Sonderzeichen enthält. Bei Übereinstimmung wird die Ausgabe unter Benutzung der POWER SPOOL-Zugangsdienste direkt an POWER übergeben.
SPL2PWR	Dies ist der Standardwert.

TIOBSZ - Größe des Natural-Ein-/Ausgabepufferspeichers

Mit TIOBSZ=value geben Sie die Größe des Natural-Ein-/Ausgabepufferspeicherbereichs an, der für alle Eingabe- und Ausgabeoperationen benutzt wird.

Wert	Erklärung
Minimal 8.	Größe des Natural-Ein-/Ausgabepufferspeichers in KB.
8	Dies ist der Standardwert.

USERID - Inhalt der Systemvariablen *INIT-USER

Mit USERID=value geben Sie den Inhalt der Systemvariablen *INIT-USER an.

Wert	Erklärung
ON	Es gilt folgende Logik: Wenn eine z/VSE-Benutzerkennung in der JCL angegeben wird (// ID USER=xxx), dann wird diese Benutzerkennung genommen; andernfalls, wenn in der JCL ein POWER from-user angegeben wird (* $$ JOB FROM=xxx), wird diese Benutzerkennung genommen; andernfalls wird der VSE-Job-Name als Natural-Benutzerkennung genommen.
OFF	Der VSE-Job-Name als Natural-Benutzerkennung genommen. Dies ist der Standardwert.

WAITIME - Zeitbegrenzung für das Ausspeichern der Session

Mit WAITIME=value geben Sie eine Zeitbegrenzung in Millisekunden an.

Wert	Erklärung
Numerisch.	Zeitbegrenzung in Millisekunden.
1000	Dies ist der Standardwert.

Anmerkungen:

1. Dieser Subparameter gilt für den CMROLL-Aufruf in einer Natural-Server-Umgebung: Ist der mit dem CMROLL-Aufruf übergebene Zeitintervall nicht kleiner als der WAITIME-Intervall ist, wird die Session ausgespeichert und der Thread wird freigegeben, während die Session wartet.
2. Dieser Subparameter kann nur im Makro NTVSEP angegeben werden. Er kann nicht dynamisch mit dem Profilparameter VSEP angegeben werden.

Beispiel für VSEP-Parameter

VSEP=(FILMNGR=OFF,FILSCAN=OFF,FLUSH=ON,RJEUSER=(ON,NAT),SEGMENT=ON,USERID=ON)

Beispiel für NTVSEP-Macro

         NTVSEP FLUSH=ON,                                              *
               FILEID=IGNORE,                                          *
               FILMNGR=OFF,                                            *
               FILSCAN=ON,                                             *
               LIBRID='LIBR:',                                         *
               MAXABND=16,                                             *
               RCSIZE=0,                                               *
               RCSIZE=0,                                               *
               RJEUSER=ON,                                             *
               SEGMENT=OFF,                                            *
               SPOOLID='SPL2PWR',                                      *
               TIOBSZ=8,                                               *
               USERID=OFF,                                             *
               WAITIME=1000