Automation Engine Script-Leitfaden > AE JCL für Anwendungen > SAP > BW_SET_CONSTRAINT

BW_SET_CONSTRAINT

Kriterium für den automatischen Wiederanlauf von Child-Prozessen einer Prozessketten setzen.

Syntax

BW_SET_CONSTRAINT

[TYPE=...]
[,NAME=
...]
,FIELD=... 
[,OPERATOR=...]
,VALUE=...
,ACTION=...
[,COUNT=...]
[,DELAY=...]

Syntax

Beschreibung/Format

TYPE=

Typ des Child-Prozesses
Format des Wertes: Script-Literal

Das Wildcardzeichen * kann ebenfalls verwendet werden (Platzhalter für beliebig viele Zeichen).

Beispiel: ABAP

NAME=

Name des Child-Prozesses.
Format des Wertes: Script-Literal

Die Wildcardzeichen * und ? (Platzhalter für ein beliebiges Zeichen) stehen ebenfalls zur Verfügung.

FIELD=

Stelle, die nach dem Wert (Parameter VALUE) durchsucht werden soll.
Format des Wertes: Script-Literal

Erlaubte Werte: "STATUS", "JOBLOG" oder "PROCESSLOG"

"STATUS" = Status des Child-Prozesses
JOBLOG = Jobprotokoll. Protokolle des Backgroundjobs
"PROCESSLOG" = Prozessprotokoll. Protokolle der Child-Prozesse

Beachten Sie, dass das Prozessprotokoll und Jobprotokoll nur durchsucht werden können, wenn dies für die aktivierte bzw. neu gestartete Prozesskette aktiviert wurde (Sprachmittel BW_ACTIVATE_CHAIN / BW_RESTART_CHAIN, Parameter JOBLOGS / PROCESSLOGS).

OPERATOR=

Operator für die Bedingung.
Format des Wertes: Script-Literal

Erlaubte Werte: "EQ" (Standardwert), "NE", "CP" oder "NP"

"EQ" = Entspricht (nur bei FIELD=STATUS)
"NE" = Entspricht nicht (nur bei FIELD=STATUS)
"CP" = Enthält Muster
"NP" = Enthält Muster nicht

VALUE=

Wert, nach dem gesucht werden soll.
Format des Wertes: Script-Literal

Wird auf den Status der Child-Prozesse geprüft (FIELD=STATUS) so sind folgende Werte möglich (entsprechen der Definition der RSPC_STATE Domain im SAP-System):

"X" = Abgebrochen
"R" = Fehlerhaft beendet
"G" = Erfolgreich beendet
"F" = Abgeschlossen
"A" = Aktiv
"P" = Geplant
"S" = Beim Wiederaufsetzen übergangen
"Q" = Freigegeben
"Y" = Bereit
"" = Undefiniert

ACTION=

Aktion, die für den Child-Prozess durchgeführt werden soll, der die Bedingung erfüllt.
Format des Wertes: Script-Literal

Erlaubte Werte: "RESTART" oder "ABEND"

"RESTART" = Wiederanlauf des entsprechenden Child-Prozesses durchführen
"ABEND" = Entsprechenden Child-Prozess abbrechen

COUNT=

Anzahl der Wiederanläufe, die für den zutreffenden Child-Prozess durchgeführt werden sollen (nur relevant bei ACTION=RESTART).
Format des Wertes: Zahl
Standardwert: 1

DELAY=

Zeit in Minuten, die zwischen mehreren Wiederanläufen gewartet werden soll (nur relevant bei ACTION=RESTART).
Format des Wertes: Zahl
Standardwert: 1

Beschreibung

Dieses Sprachmittel dient dazu, um einen automatischen Wiederanlauf für Child-Prozesse von Prozessketten durchzuführen.

Mit der Funktion legen Sie ein Kriterium fest Dieses setzt sich aus einer zu prüfenden Bedingung (zum Beispiel: Prüfung auf einen bestimmten Status) und einer durchzuführenden Aktion (Beispiel: Aufgabe abbrechen) zusammen. Für alle Child-Prozesse, die auf diese Bedingung zutreffen, wird die definierte Aktion durchgeführt.

Beispiele

Folgendes Beispiel zeigt die Definition eines Wiederanlauf-Kriteriums, wodurch alle abgebrochenen Child-Prozesse vom Typ "ABAP" deren Name mit "RSM" beginnt, bis zu 3 mal im Intervall von 5 Minuten automatisch neu gestartet werden.

BW_SET_CONSTRAINT NAME="RSM*",VALUE="X",OPERATOR="EQ",ACTION="RESTART",TYPE="ABAP",DELAY="5",COUNT="3"

Durch folgende Definition, werden alle ABAP Child-Prozesse, deren Name mit "RSM" beginnt, abgebrochen, wenn im Protokoll des Background-Jobs der Begriff error vorkommt.

BW_SET_CONSTRAINT NAME="RSM*",VALUE="error",OPERATOR="CP",ACTION="ABEND",TYPE="ABAP",DELAY="5",COUNT="3",SOURCE="JOBLOG"

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH