QSYS2.MESSAGE_QUEUE_INFO

À quoi ça sert

Ce service existe sous deux formes, une vue et une fonction de table. Il renvoie une ligne par message : bibliothèque et nom de la file, identifiant, type, sous-type, texte, gravité, horodatage, clé du message et clé du message associé, utilisateur, travail et programme d'origine, fichier de messages, etc.

Quatre paramètres filtrent à la source : QUEUE_LIBRARY (défaut QSYS), QUEUE_NAME (défaut QSYSOPR), MESSAGE_FILTER (défaut ALL) et SEVERITY_FILTER (défaut 0). Dans l'exemple d'IBM de la fonction, MESSAGE_FILTER => 'INQUIRY' ne garde que les messages d'interrogation auxquels personne n'a encore répondu, ce qui est la façon la plus rapide de repérer un travail bloqué en attente de réponse.

L'exemple d'IBM de la vue recherche dans QSYSOPR les messages relatifs à l'expiration de licences. Le SQL permet de filtrer sur un texte, de compter les messages par gravité, d'alimenter une supervision, ou d'envoyer une alerte.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT MESSAGE_ID, MESSAGE_TEXT, MESSAGE_TIMESTAMP FROM TABLE(QSYS2.MESSAGE_QUEUE_INFO(QUEUE_LIBRARY => 'JOBISQL', QUEUE_NAME => 'DEMOMSGQ'))

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

Passer en revue les messages d'expiration de licence dans la file du système opérateur, ou renvoyer la liste des messages d'interrogation de QSYSOPR sans réponse.

-- Description: Review system operator license expiration messages 
SELECT MESSAGE_TEXT, M.* 
   FROM QSYS2.MESSAGE_QUEUE_INFO M 
   WHERE MESSAGE_QUEUE_NAME = 'QSYSOPR' AND 
         MESSAGE_TEXT LIKE '%EXPIRE%';

-- Description: Return a list of inquiry messages in QSYSOPR that have not been replied to 
 SELECT MESSAGE_ID, MESSAGE_TEXT, MESSAGE_TIMESTAMP 
  FROM TABLE(QSYS2.MESSAGE_QUEUE_INFO(MESSAGE_FILTER => 'INQUIRY'));

Paramètres

Colonnes renvoyées (17)