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.

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

Bedeutung der Parameter:

Parameter Format Verwendung
FUNCTION A01 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: Master-Netzwerk 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 Ende-Zeit 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 Ende-Zeit 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 N03 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=.
121 Eigentümer existiert nicht.
122 Job-Netzwerk-Version ist erforderlich.
901 Ok; Unternetzwerk-Symboleingabe.
DBENV A10 ein Datenbankumgebung (für zukünftige Verwendung).
OWNER A10 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 ein Job-Netzwerk.
NETWORK-VERSION A10 ein Versionsname des Job-Netzwerks oder current.
JOB A10 ein Job. Wenn leer, wird das ganze Job-Netzwerk aktiviert, deaktiviert, bzw. getestet.
SYMTAB A10 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 - 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 I04   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.

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 eine zurückgegebene Laufnummer, um Symbole in der(n) Aktiven Symboltabelle(n) für diesen Lauf zu setzen. Sie müssen den Exit NOPUSY6N 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.

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 nutzen, in denen aktuell kein Job ausgeführt wird.