Codes retour des traitements par lots
Le code de retour du travail par lots est extrait en utilisant l'interface EJB getBatchJobRC, l'interface des services Web get BatchJobRC ou l'option de commande lrcmd getBatchJobRC.
Le tableau suivant répertorie les codes retour des travaux par lots utilisés par l'environnement de traitement par lots. Ne confondez pas le code de retour de travail par lots avec les constantes d'état de travail (voir l'APIcom.ibm.websphere.longrun.JobStatusConstants) ou les constantes du planificateur de travaux (voir l'API com.ibm.websphere.longrun.JobSchedulerConstants). Les constantes JobStatusConstants représentent le statut du travail, par exemple : soumis, terminé, redémarrable, annulé ou échec de l'exécution.
L'état du travail peut être obtenu en utilisant l'interface EJB getJobStatus, l'interface des services Web getJobStatus ou via la console de gestion des travaux. JobSchedulerConstants représente les conditions d'exploitation renvoyées par le planificateur de travaux sur des demandes impliquant plusieurs travaux. Exemple :
int[] cancelJob( String[] jobid ))
- Le travail n'existe pas.
- Le travail n'a pas un statut valide.
- Une exception de base de données s'est produite.
Code retour | Explications |
---|---|
0 | Le travail s'est terminé normalement. |
-1 | Erreur de protocole interne - Utilitaire WSGrid |
-2 | Erreur de paramètre d'entrée - Utilitaire WSGrid |
-4 | Le travail a été suspendu. |
-8 | Le travail a été annulé. |
-10 | Le travail a été annulé de manière forcée (z/OS uniquement) |
-12 | Le travail a échoué et a le statut redémarrable. |
-14 | Le travail a échoué et a le statut 'Echec de l'exécution'** |
-16 | Incident sérieux - Utilitaire WSGrid |

- La première option permet à l'application de produire une exception lorsqu'une erreur est rencontrée. Cela a pour résultat d'arrêter le travail avec le code retour de travail par lots -12 et le statut restartable. L'exception peut être émise dans n'importe laquelle des méthodes de l'API par lots.
- La seconde option permet à l'application de renvoyer un code retour BatchConstants.STEP_COMPLETE_EXECUTION_FAILED (voir l'interface de programme d'application com.ibm.websphere.batch.BatchConstants) à partir de la méthode processJobStep et un code retour d'erreur spécifique à l'application à partir de la méthode destroyJobStep. Cela a pour résultat d'arrêter le travail avec le statut de travail par lots Echec de l'exécution. Le code retour d'étape défini dans la méthode destroyJobStep est transmis à l'algorithme de résultats spécifié dans l'étape du travail et est utilisé pour influencer le code retour du travail afin d'indiquer la cause précise de l'échec.