Aller au contenu

Service SQL IBM i (AS/400) · Fonction table

QSYS2.WATCH_DETAIL

Détail des surveillances actives

Fonction de table qui détaille ce que surveille une session de surveillance : messages, entrées du journal interne et alertes, avec les valeurs de comparaison.

À quoi ça sert

WATCH_DETAIL renvoie le détail des critères d'une session de surveillance (watch) identifiée par SESSION_ID. On y trouve le type de détail, et, selon le cas, l'identifiant, le type, la file d'attente de messages, le travail d'origine et la gravité des messages surveillés, ainsi que les codes et données de comparaison du journal interne sous licence (LIC_*) et des alertes (PAL_*).

On l'associe à WATCH_INFO pour savoir pourquoi une surveillance se déclenche. L'exemple d'IBM joint les deux pour lister, avec leur détail, les surveillances démarrées par le profil courant avec STRWCH.

Elle sert à auditer ce que surveillent les programmes de surveillance en place.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT * FROM TABLE(QSYS2.WATCH_DETAIL()) X

Pas de résultat : la fonction demande l'identifiant d'une session de surveillance active (STRWCH).

L'exemple d'IBM

Lister toutes les surveillances démarrées par mon profil avec la commande STRWCH, avec leur détail.

-- Description: List all the watches that my user profile started with the 
    STRWCH command including the detailed information. 
    SELECT * FROM QSYS2.WATCH_INFO W, TABLE(QSYS2.WATCH_DETAIL(W.SESSION_ID)) D 
       WHERE W.WATCH_SESSION_TYPE = '*STRWCH' AND W.USER_ID = USER;

Paramètres

ParamètreTypePar défautSignification
SESSION_ID VARCHAR(10) 'YES' Identifiant de session

Colonnes renvoyées (20)

Afficher les 20 colonnes
ColonneTypeSignification
DETAIL_TYPE VARCHAR(7) Type de détail
COMPARISON_DATA_CCSID INTEGER CCSID des données de comparaison
MESSAGE_ID VARCHAR(7) Identifiant du message
MESSAGE_TYPE VARCHAR(6) Type de message
MESSAGE_QUEUE_LIBRARY VARCHAR(10) Bibliothèque de la file de messages
MESSAGE_QUEUE VARCHAR(10) File de messages
MESSAGE_JOB_NAME VARCHAR(10) Nom du travail du message
MESSAGE_JOB_USER VARCHAR(10) Profil utilisateur du travail du message
MESSAGE_JOB_NUMBER VARCHAR(6) Numéro du travail du message
MESSAGE_SEVERITY INTEGER Gravité du message
MESSAGE_RELATIONAL_OPERATOR VARCHAR(4) Opérateur de comparaison du message
MESSAGE_COMPARISON_DATA VARCHAR(72) Données de comparaison du message
MESSAGE_COMPARE_AGAINST VARCHAR(8) Zone du message à comparer
LIC_MAJOR_CODE VARCHAR(4) Code majeur du code interne sous licence
LIC_MINOR_CODE VARCHAR(4) Code mineur du code interne sous licence
LIC_COMPARISON_DATA VARCHAR(72) Données de comparaison du code interne sous licence
LIC_COMPARE_AGAINST VARCHAR(9) Valeur de comparaison du code interne sous licence
PAL_SYSTEM_REFERENCE_CODE VARCHAR(8) Code de référence système de l'entrée PAL
PAL_COMPARISON_DATA VARCHAR(10) Données de comparaison de l'entrée PAL
PAL_COMPARE_AGAINST VARCHAR(9) Valeur de comparaison de l'entrée PAL