DLTOUTQ

Supprimer une file de sortie

En bref

La commande DLTOUTQ (Supprimer une file d'attente en sortie) permet de supprimer du système la ou les files d'attente en sortie indiquées.

DLTOUTQ se lit DLT (Supprimer) + OUTQ. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

DLTOUTQ OUTQ(…)

Paramètres

OUTQ File d'attente en sortie obligatoire

Astuce : dans une session 5250, tapez DLTOUTQ 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 DLTOUTQ (Supprimer une file d'attente en sortie) permet de supprimer du système la ou les files d'attente en sortie indiquées.

Restrictions :

La file en cours de suppression ne doit contenir aucun poste : la sortie de chaque fichier doit être imprimée, supprimée ou placée dans une autre file d'attente.
Aucun sous-système ne peut être actif.
La file ne doit pas être en cours d'utilisation par un éditeur de spoule.
La file ne peut pas être supprimée si elle a été créée par le système pour une imprimante spécifique.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
OUTQ	File d'attente en sortie	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: File d'attente en sortie	Nom générique, nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB, USRLIBL, ALL, *ALLUSR

File d'attente en sortie (OUTQ)

Indique la ou les files d'attente de travaux à supprimer. Vous pouvez indiquer une file d'attente en sortie spécifique ou générique ; chacun de ces types peut être qualifié par un nom de bibliothèque.

Ce paramètre est obligatoire.

Qualificatif 1 : File d'attente en sortie

nom-générique: Indiquez le nom générique dess files d'attente de travaux à supprimer. Un nom générique est une chaîne de caractères contenant un ou plusieurs caractères suivis d'un astérisque (*) ('AR*' par exemple). Si un nom générique est indiqué, toutes les files d'attente en sortie dont les noms ont le même préfixe sont supprimées. Les bibliothèques dans lesquelles s'effectue la recherche des files d'attente en sortie à supprimer dépendent du qualifiant bibliothèque indiqué ou pris par défaut.
nom: Indiquez le nom de la file d'attente de travaux à supprimer.

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.

*USRLIBL: S'il existe un poste de bibliothèque en cours dans la liste des bibliothèques de l'unité d'exécution en cours, la recherche porte sur celle-ci ainsi que sur les bibliothèques de la partie utilisateur de la liste des bibliothèques. Dans le cas contraire, la recherche porte uniquement sur les bibliothèques de la partie utilisateur de la liste des bibliothèques.

*ALL: La recherche porte sur toutes les bibliothèques du système, y compris QSYS.

*ALLUSR

La recherche porte sur toutes les bibliothèques utilisateur. La recherche porte sur toutes les bibliothèques dont le nom ne commence pas par la lettre Q, à l'exception des bibliothèques suivantes :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques Qxxx suivantes soient fournies par IBM, elles contiennent généralement des données utilisateur qui sont fréquemment modifiées. Par conséquent, ces bibliothèques sont considérées comme des bibliothèques utilisateur et sont donc recherchées :

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2xxxxx  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

'xxxxx' représente le numéro de l'ASP principal.
L'utilisateur peut créer une bibliothèque de nom différent, au format QUSRVxRxMx, pour chacune des éditions précédentes prises en charge par IBM, afin d'y stocker les commandes utilisateur à compiler dans un programme CL pour une édition précédente. En ce qui concerne la bibliothèque utilisateur QUSRVxRxMx, VxRxMx correspond à une version, édition et niveau de modification précédents encore admis par IBM.

*CURLIB: La file d'attente en sortie 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 en sortie.

Exemples

DLTOUTQ   OUTQ(PUNCH2)

Cette commande permet de supprimer du système la file d'attente en sortie PUNCH2.

Messages d'erreur

Messages *ESCAPE

CPF1763: Impossible d'allouer une ou plusieurs bibliothèques.
CPF2105: Objet &1 de &2 type *&3 non trouvé.
CPF2110: Bibliothèque &1 non trouvée.
CPF2117: &4 objet(s) de type *&3 supprimé(s). &5 objet(s) non supprimé(s).
CPF2182: Non autorisé à utiliser la bibliothèque &1.
CPF2207: Non autorisé à utiliser objet &1 de &3 type *&2.
CPF3330: Ressource nécessaire non disponible.
CPF3360: File d'attente en sortie &1 de &2 non supprimée. En cours d'utilisation.
CPF3467: File d'attente en sortie &1 supprimée, puis recréée.
CPF3469: Opération non admise pour cette file d'attente en sortie.