NOPUAC5N - Job-Netzwerke oder Jobs aktivieren

Dieser Abschnitt behandelt folgende Themen:


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.

Benutzen Sie dazu:

CALLNAT 'NOPUAC5N'
    FUNCTION RC OWNER NETWORK NETWORK-VERSION JOB SYMTAB  SYMTAB-VERSION 
    START-TIME RUN [8X] [LATEST-START] [DEADLINE]

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.

Siehe Aktivierung mit Symbol-Änderung.

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 aus dem Hold-Status freigeben.

Siehe Aktivierung mit Symbol-Änderung.

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.

11 Ungültiger Zeitrahmen.

Einer oder mehrere der folgenden Fälle sind eingetreten:

  • Die bei P-LATEST-START angegebene späteste Startzeit liegt vor der Startzeitangabe bei P-START-TIME.

  • Die bei P-DEADLINE angegebene Endezeit liegt vor der Startzeitangabe bei P-START-TIME oder der bei P-LATEST-START angegebenen spätesten Startzeit.

12 Ungültiger Aktivierungsursprung.

Dieser Rückgabecode darf nur bei internen Aufrufen der API 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.

8X OPTIONAL   Platzhalter für 8 Parameter, die für den internenen Gebrauch in Entire Operations bestimmt sind.

Diese Angabe ist erforderlich, wenn Sie einen oder mehrere der folgenden Parameter übergeben wollen.

LATEST-START T

OPTIONAL

ein Falls angegeben:

Das Feld muss sowohl das Datum als auch die Zeit enthalten.

Für den aktivierten Lauf hat die hier übergebene späteste Startzeit Vorrang vor allen anderen Definitionen auf Job- oder Netzwerkebene.
DEADLINE T

OPTIONAL

ein Falls angegeben:

Das Feld muss sowohl das Datum als auch die Zeit enthalten.

Für den aktivierten Lauf hat die hier übergebene Endezeit Vorrang vor allen anderen Definitionen auf Job- oder Netzwerkebene.

Anmerkung:
Sie können diese Funktion sowohl außerhalb von Entire Operations als aus von User Exits innerhalb von Entire Operations benutzen. Diese Funktion ist mit der manuellen Aktivierung von Netzwerken oder Jobs im Entire Operations Online-System vergleichbar.

Aktivierung mit Symbol-Änderung

Beginn der AnweisungslisteUm 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 die zurückgegebene Laufnummer, um Symbole in der(n) aktiven Symboltabelle(n) für diesen Lauf zu setzen. Sie müssen die API-Routine 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.

    Anmerkungen:

    1. Die Parameter START-TIME, EARLIEST-START (optional), DEADLINE (optional) werden vom Freigabeaufruf R (Release) genommen.
    2. 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.

Warnung:
Sie sollten vorsichtig sein, wenn für die Funktion T die API NOPUAC5N für ein Netzwerk aufgerufen wird, in dem Jobs bereits ausgeführt werden. Diese werden nicht wiederholt. Wir empfehlen, diese API-Funktion nur für aktive Netzwerke zu benutzen, in denen zurzeit kein Job ausgeführt wird.