NOPUAC5N - Job-Netzwerke oder Jobs aktivieren

#### Search Results

Search

# NOPUAC5N - Job-Netzwerke oder Jobs aktivieren

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.

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

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 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.

### On this page

- Aktivierung von Jobs oder Job-Netzwerken veranlassen
- Aktivierung mit Symbol-Änderung
- Wiederholung eines aktiven Netzwerkes