CLRMSGQ
Mettre à blanc file de message
En bref
La commande CLRMSGQ (Mettre à blanc une file d'attente de messages) permet d'effacer (retirer) tous les messages d'une file d'attente de messages indiquée.
CLRMSGQ se lit CLR
(Effacer) + MSGQ.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
CLRMSGQ MSGQ(…)Paramètres
Astuce : dans une session 5250, tapez CLRMSGQ 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 CLRMSGQ (Mettre à blanc une file d'attente de messages) permet d'effacer (retirer) tous les messages d'une file d'attente de messages indiquée. Une fois effacés, ces derniers ne peuvent plus être affichés ou imprimés. Si la file d'attente de messages n'est pas allouée à un travail, cette commande permet de le faire de manière implicite pendant la durée de son exécution. Si la file d'attente de messages indiquée est *WRKSTN ou une file d'attente de messages du poste de travail, elle n'est pas allouée et elle est effacée, même si la description d'unité du poste de travail est allouée à un autre travail.
Restriction : Vous devez disposer des droits de modification (*CHANGE) de la file d'attente des messages et d'utilisation (*USE) de la bibliothèque où elle est stockée.
File attente messages (MSGQ)
Indique le nom de la file d'attente de messages à mettre à blanc. Si un nom de file d'attente de messages spécifique associé au qualificatif de bibliothèque *LIBL est indiqué, seule la première file d'attente contenant ce nom est mise à blanc.
Ce paramètre est obligatoire.
Qualificatif 1 : File attente messages
- *WRKSTN
- Met à blanc la file d'attente de messages du poste de travail. Cette fonction n'est pas possible en mode de traitement par lots.
- nom-file-attente-messages
- Entrez le nom de la file d'attente de messages à mettre à blanc.
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 recherche de la file d'attente de messages à mettre à blanc s'effectue dans l'unité d'exécution de la bibliothèque en cours. Si cette bibliothèque n'est pas définie dans la liste des bibliothèques, QGPL est prise par défaut.
- nom-bibliothèque
- Indiquez le nom de la bibliothèque contenant la file d'attente de messages. La recherche s'effectuera uniquement dans cette bibliothèque.
Mise à blanc (CLEAR)
Indique les messages à supprimer de la file d'attente.
- *ALL
- Met à blanc la file d'attente de messages. S'il subsiste dans la file d'attente un ou plusieurs messages restés sans réponse, la réponse par défaut correspondant à chacun d'eux est envoyée avant leur suppression.
- *KEEPUNANS
- Supprime tous les messages de la file d'attente indiquée, à l'exception des messages d'interrogation restés sans réponse et des messages de copie d'émetteur.
Exemples
Exemple 1 : Suppression de tous les messages
CLRMSGQ MSGQ(*CURLIB/MQFIN) CLEAR(*ALL)
Cette commande supprime tous les messages de la file d'attente MQFIN qui se trouve dans la bibliothèque en cours du travail.
Exemple 2 : Conservation des messages restés sans réponse
CLRMSGQ MSGQ(*CURLIB/MQFIN) CLEAR(*KEEPUNANS)
Cette commande supprime tous les messages de la file d'attente MQFIN qui se trouve dans la bibliothèque en cours du travail, à l'exception de ceux qui sont restés sans réponse.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.