HLDJOB

Suspendre un travail

En bref

La commande HLDJOB (Suspendre un travail) rend un travail inéligible pour traitement.

HLDJOB se lit HLD (Suspendre) + JOB. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

HLDJOB JOB(…)

Paramètres

JOB Travail obligatoire
SPLFILE Suspendre les fichiers spoule
DUPJOBOPT Option pour travaux dupliqués

Astuce : dans une session 5250, tapez HLDJOB 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 HLDJOB (Suspendre un travail) rend un travail inéligible pour traitement. Le travail demeure suspendu tant qu'il n'est pas :

libéré, par la commande RLSJOB (Libérer un travail),
libéré, par la commande CLRJOBQ (Mettre à blanc file de travaux),
libéré par la commande ENDJOB (Arrêter un travail),
arrêté alors qu'il est actif par la commande ENDSBS (Arrêter un sous-système), ENDSYS (Arrêter le système) ou PWRDWNSYS (Mettre le système hors tension).

La suspension d'un travail interrompt également toutes les unités d'exécution qui le composent.

Remarque :Si vous utilisez cette commande pour suspendre un travail disposant d'un accès exclusif aux ressources du système, les autres travaux ne pourront pas accéder à ces ressources. Les travaux qui demandent à accéder à ces ressources échouent ou sont définitivement mis en attente.

Restrictions : L'émetteur de la commande doit utiliser un profil utilisateur identique à celui du travail suspendu, 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'.

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
SPLFILE	Suspendre les fichiers spoule	NO, YES	Facultatif, positionnel 2
DUPJOBOPT	Option pour travaux dupliqués	SELECT, MSG	Facultatif

Travail (JOB)

Indique le nom du travail suspendu.

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 est démarré.

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

Suspendre les fichiers spoule (SPLFILE)

Indique si les fichiers spoule en sortie créés par le travail suspendu doivent également être suspendus.

*NO: Les fichiers spoule en sortie ne sont pas suspendus.
*YES: Les fichiers spoule en sortie sont suspendus. Le système supprime uniquement les fichiers spoule en sortie placés dans les files d'attente en sortie définies dans l'espace de nom de la bibliothèque pour l'unité d'exécution qui lance la commande. Si l'attribut de travail (SPLFACN) (Action de fichier spoule) est *DETACH et que le travail s'arrête lorsque les fichiers spoule sont suspendus, les fichiers spoule ne peuvent pas être libérés par la commande RLSJOB (Libérer un travail). Pour les libérer après que le travail a été enlevé du système, utilisez la commande RLSSPLF (Libérer un fichier spoule).

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.

Exemples

Exemple 1 : Procédure pour rendre un travail inéligible pour le traitement

HLDJOB   JOB(PAYROLL)  SPLFILE(*YES)

Cette commande permet de rendre un travail appelé PAYROLL inéligible pour le traitement. Tous les fichiers spoule de ce travail sont également suspendus.

Exemple 2 : Suspension d'un travail possédant un nom déjà utilisé

HLDJOB   JOB(DEPTXYZ/PAYROLL)

Cette commande permet de suspendre un travail appelé PAYROLL soumis par un utilisateur doté du profil DEPTXYZ. La forme qualifiée du nom de travail est utilisée lorsqu'il existe plusieurs travaux portant des noms identiques dans le système. Les fichiers spoule ne sont pas suspendus.

Messages d'erreur

Messages *ESCAPE

CPF1E52: Vous n'êtes pas autorisé à suspendre le travail &1.
CPF1E53: Le travail &1 est terminé et ne peut plus être suspendu.
CPF1E54: Le travail &1 ne peut pas être suspendu.
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.
CPF1344: Vous n'êtes pas autorisé à contrôler le travail &3/&2/&1.
CPF1345: Impossible de suspendre le travail &3/&2/&1.
CPF1346: Travail &3/&2/&1 déjà suspendu.
CPF1347: Impossible de suspendre le travail &3/&2/&1.
CPF1348: Travail &3/&2/&1 suspendu, mais pas ses fichiers.
CPF1350: SPLFILE(*NO) indiqué mais travail &3/&2/&1 en OUTQ.
CPF1351: Erreur dans le sous-système pour le travail &3/&2/&1.
CPF1352: Fonction non exécutée. &3/&2/&1 en transition.
CPF1378: Travail &3/&2/&1 non suspendu actuellement.