Dieser Abschnitt behandelt folgende Themen:

• Aktivierung von Jobs oder Job-Netzwerken veranlassen

• Aktivierung mit Symbol-Änderung

• Wiederholung eines aktiven Netzwerkes

---

Aktivierung von Jobs oder Job-Netzwerken veranlassen

Sie können Job-Netzwerke oder Jobs aus Ihrer Natural-Anwendung heraus aktivieren. Das Netzwerk der Job-Definitionen muss in Entire Operations existieren.

CALLNAT 'NOPUAC5N'
  FUNCTION RC DBENV OWNER NETWORK NETWORK-VERSION JOB SYM-TAB SYM-TAB-VERSION START-TIME RUN

Bedeutung der Parameter:

Parameter	Format/Länge	Verwendung
FUNCTION	A1	ein	Funktions-Code:
			A	Aktivieren, kein Hold für Symbole.
			1	Wie A, jedoch Zeitrahmen wird wie im Zeitplan angegeben berücksichtigt.
			C	Startzeit ändern.
			D	RUN > 0: Netzwerk deaktivieren. RUN = -1: Netzwerk-Definition löschen.
			H	Aktivieren, aber Task in Hold-Status setzen bis zur Freigabe.
			I	Laufnummer-Anfangswert setzen. Der nächste Netzwerk-Lauf wird die nächste verfügbare Laufnummer nach der eingegebenen Nummer verwenden. Die Laufnummer muss zwischen 0 und der höchsten erlaubten Laufnummer liegen.
			J	Die früheste Startzeit, spätestete Startzeit und die Endezeit eines aktiven Jobs ändern. Die drei Zeitmarken werden mit demselben Versatz verschoben.
			K	Nur die früheste Startzeit eines aktiven Jobs ändern. Die späteste Startzeit und die Endezeit werden nicht geändert.
			R	Aktivierung freigeben.
			2	Wie R, der Zeitrahmen wird jedoch wie im Zeitplan angegeben berücksichtigt.
			S	Wiederholung eines aktiven Jobs.
			T	Wiederholung eines aktiven Netzwerks.
			X	Nur Existenz-Prüfung für Netzwerk oder Job.
RC	N4 BY VALUE RESULT	aus	Rückgabe-Code:
			0	Ok
			1	Eigentümer, Netzwerk, Job nicht gefunden.
			2	Aktivierungs-Eintragung nicht gefunden.
			3	Netzwerk nicht aktiv.
			4	Job kann nicht erneut gestartet werden. Bei der Funktion S (Wiederholung) wird dieser Rückgabe-Code ausgegeben, wenn gerade ein SYSOUT-Kopiervorgang läuft.
			5	Laufnummer wird bereits verwendet.
			6	Laufnummer nicht im zulässigen Bereich.
			7	Keine freie Laufnummer vorhanden.
			8	Aktive Objekte existieren.
			9	Aktuelle Version konnte nicht bestimmt werden.
			10	Standard-Versions-Verwendung gefunden. Dieser Rückgabecode kann bei einem Löschversuch ausgegeben werden.
			101	Ungültiger Funktions-Code.
			102	Parameter fehlen.
			111	Symboltabellen-Name enthielt reserviertes Präfix =EOR=.
			120	Eigentümer darf nicht verwendet werden. Betrifft z.B. den reservierten Eigentümer WASTEBIN.
			121	Eigentümer existiert nicht.
			122	Job-Netzwerk-Version ist erforderlich.
			901	Ok; Unternetzwerk-Symboleingabe.
DBENV	A10 BY VALUE OPTIONAL	ein	Datenbankumgebung (für zukünftige Verwendung)
OWNER	A10 BY VALUE	ein	Eigentümer des Job-Netzwerkes. Wenn ein Job mit der Funktion H in den Hold-Zustand gesetzt wird, so wird dies im Protokoll vermerkt.
NETWORK	A10 BY VALUE	ein	Job-Netzwerk.
NETWORK-VERSION	A10 BY VALUE OPTIONAL	ein	Versionsname des Job-Netzwerks oder (current) (siehe Reservierte Versionsnamen für Netzwerke).
JOB	A10	ein	Job. Wenn leer, wird das ganze Job-Netzwerk aktiviert, deaktiviert bzw. getestet.
SYMTAB	A10 BY VALUE OPTIONAL	ein	Eine spezielle Symboltabelle, die für diese Aktivierung zu verwenden ist Wenn leer, wird die Symboltabelle aus der Netzwerk- oder Job-Definition verwendet.
SYMTAB-VERSION	A10 BY VALUE OPTIONAL	-	Version der Symboltabelle.
START-TIME	T	ein	Wenn Null (0), wird das Netzwerk sofort aktiviert. Sonst wird das Netzwerk zum vorgesehenen Zeitpunkt aktiviert. Das Feld muss sowohl ein Datum als auch die Zeit enthalten.
		aus	Tatsächlich gesetzte Startzeit.
RUN	I4 BY VALUE RESULT		Von Entire Operations verwendete Laufnummer.
		ein	Funktionen A, H: Bei Einzeljob-Aktivierung kann eine existierende Laufnummer angegeben werden. Dies sollte nur für Nach-Aktivierungen zu einem aktiven Netzwerk verwendet werden. Funktionen C, D, R, S: muss eine existierende Laufnummer des Job-Netzwerks sein. Funktion X: Falls 0, wird das Master-Netzwerk getestet. Sonst wird ein aktives Netzwerk mit dieser Laufnummer getestet.
		aus	Funktionen A, H: Falls 0, wird die nächste freie Laufnummer zugeteilt. Falls nicht 0, wird diese Laufnummer verwendet; ist diese noch aktiv, wird die nächste freie Nummer in aufsteigender Folge zugeteilt.

Aktivierung mit Symbol-Änderung

Um einen Job oder ein Netzwerk zu aktivieren und bestimmte Symbolwerte an diese Aktivierung weiterzugeben, fahren Sie wie folgt fort:

1. Aktivieren Sie das Netzwerk und behalten Sie es in Hold-Status mit Funktion H.

2. Benutzen Sie eine zurückgegebene Laufnummer, um Symbole in der(n) Aktiven Symboltabelle(n) für diesen Lauf zu setzen. Sie müssen den Exit NOPUSY7N aufrufen (siehe Auf Entire Operations Symbole zugreifen ).

3. Nachdem Sie das(die) Symbol(e) gesetzt haben, geben Sie diese Aktivierung mit Funktion R frei.

   Anmerkung:
   Aktive Symbole, die hier gesetzt werden, werden nicht durch eine spätere komplette Symboltabellen-Aktivierung überschrieben.

Wiederholung eines aktiven Netzwerkes

Das Feld P-JOB kann leer bleiben.

• Wenn P-JOB leer ist, werden alle ausgeführten Jobs des aktiven Netzwerkes wiederholt.

• Wenn P-JOB einen validen Job-Namen enthält, wird das aktive Netzwerk wiederholt, aber der entsprechende Job wird als "Dummy wegen Wiederholung" wiederholt.

Die Wiederholung funktioniert auch korrekt für Jobs vom Typ NET: Auch Unternetzwerke werden mit ihrer originalen Laufnummer wiederholt.

Die Bedingungen NET-BEGIN, NET-END, NET-END-NOTOK werden vor der Wiederholung zurückgesetzt.

Diese API-Funktion ermöglicht es Ihnen, das gesamte aktive Netzwerk, inclusive der Unternetzwerke zu wiederholen. Aktive Bedingungen, die schon gesetzt oder zurückgesetzt sind, werden nicht beachtet.