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 ))
Ces conditions comprennent :
  1. Le travail n'existe pas.
  2. Le travail n'a pas un statut valide.
  3. Une exception de base de données s'est produite.
Tableau 1. Codes retour des travaux par lots. Le tableau répertorie chaque code de retour accompagné d'une explication.
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
Eviter les incidents Eviter les incidents: Même si une application peut définir une valeur pour le code retour du travail, cette valeur n'est renvoyée que lorsque le travail se termine normalement. Si le travail échoue avec un statut indiquant que l'exécution a échoué ou le statut redémarrable, la valeur renvoyée est l'un des codes retour négatifs d'exécution décrits dans le tableau précédent.gotcha
Deux options sont utilisées pour signaler une erreur dans une application par lots :
  • 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.

Icône indiquant le type de rubrique Rubrique de concept



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cgrid_cgreturncodes
Nom du fichier : cgrid_cgreturncodes.html