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

BW_RESTART_CHAIN

Setzt eine abgebrochene Prozesskette fort.

Transaktion: RSA1

SAP BW-Version: ab 3.0B mit Patch SAPKW30B11

Syntax

BW_RESTART_CHAIN

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

Syntax	Beschreibung / Format
ID=	Technische Bezeichnung der Prozesskette. Format des Wertes: Script-Literal
LOGID=	25-stellige Log-ID. Format des Wertes: Script-Literal
NOFOUND=	Behandlung, wenn die Prozesskette nicht gefunden wurde. Format des Wertes: Script-Literal Erlaubte Werte: NORMAL (Standardwert) oder ABEND Standardwert: NORMAL "NORMAL" - Das Script wird fortgesetzt, der AE-Job endet normal. "ABEND" = Das Script wird nicht fortgesetzt, der AE Job endet abnormal.
ERROR=	Behandlung, wenn die Prozesskette abnormal endet. Format des Wertes: Script-Literal Erlaubte Werte: ABEND (Standardwert), IGNORE oder SUSPEND Standardwert: "ABEND" "ABEND" = Das Script wird nicht fortgesetzt, der AE Job endet abnormal. "IGNORE" - Das Script wird fortgesetzt, der AE Job endet normal. "SUSPEND" = Der Job bleibt aktiv, solange bis ein Wiederanlauf der Prozesskette / bzw. deren Child-Prozesse erfolgreich war oder der Job manuell abgebrochen wurde. Dieser Parameter dient dazu um einen Wiederanlauf von Prozessketten / bzw. deren Child-Prozesse durchzuführen, ohne dass der Job endet und somit die Verarbeitung in einem Parent (zum Beispiel einem Workflow) fortgesetzt wird.
PROCESSLOGS=	Ausgabe der Protokolle der einzelnen Prozesse einer Prozesskette. Format des Wertes: Script-Literal Erlaubte Werte: "YES" (Standardwert), "NO" oder "ERROR" Standardwert: YES "YES" = Die Protokolle der einzelnen Prozesse werden an das Protokoll der Prozesskette angehängt. "NO" = Es wird nur das Protokoll der Prozesskette ausgegeben. "ERROR" = Die Protokolle der einzelnen Prozesse werden nur im Fehlerfall ausgegeben.
JOBLOGS=	Ausgabe der Protokolle des Backgroundjobs zum Prozess. Format des Wertes: Script-Literal Erlaubte Werte: "YES" (Standardwert), "NO" oder "ERROR" Standardwert: YES "YES" = Die Protokolle des Backgroundjobs zum Prozess werden ausgegeben. "NO" = Die Protokolle des Backgroundjobs zum Prozess werden nicht ausgegeben. "ERROR" = Die Protokolle des Backgroundjobs zum Prozess werden nur im Fehlerfall ausgegeben.
LONGTEXT=	Ausgabe des Langtextes (Diagnosetext) zu einer Protokollmeldung. Format des Wertes: Script-Literal Erlaubte Werte: YES, NO oder ERROR (Standardwert) Standardwert: ERROR "ERROR" = Der Langtext zu einer Protokollmeldung wird nur im Fehlerfall ausgegeben. "YES" = Der Langtext zu einer Protokollmeldung wird ausgegeben. "NO" = Der Langtext zu einer Protokollmeldung wird nicht ausgegeben.
REPLICATE=	Behandlung der Child-Prozesse von Prozessketten. Format des Wertes: Script-Literal Erlaubte Werte: "ALL", "YES" oder "NO" (Standardwert) "ALL" = Alle Children-Prozesse eines Jobs im Automation Engine System replizieren (inklusive der übersprungenen). Sie erscheinen sodann im Aktivitätenfenster des UserInterfaces. Des Weiteren werden Statistiksätze und Reports im Automation Engine System erzeugt. "YES" - Children eines Jobs werden im AE-System repliziert. Sie erscheinen sodann im Aktivitätenfenster des UserInterfaces. Des Weiteren werden Statistiksätze und Reports im Automation Engine System erzeugt. "NO" - Es erfolgt keine Nachbildung im AE-System.
GET_SPOOL=	Spoolliste der gestarteten Prozesskette anfordern Format des Wertes: Script-Literal Erlaubte Werte: "YES" oder "NO" (Standardwert) "YES" = Spoolliste anfordern. Diese wird dabei als Text-Datei in das Verzeichnis gespeichert, welches Sie in der INI-Datei des SAP-Agenten mit dem Parameter Download_dir= (Sektion [GLOBAL]) festlegen. Der Name dieser Datei setzt sich folgendermaßen zusammen: <SAP-Job-Count>_<Step-Nummer>_<Spool-Nummer>.txt Zusätzlich wird diese Datei beim AE-Job als Job-Output registriert. "NO" = Spooliste wird nicht angefordert
COLLECTLOGS=	Reports von Child-Prozessen der aktivierten Prozesskette in den Job-Report schreiben Werden Child-Prozesse repliziert, so ist deren Protokoll standardmäßig im Report des Jobs UND der Aufgabe des Child-Prozess verfügbar. Diese Informationen sind somit im Job-Report redundant und können daher weggelassen werden. Erlaubte Werte: "YES" (Standardwert) oder "NO" "YES" - Protokoll von Child-Prozessen in den Job-Report schreiben "NO" - Protokoll von Child-Prozessen der Prozesskette nicht in den Job-Report übernehmen Beachten Sie, dass die Reports der Child-Prozesse nicht verfügbar sind, wenn die Parameter REPLICATE und COLLECTLOGS beide auf NO gesetzt sind.

Beschreibung

Das Script-Sprachmittel setzt eine abgebrochene Prozesskette fort. Mit dem Parameter LOGID= wird dabei eine bestimmte Durchführung dieser Prozesskette eindeutig identifiziert. Die Log-ID kann mit PREP_PROCESS_REPORT aus dem Report eines AE-Jobs ermittelt werden.

Nachdem die Prozesskette fortgesetzt wurde, wird sie bis zu ihrem Ende überwacht. Das Protokoll der Prozesskette wird auf jeden Fall im Aktivierungsreport gespeichert. Abhängig von den Parametern PROCESSLOGS= und JOBLOGS= werden zusätzlich die Protokolle der einzelnen Prozesse bzw. die Protokolle des Backgroundjobs zum Prozess ausgegeben.

Beispiele

Im Beispiel wird im Post-Script eines Jobs anhand der Fehlernummer ermittelt, ob die Prozesskette "ZSBB1" abgebrochen ist. 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'

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