QSYS2.RECEIVE_DATA_QUEUE

À quoi ça sert

Cette fonction de table reçoit un message d'une file de données, comme le fait un programme avec l'API de réception. Elle renvoie les données du message en caractères (MESSAGE_DATA), en UTF-8 (MESSAGE_DATA_UTF8) et en binaire (MESSAGE_DATA_BINARY), ainsi que la clé et l'identité de l'émetteur (SENDER_JOB_NAME, SENDER_CURRENT_USER).

Les paramètres DATA_QUEUE et DATA_QUEUE_LIBRARY désignent la file (bibliothèque *LIBL par défaut). REMOVE vaut YES par défaut : l'entrée est alors retirée de la file. WAIT_TIME fixe le temps d'attente, KEY_DATA et KEY_ORDER permettent de ne lire que les entrées dont la clé correspond, pour une file à clé.

Elle est utile pour tester ou dépanner une file de données depuis une session SQL, ou pour consommer des messages depuis un langage qui ne dispose pas d'API native. Le pendant côté émission est QSYS2.SEND_DATA_QUEUE.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

CALL QSYS2.SEND_DATA_QUEUE(MESSAGE_DATA => 'Message lu puis retiré par RECEIVE_DATA_QUEUE', DATA_QUEUE => 'DEMODQ2', DATA_QUEUE_LIBRARY => 'JOBISQL');
SELECT * FROM TABLE(QSYS2.RECEIVE_DATA_QUEUE(DATA_QUEUE => 'DEMODQ2', DATA_QUEUE_LIBRARY => 'JOBISQL')) X

Ce que l'IBM i a renvoyé le 01/10/2026 (1 ligne 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

Récupérer le message de la file de données DQ1 de la bibliothèque TESTLIB dont la clé vaut 456.

-- Description: Get the message from data queue DQ1 in TESTLIB with key 456. 
     SELECT * FROM TABLE(QSYS2.RECEIVE_DATA_QUEUE('DQ1', 'TESTLIB', 
                 KEY_DATA => '456', KEY_ORDER => 'EQ'));

Paramètres

Colonnes renvoyées (6)