Aller au contenu

ENDJOBABN

Arrêter anormalement travail

En bref

La commande ENDJOBABN (Arrêter anormalement travail) permet d'arrêter un travail qui n'a pas pu être arrêté par la commande ENDJOB (Arrêter un travail) avec *IMMED indiqué pour le paramètre OPTION ( Type d'arrêt ).

ENDJOBABN se lit END (Arrêter) + JOBABN. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ENDJOBABN JOB(…)

Paramètres

  • JOB Travail obligatoire
  • DUPJOBOPT Option pour travaux dupliqués
  • DUMP Données à clicher

Astuce : dans une session 5250, tapez ENDJOBABN puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande ENDJOBABN (Arrêter anormalement travail) permet d'arrêter un travail qui n'a pas pu être arrêté par la commande ENDJOB (Arrêter un travail) avec *IMMED indiqué pour le paramètre OPTION (Type d'arrêt). Attendez 10 minutes avant de lancer une commande ENDJOBABN ; c'est le laps de temps nécessaire pour qu'un travail s'arrête normalement.

Lorsque la commande ENDJOBABN est émise, le traitement de fin de travail est en grande partie ignoré (notamment la mise en attente de l'historique du travail, l'arrêt de l'affichage des travaux interactifs et le traitement de fin de travail des fonctions spécifiques exécutées). La partie du traitement que le système tente de lancer dispose d'un délai d'exécution limité à cinq minutes. Si elle n'est pas exécutée dans ce laps de temps, le travail est contraint de s'arrêter à ce stade. Comme la procédure de ménage du travail n'est pas exécutée, vous devez utiliser la commande ENDJOBABN uniquement lorsque la commande d'arrêt immédiat échoue et que les ressources utilisées par le travail sont demandées par un autre travail ou par le système. Lorsque la commande ENDJOBABN est exécutée, certaines ressources utilisées par le travail arrêté risquent de rester indisponibles jusqu'au prochain IPL.

Lorsque la commande ENDJOBABN est utilisée, le prochain arrêt du système est considéré comme ABNORMAL. Certaines fonctions système sont ensuite appelées lors de l'IPL suivant pour supprimer les conditions générées par l'exécution de la commande ENDJOBABN. Toutefois, les fonctions de reprise de la machine ne sont appelées et les chemins d'accès ne sont pas reconstruits. Une partie de la mémoire utilisée par le travail peut restée indisponible après l'exécution de la commande ENDJOBABN. Pour récupérer la mémoire disponible, vous pouvez exécuter la commande RCLSTG (Récupérer mémoire secondaire).

Lorsque la procédure de consignation du travail est ignorée, l'état du travail arrêté par la commande ENDJOBABN est JOBLOG PENDING (comme indiqué dans l'écran des attributs de l'état DSPJOB). La consignation du travail n'est pas exécutée tant que l'IPL n'est pas effectué. Toutefois, le contenu de l'historique du travail peut être imprimé et affiché à l'aide de la commande DSPJOBLOG (Afficher l'historique du travail).

Lorsque la commande ENDJOBABN est exécutée, les fonctions ci-après sont exécutées :

  • Journalisation des postes
  • Contrôle de validation

    Avant de mettre fin au travail de façon anormale, vérifiez qu'aucune unité d'oeuvre logique n'est en état d'attente en raison d'une opération de validation à deux phases en cours d'exécution. Si c'est le cas, les modifications validables en instance sur ce système ne seront pas validées ou invalidées. Par conséquent, il se peut que l'intégrité de la base de données ne soit pas maintenue sur tous les systèmes connexes. Pour connaître les instructions spécifiques à suivre pour déterminer ces conditions, et pour connaître toutes les conséquences liées à l'arrêt anormal d'un travail dans ces conditions, reportez-vous à l'article relatif au contrôle de validation du Centre de documentation.

  • Mise à la disposition des autres utilisateurs des fichiers base de données
  • Libération des verrouillages de fichier

Dans certains cas indiqués ci-après, cette commande ne parvient pas à arrêter le travail ou demande plus de 5 minutes pour exécuter l'opération :

  • Lorsque le travail s'exécute avec un moniteur de sous-système qui est bloqué, est anormalement lent, ou a été arrêté de manière anormale (le moniteur de sous-système exécute une partie de la procédure d'arrêt).
  • Lorsque l'instruction de l'interface machine exécutée dans le travail est bloquée ou anormalement lente. Le travail ne peut pas s'arrêter tant que l'instruction de l'interface machine en cours ne s'est pas exécutée ou n'a pas atteint un point d'interruption.

Restrictions :

  1. L'émetteur de la commande doit utiliser un profil utilisateur identique à celui de l'utilisateur du travail à terminer, ou un profil utilisateur disposant du droit spécial d'exploitation des travaux (*JOBCTL). L'identité de l'utilisateur du travail correspond au nom du profil utilisateur permettant d'identifier un travail par rapport aux autres travaux. Pour plus d'informations à ce sujet, reportez-vous au manuel 'Work Management'.
  2. Une fois la commande ENDJOBABN lancée, aucune autre commande ENDJOBABN ne peut être émise pour le travail.
  3. Aucun programme de lecture, éditeur, moniteur de sous-système ou travail système ne peut être arrêté par un utilisateur.
  4. Après l'arrêt immédiat du travail, les utilisateurs doivent attendre dix minutes avant de pouvoir exécuter la commande ENDJOBABN. Le travail est immédiatement interrompu dans les cas suivants :
    • La commande ENDJOB ( Arrêter un travail) avec OPTION(*CNTRLD) est exécutée et le délai arrive à expiration.
    • La commande ENDJOB OPTION(*IMMED) est émise.
    • La commande ENDSBS (Arrêter un sous-système) OPTION(*CNTRLD) est émise pour le sous-système exécutant le travail et le délai arrive à expiration.
    • La commande ENDSBS OPTION(*IMMED) est émise pour le sous-système exécutant le travail.
    • La commande ENDSYS (Arrêter le système) OPTION(*IMMED) ou ENDSYS OPTION(*CNTRLD) est émise et le délai arrive à expiration.
    • La commande PWRDWNSYS (Mettre le système hors tension) OPTION(*IMMED) est émise.
  5. Si le travail définit un gestionnaire de signaux pour le signal asynchrone SIGTERM, l'arrêt immédiat du travail est retardé pour permettre l'exécution du gestionnaire de signaux SIGTERM. Pour plus d'informations, reportez-vous à la valeur système QENDJOBLMT. La commande ENDJOBABN n'est pas admise pendant l'exécution du gestionnaire de signaux SIGTERM. Si le gestionnaire de signaux SIGTERM s'exécute depuis au moins deux minutes, utilisez la commande ENDJOB avec OPTION(*IMMED) pour l'arrêter.

Paramètres

Mot-clé Description Valeurs possibles Remarques
JOB Travail Nom de travail qualifié Obligatoire, positionnel 1
Qualificatif 1: Travail Nom
Qualificatif 2: Utilisat Nom
Qualificatif 3: Numéro 000000-999999
DUPJOBOPT Option pour travaux dupliqués *SELECT, *MSG Facultatif
DUMP Données à clicher *JOB, *NONE Facultatif

Travail (JOB)

Indique le nom qualifié du travail à arrêter.

Ce paramètre est requis.

Qualificatif 1 : Travail

nom
Indiquez le nom du travail.

Qualificatif 2 : Utilisat

nom
Indiquez le nom de l'utilisateur qui identifie le profil utilisateur sous lequel le travail s'exécute.

Qualificatif 3 : Numéro

000000-999999
Indiquez le numéro de travail attribué par le système.

Remarque :Si aucun nom d'utilisateur ou numéro de travail n'est indiqué, le système recherche les noms de tous les travaux en cours. S'il trouve plus d'une occurrence du nom spécifié, un nom de travail qualifié doit être indiqué explicitement ou via l'écran de sélection. Pour en savoir plus, reportez-vous au paramètre DUPJOBOPT (Option pour travaux dupliqués).

Option pour travaux dupliqués (DUPJOBOPT)

Indique l'action effectuée lorsque des travaux en double sont détectés par cette commande.

*SELECT
L'écran de sélection s'affiche lorsque des travaux en double sont détectés lors d'une session interactive. Sinon, un message est émis.
*MSG
Un message est émis lorsque des travaux dupliqués sont détectés.

Données à clicher (DUMP)

Indique les données qui sont clichées avant la fin du travail.

*JOB
Le travail est cliché à l'aide de la commande Afficher l'état d'un travail (DSPJOB) avant son arrêt.
*NONE
Aucun cliché n'est généré avant la fin du travail.

Exemples

ENDJOBABN   JOB(000310/SMITH/PAYROLL)

Cette commande permet d'arrêter le travail 000310/SMITH/PAYROLL après l'échec de la commande ENDJOB. Après avoir lancé la commande ENDJOB pour arrêter le travail, vous devez attendre au moins attendre 10 minutes pour lancer la commande ENDJOBABN.

Messages d'erreur

Messages *ESCAPE

CPF1317
Aucune réponse du sous-système pour le travail &3/&2/&1.
CPF1321
Travail &3/&2/&1 non trouvé.
CPF1332
Fin des noms dupliqués.
CPF1340
Fonction de contrôle de travail non effectuée.
CPF1341
Lecteur/éditeur &3/&2/&1 non admis comme nom de travail.
CPF1342
Le nom du travail en cours n'est pas admis dans cette commande.
CPF1343
Type du travail &3/&2/&1 incorrect pour la fonction.
CPF1351
Erreur dans le sous-système pour le travail &3/&2/&1.
CPF1359
ENDJOBABN non admis actuellement pour travail &3/&2/&1.
CPF1360
&3/&2/&1 déjà arrêté par ENDJOBABN.
CPF1362
Travail &3/&2/&1 terminé.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.