Dieser Abschnitt behandelt folgende Themen:
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.
|
|||
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 aus dem Hold-Status 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 | 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:
|
|||
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
|
|||
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 |
|
NETWORK |
A10 | ein | Job-Netzwerk. | |
NETWORK-VERSION |
A10 | 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 | 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 |
I4 | Von Entire Operations verwendete Laufnummer. | ||
ein | Funktionen
A , H :
C ,
D , R ,
S :
X :
|
|||
aus | Funktionen
A , H :
|
|||
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
|
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
|
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.
Um einen Job oder ein Netzwerk zu aktivieren und bestimmte
Symbolwerte an diese Aktivierung weiterzugeben, fahren Sie wie folgt fort:
Aktivieren Sie das Netzwerk und behalten Sie es in Hold-Status
mit Funktion H
.
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
).
Nachdem Sie das(die) Symbol(e) gesetzt haben, geben Sie diese
Aktivierung mit Funktion R
frei.
Anmerkungen:
START-TIME
,
EARLIEST-START
(optional),
DEADLINE
(optional) werden vom Freigabeaufruf
R
(Release) genommen.
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. |