IBM PLANNING ANALYTICS · TI-PROZESSE

ProcessBreak
oder ProcessQuit?

Einen TM1-Prozess gezielt beenden. Der Unterschied liegt darin, was danach noch passiert – besonders im Epilog.

Die kurze Antwort

ProcessBreak stoppt die Verarbeitung der Quelldaten und springt zum Epilog. ProcessQuit beendet den TI-Prozess an dieser Stelle; ein anschließender Epilog wird nicht mehr ausgeführt.

DER ÜBERBLICK

ProcessBreak und ProcessQuit im Vergleich

Beide Befehle steuern den Ablauf eines TurboIntegrator-Prozesses in IBM Planning Analytics. Entscheidend ist, ob Abschlussarbeiten noch stattfinden sollen.

VerhaltenProcessBreakProcessQuit
WirkungProzess springt in den EpilogAktuellen TI-Prozess beenden
Weiterer Code im aktuellen BereichWird beim Sprung übersprungenWird nicht mehr ausgeführt
Epilog nach Aufruf im DatenbereichWird ausgeführtWird nicht mehr ausgeführt, da der Prozess bereits beendet wurde.
Typische AbsichtVerarbeitung beenden, Abschlusslogik behaltenAuch die nachfolgende Abschlusslogik unterbinden
SyntaxProcessBreak;ProcessQuit;

Beide Befehle werden ohne Argumente verwendet. Der Ablaufvergleich zeigt einen Aufruf vor dem Epilog.

SO VERÄNDERT SICH DER ABLAUF

Der Epilog macht den Unterschied.

Hier wird der jeweilige Befehl bereits im Prolog erreicht. ProcessBreak springt direkt in den Epilog; ProcessQuit beendet den Prozess sofort.

ProcessBreak;

  1. Prolog ProcessBreak; → Sprung zum Epilog
  2. Metadaten Wird übersprungen
  3. Daten Wird übersprungen
  4. Epilog Abschlusscode ausführen

ProcessQuit;

  1. Prolog ProcessQuit; → Prozess beendet
  2. Metadaten Wird nicht mehr ausgeführt
  3. Daten Wird nicht mehr ausgeführt
  4. Epilog Wird nicht mehr ausgeführt

ZWEI KONKRETE CODEBEISPIELE

Gleiche Bedingung. Andere Fortsetzung.

Die folgenden Ausschnitte zeigen die Steuerung im Datenbereich. Definiere dafür einen numerischen Prozessparameter pStop mit Standardwert 0. Mit 1 löst du beim ersten verarbeiteten Datensatz den jeweiligen Stopp aus.

01

MIT ABSCHLUSS

ProcessBreak: Epilog weiter ausführen

Du möchtest keine weiteren Quellzeilen verarbeiten, aber im Epilog noch dokumentieren, dass die Abschlusslogik erreicht wurde.

DATEN · STEUERUNG
# pStop ist ein numerischer Parameter.
IF (pStop = 1);
  ProcessBreak;
ENDIF;

# Hier folgt deine Verarbeitung.
EPILOG · ABSCHLUSS
LogOutput('INFO', 'Epilog erreicht.');

Bei pStop = 1: Der Prozess wechselt aus der Datenverarbeitung in den Epilog. Die dortige LogOutput-Anweisung wird ausgeführt.

02

OHNE FORTSETZUNG

ProcessQuit: An dieser Stelle beenden

Du möchtest die Ausführung sofort beenden. Auch die unten gezeigte Abschlussmeldung soll dann nicht mehr ausgegeben werden.

DATEN · STEUERUNG
IF (pStop = 1);
  LogOutput('INFO', 'Stopp vor dem Epilog.');
  ProcessQuit;
ENDIF;

# Hier folgt deine Verarbeitung.
EPILOG · BEIM STOPP NICHT ERREICHT
LogOutput('INFO', 'Epilog erreicht.');

Bei pStop = 1: Die Meldung vor ProcessQuit wird ausgeführt. Der nachfolgende Code und die Meldung im Epilog entfallen.

DER PASSENDE BEFEHL

Was möchtest du beenden?

Ein einzelner Datensatz, die weitere Verarbeitung oder der ganze aktuelle Prozess: Das sind unterschiedliche Entscheidungen.

PROCESSBREAK

Die Abschlusslogik soll bleiben.

Wähle den Weg zum Epilog und berücksichtige dort, dass die Verarbeitung vorzeitig endete.

PROCESSQUIT

Der aktuelle Prozess soll enden.

Plane notwendige Meldungen und Aufräumarbeiten vor dem Abbruch ein.

ITEMSKIP

Nur diese Quellzeile soll entfallen.

Wenn die übrigen Datensätze weiter verarbeitet werden sollen, ist ItemSkip der passende Ausgangspunkt.

HÄUFIGE FRAGEN

Noch eine Frage?

Wird der Epilog nach ProcessQuit noch ausgeführt?

Wird ProcessQuit vor dem Epilog erreicht, läuft der Epilog nicht mehr. Steht der Befehl im Epilog selbst, endet die Ausführung dort; der danach stehende Code entfällt.

Kann ich damit nur einen Datensatz überspringen?

Dafür ist ItemSkip vorgesehen. Es überspringt das aktuelle Datenquellenelement. ProcessBreak und ProcessQuit beenden dagegen mehr als die Verarbeitung einer einzelnen Quellzeile.

Ist ein ProcessBreak ein normaler erfolgreicher Abschluss?

IBM unterscheidet eigene Rückgabestatus für ProcessBreak, ProcessQuit und ein normales Prozessende. Werte bei aufrufenden Prozessen den passenden Status aus, statt allein aus einer Epilog-Meldung auf Erfolg zu schließen.

Florian KaiserFlorian KaiserPlanning-Analytics-Berater

VON DER ERKLÄRUNG IN DIE PRAXIS

Laufen deine TI-Prozesse zuverlässig?

Du möchtest Datenimporte robuster aufbauen, Prozessabbrüche nachvollziehen oder bestehende TI-Prozesse weiterentwickeln? Ich unterstütze dich bei der Umsetzung in IBM Planning Analytics.

Projekt besprechen ↗kontakt@florian-kaiser-consulting.de
Fachliche Quellen

IBM-Dokumentation zur Prozesssteuerung. Die Beispiele dienen der Veranschaulichung des dokumentierten Ablaufs.