Der Rückkehrcode des Stapeljobs wird über die EJB-Schnittstelle "getBatchJobRC", die Web-Service-Schnittstelle "getBatchJobRC" oder die Option lrcmd getBatchJobRC cmd abgerufen.
In der folgenden Tabelle sind die Rückkehrcodes der Systemstapeljobs aufgeführt, die von Compute Grid verwendet werden. Der Rückkehrcode des Stapeljobs darf nicht mit "JobStatusConstants" (siehe API "com.ibm.websphere.longrun.JobStatusConstants") oder "JobSchedulerConstants" (siehe API "com.ibm.websphere.longrun.JobSchedulerConstants") verwechselt werden. "JobStatusConstants" gibt den Status des Jobs an, wie z. B. "Übergeben", "Beendet", "Wieder anlauffähig", "Abgebrochen" oder "Ausführung fehlgeschlagen".
Rückkehrcode | Erläuterung |
---|---|
0 | Job wurde normal beendet |
-1 | Interner Protokollfehler - Dienstprogramm WSGrid |
-2 | Fehler beim Eingabeparameter - Dienstprogramm WSGrid |
-4 | Job wurde ausgesetzt |
-8 | Job wurde abgebrochen |
-10 | Abbrechen des Jobs wurde erzwungen (nur z/OS) |
-12 | Job ist fehlgeschlagen und kann neu gestartet werden |
-14 | Job ist fehlgeschlagen und hat den Status "Ausführung fehlgeschlagen**" |
-16 | Schwer wiegender Fehler - Dienstprogramm WSGrid |
Es gibt zwei Optionen, mit denen ein Fehler in einer Stapelanwendung gemeldet werden kann. Die erste Option ist, dass die Anwendung eine Ausnahmebedingung absetzt, wenn ein Fehler auftritt. Das führt dazu, dass der Job mit dem Rückkehrcode "-12" für Stapeljobs und dem Status Wieder anlauffähig für Stapeljobs abgeschlossen wird. Die zweite Option ist, dass die Anwendung den Rückkehrcode "BatchConstants.STEP_COMPLETE_EXECUTION_FAILED" (siehe API "com.ibm.websphere.batch.BatchConstants") von der Methode "processJobStep" und einen Rückkehrcode für anwendungsspezifische Fehler von der Methode "destroyJobStep" zurückgibt. Das führt dazu, dass der Job beendet wird und der Wechsel in den Status Wieder anlauffähig für Stapeljobs erfolgt. Der Rückkehrcode des Abschnitts, der in der Methode "destroyJobStep" definiert ist, wird an alle im Jobabschnitt angegebenen Ergebnisalgorithmen übergeben. Er wird verwendet, um den Rückkehrcode des Jobs so zu konfigurieren, dass er die spezifische Fehlerursache anzeigt.