QSYS2.CLEAR_DATA_QUEUE

À quoi ça sert

Cette procédure vide la file de données DATA_QUEUE de la bibliothèque DATA_QUEUE_LIBRARY ('*LIBL' par défaut). Pour une file à clé, KEY_DATA et KEY_ORDER limitent la suppression aux entrées qui correspondent à la clé selon l'ordre de comparaison indiqué.

Les entrées supprimées sont perdues : à réserver à la remise à zéro d'une file de test ou à la purge d'une file bloquée. Pour consulter le contenu avant de vider, utilisez QSYS2.DATA_QUEUE_ENTRIES.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

CALL QSYS2.SEND_DATA_QUEUE(MESSAGE_DATA => 'Message qui va être effacé', DATA_QUEUE => 'DEMODQ2', DATA_QUEUE_LIBRARY => 'JOBISQL');
CALL QSYS2.CLEAR_DATA_QUEUE(DATA_QUEUE => 'DEMODQ2', DATA_QUEUE_LIBRARY => 'JOBISQL');
SELECT DATA_QUEUE_LIBRARY, DATA_QUEUE_NAME, CURRENT_MESSAGES, MAXIMUM_MESSAGE_LENGTH FROM QSYS2.DATA_QUEUE_INFO WHERE DATA_QUEUE_LIBRARY = 'JOBISQL'

Ce que l'IBM i a renvoyé le 01/10/2026 (3 lignes au plus) :

Données anonymisées : les noms de système, de profils, de bibliothèques, de postes et les adresses IP ont été remplacés. Les objets du schéma JOBISQL sont des objets de démonstration créés pour ce site.

L'exemple d'IBM

Supprimer toutes les entrées de la file de données DQ1 de la bibliothèque TESTLIB.

-- Description: Clear all entries from data queue DQ1 in library TESTLIB. 
    CALL QSYS2.CLEAR_DATA_QUEUE('DQ1', 'TESTLIB');

Paramètres