BW_SET_CONSTRAINT

Das Script-Element BW_SET_CONSTRAINT definiert das Verhalten für einen automatischen Neustart der untergeordneten Prozesse einer Prozesskette. Zu diesem Zweck legen Sie die Bedingungen und die resultierende Aktion fest. Beispielsweise könnten Sie einen bestimmten Status abfragen, und wenn die definierten Bedingungen erfüllt sind, könnte die Aktion, die ausgeführt werden sollte, darin liegen, dass die Aufgabe abgebrochen wird. Die definierte Aktion wird für alle untergeordneten Prozesse verarbeitet, die die definierten Bedingungen erfüllen.

Syntax

BW_SET_CONSTRAINT

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

Parameter

• BW_SET_CONSTRAINT
  Definiert das Neustartverhalten für untergeordnete Prozesse von Prozessketten

• TYPE=
  (Optional) Der Schritttyp des untergeordneten Prozesses. Das Wildcardzeichen * kann als Platzhalter für beliebig viele Zeichen verwendet werden.
  Format: Script-Literal
  Beispiel: ABAP

• NAME=
  (Optional) Der Name des untergeordneten Prozesses. Sie können die Wildcardzeichen * und ? als Platzhalter für ein Zeichen Ihrer Wahl verwenden.
  Format: Script-Literal

• FIELD=
  Ort, an dem der Wert (Parameter VALUE) gesucht werden soll.
  Format: Script-Literal
  Zulässige Werte:

  • STATUS
    Der Status des untergeordneten Prozesses
  • JOBLOG
    Job-Log. Logs des Hintergrund-Jobs
  • PROCESSLOG
    Prozess-Log. Logs der Child-Prozesse
  Hinweis: Um im Prozess-Log und im Job-Log suchen zu können, müssen Sie diese Einstellung für die aktivierte und neu gestartete Prozesskette mit den Parametern JOBLOGS/PROCESSLOGS der Script-Elemente BW_ACTIVATE_CHAIN bzw. BW_RESTART_CHAIN aktivieren.

• OPERATOR=
  (Optional) Der Operator für die Bedingung
  Format: Script-Literal
  Zulässige Werte:

  • EQ (Standardwert)
    Gleich (wird nur mit dem Parameter FIELD=STATUS kombiniert)
  • NE
    Ungleich (wird nur mit dem Parameter FIELD=STATUS kombiniert)
  • CP
    Enthält Muster
  • NP
    Enthält kein Muster

• VALUE=
  Der zu suchende Wert
  Format: Script-Literal
  Wenn Sie den Status von untergeordneten Prozessen (FIELD=STATUS) prüfen, können Sie die folgenden Werte verwenden, die der RSPC_STATE Domänendefinition im SAP-System entsprechen:

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

• ACTION=
  Aktion, die für den Child-Prozess durchgeführt werden soll, der die Bedingung erfüllt.
  Format: Script-Literal
  Zulässige Werte:

  • RESTART
    Neustart des entsprechenden Child-Prozesses durchführen
  • ABEND
    Entsprechenden Child-Prozess abbrechen

• COUNT=
  (Optional) Die Anzahl der Neustarts, die für den relevanten Child-Prozess vorgenommen werden sollten. Verwenden Sie diesen Parameter nur kombiniert mit dem Parameter ACTION=RESTART.
  Format: Zahl
  Standardwert: 1

• DELAY=
  (Optional) Das Zeitintervall, das das System zwischen mehreren Neustarts warten sollte (Minuten). Verwenden Sie diesen Parameter nur kombiniert mit dem Parameter ACTION=RESTART.
  Format: Zahl
  Standardwert: 1
  
  

Beispiele

Folgendes Beispiel zeigt die Definition von Neustart-Bedingungen, 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 Log 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"