Stapelrückkehrcodes

Der Rückkehrcode des Stapeljobs wird über die EJB-Schnittstelle "getBatchJobRC", die Web-Service-Schnittstelle "getBatchJobRC" oder die Befehlsoption "lrcmd getBatchJobRC" abgerufen.

In den folgenden Tabellen sind die Rückkehrcodes von Systemstapeljobs aufgelistet, die in der Stapelumgebung verwendet werden. Der Rückkehrcode des Stapeljobs darf nicht mit Jobstatuskonstanten (siehe API "com.ibm.websphere.longrun.JobStatusConstants") oder Job-Scheduler-Konstanten (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".

Der Jobstatus kann über die EJB-Schnittstelle "getJobStatus", die Web-Service-Schnittstelle "getJobStatus" oder über die Jobverwaltungskonsole abgerufen werden. "JobSchedulerConstants" gibt die Betriebsbedingungen an, die vom Job-Scheduler zurückgegeben werden bei Anfragen, die mehrere Jobs umfassen. Beispiele:

int[] cancelJob( String[] jobid ))
Diese Bedingungen sind folgende:
  1. Job ist nicht vorhanden
  2. Job ist nicht gültig
  3. Datenbankausnahmebedingung ist eingetreten
Tabelle 1. Rückkehrcodes von Stapeljobs. In der Tabelle sind alle Rückkehrcodes mit Erläuterungen aufgelistet.
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
Fehler vermeiden Fehler vermeiden: Eine Anwendung kann zwar einen Wert für den Jobrückgabecode definieren, der Wert wird jedoch nur dann zurückgegeben, wenn der Job normal abgeschlossen wird. Wenn der Job mit dem Status "Ausführung fehlgeschlagen" oder "Wieder anlauffähig" scheitert, ist der zurückgegebene Wert einer der von der Laufzeit definierten negativen Rückgabecodes, die in der Tabelle oben beschrieben sind. gotcha
Es gibt zwei Optionen, mit denen ein Fehler in einer Stapelanwendung gemeldet werden kann:
  • Die erste Option ist, dass die Anwendung eine Ausnahmebedingung generiert, 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 Ausnahme kann bei allen Methoden der Stapel-API ausgelöst werden.
  • 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.

Symbol, das den Typ des Artikels anzeigt. Konzeptartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cgrid_cgreturncodes
Dateiname:cgrid_cgreturncodes.html