DEFINE-JOB-STREAM - Streamdefinitionen in die Datei SJMSFILE schreiben

Mit dieser Anweisung wird eine neue Streamdefinition in die Datei SJMSFILE bzw. JMS-Datenbasis geschrieben.

Format

DEFINE-JOB-STREAM                                                                                                                                  

NAME = <name 1..8>
,FILE = <filename 1..54> / *LIBRARY-ELEMENT(...)
	*LIBRARY-ELEMENT(...)
		|	LIBRARY = <filename 1..41>
		|	,ELEMENT = <name 1..8>
,RUN-PRIORITY = 65 / <integer 30..255>
,DEFAULT = *NO / *YES
,START = *AT-LOAD / *BY-OPERATOR / *AT(...) / *EARLIEST(...)
	*AT(...)
		|	TIME = <time 1..8>
	*EARLIEST(...)
		|	TIME = <time 1..8>
,STOP = *AT-SHUTDOWN / *BY-OPERATOR / *AT(...) / *AFTER(...)
	*AT(...)
		|	TIME = 00:00 / <time 1..8>
	*AFTER(...)
		|	HOURS = 00 / <integer 0..23>
		|	,MINUTES = 00 / <integer 0..59>
,STREAM-PARAMETER = *NO / <c-string 1..127>

Operanden

NAME = <name 1..8>
Ist der Name der Streamdefinition, die in die Datei SJMSFILE geschrieben werden soll. Es kann eine Folge von 1 bis 8 alphanumerischen Zeichen angegeben werden, die mit den Zeichen A-Z, @ oder # beginnen muss.

FILE = <filename 1..54>
Ist der Name der ENTER-Datei, die den Auftrag enthält, der während des Streamstarts eingeleitet wird und den Jobscheduler aktiviert.
Der Jobscheduler kann nur Batch-Aufträge bearbeiten.

 

FILE = *LIBRARY-ELEMENT(...)

LIBRARY = <filename 1..41>
Dateiname der Bibliothek

ELEMENT = <name 1..8>
Das Bibliothekselement, das die oben genannte ENTER-Datei enthält.

RUN-PRIORITY = 65 / <integer 30..255>
Gibt die Anfangspriorität an, die der Streamtask zugeordnet werden soll, unter der der Jobscheduler läuft.

DEFAULT = *NO / *YES
Gibt an, ob der betreffende Stream der Standardstream für das System sein soll. YES bedeutet, der Stream soll der Standardstream für Auftragsklassen sein, die angegeben haben, dass sie den Standardstream benutzen wollen.

START =
Gibt an, wann der Stream gestartet werden soll.

START = *AT-LOAD
Der Stream soll automatisch beim Laden des Systems gestartet werden.

START = *BY-OPERATOR
Der Stream muss von der Systembetreuung mit /START-JOB-STREAM gestartet werden.

START = *AT(...)
Bei jedem Systemlauf soll der Stream automatisch zu der angegebenen Zeit gestartet werden. Wenn ein Systemlauf nach der angegebenen Zeit gestartet wird, kann der Stream nur innerhalb der nächsten 30 Minuten nach der angegebenen Zeit gestartet werden. Ein Start zu einem späteren Zeitpunkt ist im aktuellen Systemlauf nicht möglich.

Falls der Jobstream in die JMS-Datenbasis eingebracht wird, gilt: Wenn der START-Zeitpunkt um nicht mehr als 5 Minuten überschritten und der STOP-Zeitpunkt noch nicht erreicht ist, so wird der Stream gestartet.

START = *EARLIEST(...)
Bei jedem Systemlauf soll der Stream frühestens automatisch zu der angegebenen Zeit gestartet werden. Ist das System zum angegebenen Zeitpunkt nicht aktiv, wird der Start bis zu einem evtl. angegebenen STOP-Zeitpunkt oder bis 24:00 Uhr nachgeholt.

Falls der Jobstream in die JMS-Datenbasis eingebracht wird, gilt: Wenn der START-Zeitpunkt überschritten und der STOP-Zeitpunkt noch nicht erreicht ist, wird der Stream gestartet.

TIME = 00:00 / <time 1..8>
Ist die Uhrzeit, Angabe nur in hh:mm, Stunden und Minuten, Sekunden werden ignoriert.

STOP =
Gibt an, wann der Stream gestoppt werden soll.

STOP = *AT-SHUTDOWN
Der Stream soll beim Herunterfahren des Systems gestoppt werden.

STOP = *BY-OPERATOR
Der Stream muss von der Systembetreuung mit /STOP-JOB-STREAM gestoppt werden.

 

STOP = *AT(...)
Der Stream soll automatisch zu der angegebenen Zeit gestoppt werden (hh:mm siehe bei START=*AT...).

TIME = 00:00 / <time 1..8>
Ist die Uhrzeit, Angabe nur in hh:mm, Stunden und Minuten, Sekunden werden ignoriert.

STOP = *AFTER(...)
Der Stream soll nach seinem Start nach Ablauf der angegebenen Zeit gestoppt werden.

HOURS = 00 / <integer 0..23>
Für HOURS= können 0 bis 23 Stunden angegeben werden.

MINUTES = 00 / <integer 0..59>
Es können 0 bis 59 Minuten angegeben werden.

Falls das System aus irgendeinem Grund in der Zeit zwischen dem Systemstart und der Zeit, die für das Stoppen des Streams angegeben war, heruntergefahren wird, so wird, falls das System noch vor der Stoppzeit des Streams erneut hochgefahren wird, auch der Stream automatisch neu gestartet.

STREAM-PARAMETER =
Dieser Operanden definiert für den Jobscheduler spezielle Scheduling-Parameter in freier Syntax. Der Inhalt dieses Operanden wird nicht vom System ausgewertet.
Der betroffene Jobscheduler muss aber sowohl die Syntax als auch die Bedeutung von STREAM-PARAMETER kennen, um auf die dort definierten Scheduling-Parameter einzugehen.
Diese Informationen besorgt sich der Jobscheduler über die Jobscheduler-Schnittstelle. Die Jobscheduler-Schnittstelle stellt über eine TU-Schnittstelle Funktionen zur Verfügung, die der Jobscheduler zur Durchführung seiner Aufgaben benötigt (näheres siehe Handbuch „Systembetreuung“ [5]).

STREAM-PARAMETER = <c-string 1..127>
Ist die Folge von zusätzlichen Parametern, die vom Jobscheduler ausgewertet werden. Beim Hochfahren des Systems werden die in den Parametern enthaltenen Informationen in interne Tabellen übernommen, aus denen der Jobscheduler die Informationen abfragt.

Der Standard-Jobscheduler kennt folgende Parameter:

S-PAR =  'JOB-PRIORITY = YES / NO

          ,CPU-TIME = NO / YES

          ,WAIT-TIME = NO / YES
          ,JOB-QUOTA = 1 / <integer 1..255>

          ,LOGGING = YES / NO

          ,CATID-LIST = (catid1,...)
          ,CAT-TIME = min'

STREAM-PARAMETER = *NO
Bedeutet, es werden keine speziellen Parameter für den Jobscheduler definiert.

Hinweise

• Die Anweisung wird zurückgewiesen, wenn ein Stream mit dem angegebenen Namen in der SJMSFILE bereits enthalten ist.

• Es darf nur ein Standardstream im System existieren. Der Versuch, mehrere Standardstreams zu definieren, wird abgewiesen.

• Es dürfen maximal 16 Streams definiert werden.