BW_ACTIVATE_CHAIN

Verwenden Sie das Script-Element BW_ACTIVATE_CHAIN, um eine Prozesskette zu starten, die Verarbeitung zu überwachen und die Protokolle im Aktivierungsreport zu speichern. Sie können verschiedene Startbedingungen angeben. Falls die Prozesskette nicht sofort startet, sondern erst nach einem Ereignis oder zu einer bestimmten Zeit, werden diese Startbedingungen protokolliert. Nachdem die Prozesskette gestartet wurde, wird sie bis zu ihrem Ende überwacht. Das Log der Prozesskette wird im Aktivierungsreport gespeichert. Darüber hinaus können Sie einzelne Prozesslogs oder Prozesslogs von Hintergrund-Jobs speichern. Sie können bei einer Unterbrechung auch wiederholte Versuche auslösen, damit die Prozesskette fortgesetzt wird.

Transaktion: RSA1

Syntax

BW_ACTIVATE_CHAIN

    ID=...
    [,NOFOUND=...]
    [,ERROR=...]
    [,PROCESSLOGS=...]
    [,RESTART=...]
    [,JOBLOGS=...]
    [,LONGTEXT=...]
    [,REPLICATE=...]
    [,STATUSRETRY=...]
    [,SCHEDULE=...]
    [,SYNCHRONOUS=...]
    [,GET_SPOOL=...]
    [,COLLECTLOGS=...]

Parameter

  • BW_ACTIVATE_CHAIN
    Startet eine Prozesskette, überwacht die Durchführung und speichert deren Logs im Aktivierungsreport.

  • ID=
    Technische Bezeichnung der Prozesskette
    Format: Script-Literal
  • NOFOUND=
    (Optional) Vorgehensweise, wenn die Prozesskette nicht gefunden wird
    Format: Script-Literal
    Erlaubte Werte:
    • NORMAL (Standard)
      Das Script wird fortgesetzt, der -Job endet normalAE
    • ABEND
      Das Script bricht ab, der AE-Job endet vorzeitig
  • ERROR=
    (Optional) Vorgehensweise, wenn die Prozesskette ungewöhnlich endet. Dieser Parameter ist nützlich, um Prozessketten oder ihre Child-Prozesse neu zu starten. Der Vorteil ist, dass der Job nicht beendet wird und die Verarbeitung in einem Parent-Prozess fortgesetzt wird, wie z. B. einem Workflow.
    • Format: Script-Literal
    Erlaubte Werte:
    • ABEND (Standard)
      Das Script bricht ab, der AE-Job endet vorzeitig
    • IGNORE
      Das Script wird fortgesetzt, der AE-Job endet normal
    • SUSPEND
      Der Job bleibt aktiv, bis ein Neustart der Prozesskette bzw. ihrer Child-Prozess erfolgreich war oder der Job manuell abgebrochen wurde.
  • PROCESSLOGS=
    (Optional) Ausgabe der einzelnen Prozesslogs einer Prozesskette
    Format: Script-Literal
    Erlaubte Werte:
    • YES (Standard)
      Die Logs der einzelnen Prozesse werden an das Prozesskettenlog angehängt
    • NO
      Es wird nur das Prozesskettenlog ausgegeben.
    • ERROR
      Die Logs der einzelnen Prozesse werden nur im Fehlerfall ausgegeben
  • RESTART=
    (Optional) Anzahl der Versuche zum Fortsetzen einer unterbrochenen Prozesskette
    Format: Ganzzahl
    Standardwert: 0
  • JOBLOGS=
    (Optional) Ausgabe der Prozesslogs des Hintergrund-Jobs
    Format: Script-Literal
    Erlaubte Werte:
    • YES (Standard)
      Prozesslogs von Hintergrund-Jobs werden ausgegeben
    • NO
      Prozesslogs von Hintergrund-Jobs werden nicht ausgegeben
    • ERROR
      Prozesslogs von Hintergrund-Jobs werden nur ausgegeben, wenn ein Fehler auftritt
  • LONGTEXT=
    (Optional) Ausgabe des Langtexts (Diagnosetext) einer Logmeldung
    Format: Script-Literal
    Erlaubte Werte:
    • ERROR (default)
      Der Langtext der Logmeldung wird nur ausgegeben, wenn ein Fehler auftritt
    • YES
      Der Langtext der Logmeldung wird ausgegeben
    • NO
      Der Langtext der Logmeldung wird nicht ausgegeben
  • REPLICATE=
    (Optional) Verarbeitung der Child-Prozesse einer Prozesskette
    Format: Script-Literal
    Erlaubte Werte:
    • NO (Standard)
      Im AE-System findet keine Replikation statt.
    • YES
      Repliziert die Child-Prozesse eines Jobs im AE-System. Die Child-Prozesse werden in der Process Monitoring-Perspektive angezeigt. Statistische Aufzeichnungen und Reports werden ebenfalls im AE-System generiert.
    • ALL
      Repliziert alle Child-Prozesse eines Jobs im AE-System, einschließlich der übersprungenen. Die Child-Prozesse werden in der Process Monitoring-Perspektive angezeigt. Statistische Aufzeichnungen und Reports werden ebenfalls im AE-System generiert.
  • STATUSRETRY=
    (Optional) Anzahl der wiederholten Statusprüfungen. Erst nach n Wiederholungen wird der Automation Engine mitgeteilt, dass ein Prozess beendet ist.
    Format: Zahl
    Standardwert: 0
    Hinweis: Aufgrund eines speziellen SAP-Verhaltens können Prozessketten für kurze Zeit den Status "beendet" anzeigen und werden dann fortgesetzt. Wenn der Agent den Status einer Prozesskette genau jetzt abruft, würde er das Ende der Prozesskette zu früh melden. Um dieses Verhalten zu verhindern, können Sie den Parameter STATUSRETRY= verwenden.
  • SCHEDULE=
    (Optional) Neue Einplanung von Prozessketten
    Format: Script-Literal
    Erlaubte Werte:
    • YES (Standard)
      Die Prozesskette wird neu eingeplant
    • NO
      Es findet keine Neueinplanung statt
      Dies beschleunigt den Start der Prozesskette.
  • SYNCHRONOUS=
    (Optional) Führt Prozessketten synchron aus, um die Verarbeitung sofort zu starten
    Format: Script-Literal
    Erlaubte Werte:
    • NO (Standard)
      Es findet keine synchrone Ausführung statt
    • YES
      Führt die Prozesskette synchron aus
  • GET_SPOOL=
    (Optional) Fordert die Spool-Liste des gestarteten Jobs an.
    Format: Script-Literal
    Erlaubte Werte:
    • NO (Standard)
      Die Spool-Liste wird nicht angefordert
    • YES
      Fordert die Spool-Liste an
      Die Spool-Liste wird als Textdatei in dem Verzeichnis gespeichert, das in der INI-Datei des SAP-Agenten mit dem Parameter definiert wurde. Der Parameter, der für diesen Zweck verwendet wird, ist Download_dir= ([GLOBAL]-Abschnitt). Der Name dieser Datei ist wie folgt aufgebaut:
      <SAP-Jobzähler>_<Schrittnummer>_<Spool-Nummer>.txt
      Diese Datei wird auch als Jobausgabe im AE-Job registriert.
      Weitere Informationen finden Sie unter Agent SAP und Registrierte Job-Ausgabe.
  • COLLECTLOGS=
    (Optional) Schreibt die Reports der aktivierten Child-Prozesse der Prozesskette in den Job-Report.

    • Standardmäßig stehen die Reports replizierter Child-Prozesse im Job-Report UND in der Aufgabe des Child-Prozesses zur Verfügung. Sie können festlegen, diese Informationen nicht zweimal zu speichern.
    Zulässige Werte:

    • YES (Standard)
      Logs von Child-Prozessen werden in den Jobreport geschrieben
    • NO
      Logs der Child-Prozesse der Prozesskette werden in den Job-Report geschrieben

      • Hinweis: Die Reports der Child-Prozesse stehen nicht zur Verfügung, wenn Sie in den Parametern REPLICATE und COLLECTLOGS NO angeben.

Statusüberprüfung

Die Automation Engine erwartet dass ein abschließender technischer Status übermittelt wird, wenn der Agent den Status überprüft. Die Beschreibung im Interface Repository dafür lautet:

Der TECHSTATUS-Parameter stellt den technischen Status der Anforderung dar. Dieser hat immer einen der folgenden Werte:

  • G Grün (Anforderung erfolgreich verarbeitet)
  • YGelb (Anforderung wird gerade verarbeitet)
  • RRot (Anforderung ist fehlerhaft oder wurde abgebrochen)

Diese Status sind aber offensichtlich keine finalen Status. Ein Status kann für kurze Zeit auf rot und nach einer Weile dann auf gelb oder grün wechseln. Die AE berücksichtigt diese Tatsache. Für Statusprüfungen können Sie beispielsweise eine Zeitverzögerung aktivieren, um n Mal zu prüfen, ob der Status Rot tatsächlich in diesem Status verbleibt. Die INI-Datei des SAP-Agenten enthält dazu die Parameter maxruntime= und repeat_check= in ihrem [SAP_BW]-Abschnitt.

Es steht eine weitere Funktion zur Verfügung, die die Status von Prozessketten überprüft. Sie liefert die folgenden Werte:

  • R
    Abbruch
  • G
    normales Ende
  • F
    normales Ende
  • A
    Überwachung fortsetzen
  • X
    Abbruch
  • P
    Überwachung fortsetzen
  • S
    Abbrechen, nachdem die Prozesskette neu gestartet wurde
  • Q
    Überwachung fortsetzen
  • Y
    Überwachung fortsetzen
  • " "
    Überwachung fortsetzen

Das AE-System konvertiert dann diese Status in Rückgabecodes:

  • 0
    Status: ENDED_OK
    SAP-Status: G oder F
  • 4
    Status: ENDED_NOT_OK
    SAP-Status: R
  • 8
    Status: ENDED_NOT_OK
    SAP-Status: X
  • 12
    Status: ENDED_NOT_OK
    SAP-Status:S

Beispiele

Im Beispiel soll eine Prozesskette aktiviert werden, die vorher vom Benutzer abgefragt wurde. Die Werte für die relevanten Parameter im Script-Element ergeben sich aus dieser Abfrage. Dem Script-Element werden diese Werte als Script-Variablen übergeben.

: BEGINREAD
:    READ   &CHAIN# , "ZTEST,ZSBB1,ZSBB2" , 'Prozesskette' , 'ZTEST' ,M
:    READ   &ERROR# , "IGNORE,ABEND" , 'ERROR =', 'ABEND'
:    READ   &NOFOUND# , "NORMAL,ABEND" , 'NOFOUND =', 'NORMAL'
:    READ   &LT# , "YES,NO,ERROR" , 'LONGTEXT =', 'YES'
: ENDREAD

BW_ACTIVATE_CHAIN ID='&CHAIN#',ERROR='&ERROR#',NOFOUND='&NOFOUND#',LONGTEXT='&LT#'