HLDJOBQ

Suspendre une file de travaux

En bref

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

Syntaxe minimale

HLDJOBQ JOBQ(…)

Paramètres

JOBQ File d'attente de travaux obligatoire

Astuce : dans une session 5250, tapez HLDJOBQ 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 HLDJOBQ (Suspendre une file d'attente de travaux) permet d'empêcher le traitement de tous les travaux en attente dans la file d'attente de travaux et de tous ceux qui sont ajoutés à cette file après le lancement de la commande. Cette commande n'affecte pas les travaux en cours d'exécution. Il est possible de placer des travaux supplémentaires en file d'attente lorsque cette dernière est suspendue, mais ils ne sont pas traités. Ils restent suspendus jusqu'au lancement de la commande RLSJOBQ (Libérer une file d'attente de travaux). Lorsqu'une file d'attente de travaux est suspendue, les travaux peuvent être mis à blanc au moyen de la commande CLRJOBQ (Mettre à blanc une file d'attente de travaux). Il est aussi possible d'annuler un travail spécifique à l'aide de la commande ENDJOB (Arrêter un travail).

Restriction: La file d'attente de travaux QLPINSTALL ne peut pas être suspendue.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
JOBQ	File d'attente de travaux	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: File d'attente de travaux	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB

File d'attente de travaux (JOBQ)

Indique la file d'attente de travaux dont les postes actuels et futurs ne seront plus traités.

Ce paramètre est obligatoire.

Qualificateur 1 : File d'attente de travaux

nom: Indiquez le nom de la file d'attente de travaux à suspendre.

Qualificatif 2: Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB: La file d'attente de travaux est recherchée dans la bibliothèque en cours du travail. Si celle-ci ne figure pas dans la liste des bibliothèques, QGPL est prise par défaut.
nom: Indiquez le nom de la bibliothèque contenant la file d'attente de travaux.

Exemples

HLDJOBQ   JOBQ(QBATCH)

Cette commande permet d'empêcher le traitement des travaux se trouvant dans la file d'attente QBATCH et de tous les travaux qui sont ajoutés à cette file. Ils sont suspendus jusqu'à ce que la file d'attente soit libérée ou mise à blanc. Chaque travail peut également être arrêté par la commande ENDJOB, qui les supprime de la file d'attente de travaux.

Messages d'erreur

Messages *ESCAPE

CPF2207: Non autorisé à utiliser objet &1 de &3 type *&2.
CPF2240: Utilisateur &7 non autorisé à utiliser *&5 &6/&4.
CPF3307: File d'attente de travaux &1 de &2 non trouvée.
CPF3330: Ressource nécessaire non disponible.
CPF3425: File d'attente de travaux &1 de &2 déjà suspendue.