BW_RESTART_CHAIN

Verwenden Sie dieses Script-Element, um eine unterbrochene Prozesskette fortzusetzen. Wenn die Prozesskette fortgesetzt wird, wird sie bis zum Ende überwacht und das Log wird im Aktivierungsreport gespeichert. Darüber hinaus können Sie einzelne Prozesslogs oder Prozesslogs von Hintergrund-Jobs mithilfe des Script-Elements BW_RESTART_CHAIN speichern.

Transaktion: RSA1

Syntax

BW_RESTART_CHAIN

    ID=...
    ,LOGID=...
    [,NOFOUND=...]
    [,ERROR=...]
    [,PROCESSLOGS=...]
    [,JOBLOGS=...]
    [,LONGTEXT=...]
    [,REPLICATE=...]
    [,GET_SPOOL=...] 
    [,COLLECTLOGS=...]

Parameter

  • BW_RESTART_CHAIN
    Setzt eine unterbrochene Prozesskette fort.

  • ID=
    Technische Bezeichnung der Prozesskette
    Format: Script-Literal
  • LOGID=
    25-stellige Log-ID
    Format: Script-Literal

    • Tipp: Verwenden Sie PREP_PROCESS_REPORT, um die Log-ID aus einem AE-Jobreport abzurufen.

  • NOFOUND=
    (Optional) Vorgehensweise, wenn die Prozesskette nicht gefunden wird
    Format:     Script-Literal
    Erlaubte Werte:
    • NORMAL (Standard)
      Das Script wird fortgesetzt, der AE-Job endet normal
    • 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 untergeordneten Prozesse neu zu starten, mit dem Vorteil, dass der Job nicht endet und die Verarbeitung in einem Parent-Prozess, wie z. B. einem Workflow, fortgesetzt wird.
    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
  • 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 (Standard)
      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.
  • 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 Download_dir= (Abschnitt [GLOBAL]) definiert wurde. 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 Child-Prozesse der aktivierten Prozesskette in den Jobreport

    • Werden Child-Prozesse repliziert, so ist deren Report standardmäßig im Job-Report UND der Aufgabe des Child-Prozess verfügbar. Diese Informationen sind somit im Job-Report redundant und können daher weggelassen werden.
    Zulässige Werte:

    • YES (Standard)
      Logs von Child-Prozessen werden in den Jobreport geschrieben
    • No
      Logs der Child-Prozesse der Prozesskette werden nicht in den Jobreport geschrieben

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

Beispiele

Im Beispiel wird im Post-Script eines Jobs anhand der Fehlernummer ermittelt, ob die Prozesskette ZSBB1 eines Jobs unterbrochen wurde. In diesem Fall wird die 25-stellige Log-ID in einer Variablen gespeichert.

: SET   &HND# = PREP_PROCESS_REPORT (,,PLOG, '*U2004111*' , 'COL=DELIMITER' , "DELIMITER =@'@")
: SET   &LOGID# = ''

: PROCESS   &HND#
:    SET   &LOGID# = GET_PROCESS_LINE ( &HND# ,4)
: ENDPROCESS

: IF   &LOGID# <> ''
:    PUT_VAR VARA.CHAINS, 'ZSBB1' , &LOGID#
: ENDIF

Ein weiterer Job liest die Log-ID aus der Variablen und startet die Prozesskette erneut, um die Verarbeitung fortzusetzen.

: SET   &LOGID# = GET_VAR (VARA.CHAINS,ZSBB1)
BW_RESTART_CHAIN ID='ZSBB1',LOGID='&LOGID#',ERROR='ABEND',NOFOUND='NORMAL'