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 ))
- Job ist nicht vorhanden
- Job ist nicht gültig
- Datenbankausnahmebedingung ist eingetreten
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 |

- 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.