Service SQL IBM i (AS/400) · Vue
QSYS2.DATA_QUEUE_INFO
Informations sur les files de données
Renvoie les attributs des files de données (*DTAQ) : type, longueur maximale, nombre de messages courant et maximal, récupération automatique et file distante.
À quoi ça sert
La vue QSYS2.DATA_QUEUE_INFO décrit les files de données : type (DATA_QUEUE_TYPE), longueur maximale d'un message, ordre (SEQUENCE), longueur de clé, présence de l'identifiant de l'expéditeur, nombre actuel de messages (CURRENT_MESSAGES) et maximal, allocations de messages et dernière récupération. Pour une file distante, elle indique aussi la file, l'emplacement, la base relationnelle et le mode.
Les paramètres DATA_QUEUE_LIBRARY et DATA_QUEUE_NAME ciblent une file ; IGNORE_ERRORS vaut NO par défaut.
Elle remplace DSPDTAQ ou WRKDTAQ quand on veut surveiller la taille des files et déclencher une alerte lorsqu'une file se remplit.
Résultat réel sur un IBM i 7.5
Ce que nous avons exécuté :
SELECT * FROM QSYS2.DATA_QUEUE_INFOCe que l'IBM i a renvoyé le 01/10/2026 (5 lignes au plus) :
| DATA_QUEUE_LIBRARY Bibliothèque de la file de données | DATA_QUEUE_NAME Nom de la file de données | DATA_QUEUE_TYPE Type de la file de données | MAXIMUM_MESSAGE_LENGTH Longueur maximale d'un message | SEQUENCE Séquence | KEY_LENGTH Longueur de la clé | INCLUDE_SENDER_ID Inclure l'identifiant de l'expéditeur | CURRENT_MESSAGES Nombre actuel de messages | MAXIMUM_MESSAGES Nombre maximal de messages | SPECIFIED_MAXIMUM_MESSAGES Nombre maximal de messages spécifié | INITIAL_MESSAGE_ALLOCATION Allocation initiale de messages | CURRENT_MESSAGE_ALLOCATION Allocation courante de messages | FORCE Forcer l'opération | AUTOMATIC_RECLAIM Récupération automatique | LAST_RECLAIM_TIMESTAMP Horodatage de la dernière récupération | ENFORCE_DATA_QUEUE_LOCKS Application des verrous de la file de données | TEXT_DESCRIPTION Texte descriptif | REMOTE_DATA_QUEUE_LIBRARY Bibliothèque de la file de données distante | REMOTE_DATA_QUEUE File de données distante | REMOTE_LOCATION Emplacement distant | RELATIONAL_DATABASE_NAME Nom de la base de données relationnelle | APPC_DEVICE_DESCRIPTION Description d'unité APPC | LOCAL_LOCATION Emplacement local | MODE Mode | REMOTE_NETWORK_ID Identifiant du réseau distant |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| BIBAPP112 | DTAKIOU | STANDARD | 144 | FIFO | NULL | NO | 0 | 104848 | -1 | 16 | 16 | NO | NO | NULL | NO | Description de l'objet | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL |
| BIBAPP112 | MYDATAQ | STANDARD | 512 | FIFO | NULL | NO | 0 | 31760 | -1 | 16 | 16 | NO | NO | NULL | NO | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL |
| BIBAPP112 | MYDTAQ | STANDARD | 512 | FIFO | NULL | NO | 0 | 31760 | -1 | 16 | 16 | NO | NO | NULL | NO | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL |
| BIBAPP136 | CLAUDEIN | STANDARD | 2000 | FIFO | NULL | NO | 0 | 8272 | -1 | 16 | 16 | NO | NO | NULL | NO | Description de l'objet | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL |
| BIBAPP136 | CLAUDEOUT | STANDARD | 2000 | FIFO | NULL | NO | 0 | 8272 | -1 | 16 | 16 | NO | NO | NULL | NO | Description de l'objet | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL |
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
Trouver le nombre de messages actuellement présents dans la file de données DQ1 de TESTLIB.
-- Description: Find the number of messages currently on data queue DQ1 in TESTLIB.
SELECT CURRENT_MESSAGES FROM QSYS2.DATA_QUEUE_INFO
WHERE DATA_QUEUE_LIBRARY = 'TESTLIB' and DATA_QUEUE_NAME = 'DQ1';Bon à savoir
Comparez CURRENT_MESSAGES à MAXIMUM_MESSAGES dans une requête planifiée : une file qui ne cesse de grossir signale souvent un programme consommateur arrêté.
Paramètres
| Paramètre | Type | Par défaut | Signification |
|---|---|---|---|
DATA_QUEUE_LIBRARY |
VARCHAR(10) | obligatoire | Bibliothèque de la file de données |
DATA_QUEUE_NAME |
VARCHAR(10) | obligatoire | Nom de la file de données |
IGNORE_ERRORS |
VARCHAR(3) | 'NO' | Ignorer les erreurs |
Colonnes renvoyées (25)
Afficher les 25 colonnes
| Colonne | Type | Signification |
|---|---|---|
DATA_QUEUE_LIBRARY |
VARCHAR(10) | Bibliothèque de la file de données |
DATA_QUEUE_NAME |
VARCHAR(10) | Nom de la file de données |
DATA_QUEUE_TYPE |
VARCHAR(8) | Type de la file de données |
MAXIMUM_MESSAGE_LENGTH |
INTEGER | Longueur maximale d'un message |
SEQUENCE |
VARCHAR(5) | Séquence |
KEY_LENGTH |
INTEGER | Longueur de la clé |
INCLUDE_SENDER_ID |
VARCHAR(3) | Inclure l'identifiant de l'expéditeur |
CURRENT_MESSAGES |
INTEGER | Nombre actuel de messages |
MAXIMUM_MESSAGES |
INTEGER | Nombre maximal de messages |
SPECIFIED_MAXIMUM_MESSAGES |
INTEGER | Nombre maximal de messages spécifié |
INITIAL_MESSAGE_ALLOCATION |
INTEGER | Allocation initiale de messages |
CURRENT_MESSAGE_ALLOCATION |
INTEGER | Allocation courante de messages |
FORCE |
VARCHAR(3) | Forcer l'opération |
AUTOMATIC_RECLAIM |
VARCHAR(3) | Récupération automatique |
LAST_RECLAIM_TIMESTAMP |
TIMESTAMP | Horodatage de la dernière récupération |
ENFORCE_DATA_QUEUE_LOCKS |
VARCHAR(3) | Application des verrous de la file de données |
TEXT_DESCRIPTION |
VARCHAR(50) | Texte descriptif |
REMOTE_DATA_QUEUE_LIBRARY |
VARCHAR(10) | Bibliothèque de la file de données distante |
REMOTE_DATA_QUEUE |
VARCHAR(10) | File de données distante |
REMOTE_LOCATION |
VARCHAR(8) | Emplacement distant |
RELATIONAL_DATABASE_NAME |
VARCHAR(18) | Nom de la base de données relationnelle |
APPC_DEVICE_DESCRIPTION |
VARCHAR(10) | Description d'unité APPC |
LOCAL_LOCATION |
VARCHAR(8) | Emplacement local |
MODE |
VARCHAR(8) | Mode |
REMOTE_NETWORK_ID |
VARCHAR(8) | Identifiant du réseau distant |