Supprimer les files d'attente

La commande MQSC DELETE permet de supprimer une définition de file d'attente pour une file d'attente locale, modèle ou éloignée, ou un alias de file d'attente.

Utilisation des commandes MQSC

Pour plus d'informations sur l'utilisation des commandes MQSC, voir Administration d' IBM® MQ à l'aide de commandes MQSC.

Cette section contient les commandes suivantes:

[z/OS] Vous pouvez exécuter cette commande à partir de sources 2CR. Pour une explication des symboles source, voir Sources à partir desquelles vous pouvez émettre des commandes MQSC et PCF sur IBM MQ for z/OS®.

Remarques sur l'utilisation des files d'attente DELETE

L'exécution réussie de la commande ne signifie pas que l'action a abouti. Pour vérifier que l'exécution est vraie, voir l'étape DELETE queues dans Vérification que les commandes async pour les réseaux distribués sont terminées.

Description des paramètres des files d'attente DELETE

(nom-q)

Le nom de la file d'attente doit être défini dans le gestionnaire de files d'attente local pour tous les types de file d'attente.

Pour une file d'attente alias, il s'agit du nom local de la file d'attente alias à supprimer.

Pour une file d'attente modèle, il s'agit du nom local de la file d'attente modèle à supprimer.

Pour une file d'attente éloignée, il s'agit du nom local de la file d'attente éloignée à supprimer.

Pour une file d'attente locale, il s'agit du nom de la file d'attente locale à supprimer. Vous devez indiquer la file d'attente à supprimer.

Remarque: Une file d'attente ne peut pas être supprimée si elle contient des messages non validés.

Si cette file d'attente est ouverte dans une application ou si une file d'attente est éventuellement résolue dans cette file d'attente, la commande échoue. La commande échoue également si cette file d'attente est une file d'attente de transmission et que toute file d'attente qui est une file d'attente éloignée faisant référence à cette file d'attente de transmission ou qui est résolue en une file d'attente éloignée est ouverte.

Si cette file d'attente possède l'attribut SCOPE CELL, l'entrée de la file d'attente est également supprimée du répertoire de la cellule.

AUTHREC

Ce paramètre ne s'applique pas à z/OS.

Indique si l'enregistrement de droits d'accès associé est également supprimé:

YES: L'enregistrement de droits associé à l'objet est supprimé. Il s'agit de l'option par défaut.
NO: L'enregistrement de droits associé à l'objet n'est pas supprimé.

CMDSCOPE

Ce paramètre s'applique à z/OS uniquement et indique comment la commande s'exécute lorsque le gestionnaire de files d'attente est membre d'un groupe de partage de files d'attente.

CMDSCOPE doit être vide ou le gestionnaire de files d'attente local, si QSGDISP est défini sur GROUP ou SHARED.

' ': La commande s'exécute sur le gestionnaire de files d'attente dans lequel elle a été entrée. Il s'agit de la valeur par défaut.
qmgr-name: La commande s'exécute sur le gestionnaire de files d'attente que vous spécifiez, à condition que le gestionnaire de files d'attente soit actif dans le groupe de partage de files d'attente.
Vous pouvez spécifier un nom de gestionnaire de files d'attente, autre que le gestionnaire de files d'attente sur lequel la commande a été entrée, uniquement si vous utilisez un environnement de groupe de partage de files d'attente et si le serveur de commandes est activé.
*: La commande s'exécute sur le gestionnaire de files d'attente local et est également transmise à chaque gestionnaire de files d'attente actif du groupe de partage de files d'attente. Cela revient à entrer la commande sur chaque gestionnaire de files d'attente du groupe de partage de files d'attente.

PURGE et NOPURGE

Indique si les messages validés existants dans la file d'attente désignée par la commande DELETE doivent être purgés pour que la commande de suppression puisse fonctionner. La valeur par défaut est NOPURGE.

Purge: La suppression doit être effectuée même s'il existe des messages validés dans la file d'attente nommée, et ces messages doivent également être purgés.
NOPURGE: La suppression ne doit pas être effectuée s'il existe des messages validés dans la file d'attente nommée.

QSGDISP

Indique la disposition de l'objet auquel vous appliquez la commande (c'est-à-dire où elle est définie et comment elle se comporte). Si la définition d'objet est partagée, vous n'avez pas besoin de la supprimer sur chaque gestionnaire de files d'attente faisant partie d'un groupe de partage de files d'attente. (Les groupes de partage de files d'attente sont disponibles uniquement sous IBM MQ for z/OS.)

COPIER

La définition d'objet se trouve dans l'ensemble de pages du gestionnaire de files d'attente qui exécute la commande. L'objet a été défini à l'aide d'une commande comportant les paramètres QSGDISP (COPY). Tout objet résidant dans le référentiel partagé, ou tout objet défini à l'aide d'une commande comportant les paramètres QSGDISP (QMGR), n'est pas affecté par cette commande.

GROUPE

La définition d'objet se trouve dans le référentiel partagé. L'objet a été défini à l'aide d'une commande comportant les paramètres QSGDISP (GROUP). Tout objet résidant dans l'ensemble de pages du gestionnaire de files d'attente qui exécute la commande, ou tout objet défini à l'aide d'une commande dont les paramètres sont QSGDISP (SHARED), n'est pas affecté par cette commande.

Si la suppression aboutit, la commande suivante est générée et envoyée à tous les gestionnaires de files d'attente actifs du groupe de partage de files d'attente pour effectuer ou supprimer des copies locales sur l'ensemble de pages zéro:

DELETE queue(q-name) QSGDISP(COPY)

ou, pour une file d'attente locale uniquement:

DELETE QLOCAL(q-name) NOPURGE QSGDISP(COPY)

La suppression de l'objet de groupe prend effet même si la commande générée avec QSGDISP (COPY) échoue.

Remarque: Vous obtenez toujours l'option NOPURGE même si vous spécifiez PURGE. Pour supprimer des messages sur des copies locales des files d'attente, vous devez explicitement exécuter la commande suivante:

DELETE QLOCAL(q-name) QSGDISP(COPY) PURGE

pour chaque copie.

QMGR

La définition d'objet se trouve dans l'ensemble de pages du gestionnaire de files d'attente qui exécute la commande. L'objet a été défini à l'aide d'une commande comportant les paramètres QSGDISP (QMGR). Tout objet résidant dans le référentiel partagé, ou toute copie locale d'un tel objet, n'est pas affecté par cette commande.

Il s'agit de la valeur par défaut.

PARTAGÉ

Cette option s'applique uniquement aux files d'attente locales.

La définition d'objet se trouve dans le référentiel partagé. L'objet a été défini à l'aide d'une commande comportant les paramètres QSGDISP (SHARED). Tout objet résidant dans l'ensemble de pages du gestionnaire de files d'attente qui exécute la commande, ou tout objet défini à l'aide d'une commande comportant les paramètres QSGDISP (GROUP), n'est pas affecté par cette commande.

IGNSTATE

Indique si la commande échoue si la file d'attente n'existe pas. Les valeurs admises sont les suivantes :

NO: La commande échoue si la file d'attente n'existe pas. Il s'agit de la valeur par défaut.
YES: La commande aboutit, que la file d'attente existe ou non.