Aller au contenu

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

QSYS2.DB_TRANSACTION_JOURNAL_INFO

Journaux d'une transaction en cours

Affiche, pour une définition de validation (lock space), l'état des journaux sous contrôle de validation : modifications en attente et progression des annulations.

À quoi ça sert

La fonction de table QSYS2.DB_TRANSACTION_JOURNAL_INFO prend en paramètre un identifiant d'espace de verrouillage, LOCK_SPACE_ID, qu'on lit dans la colonne du même nom de la vue DB_TRANSACTION_INFO. Elle renvoie une ligne par journal utilisé par la transaction.

On y trouve le journal (bibliothèque et nom), le cycle de validation, le nombre de verrous d'enregistrements, les modifications en attente, ainsi que la progression en pourcentage de l'annulation des enregistrements, du nettoyage de l'index et du déverrouillage.

C'est utile pour suivre un rollback long : on voit combien il reste à annuler pour chaque journal.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT T.JOB_NAME, J.* FROM QSYS2.DB_TRANSACTION_INFO T, TABLE(QSYS2.DB_TRANSACTION_JOURNAL_INFO(T.LOCK_SPACE_ID)) J

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

JOB_NAME JOURNAL_LIBRARY Bibliothèque du journal JOURNAL_NAME Nom du journal COMMIT_CYCLE Cycle de validation RECORD_LOCKS Verrouillages d'enregistrements PENDING_CHANGES Modifications en attente RECORD_ROLLBACK_STARTED Annulation des enregistrements démarrée RECORD_ROLLBACK_PERCENT Pourcentage d'annulation des enregistrements INDEX_ENTRIES Entrées de l'index INDEX_CLEANUP_STARTED Nettoyage de l'index démarré INDEX_CLEANUP_PERCENT Pourcentage de nettoyage de l'index RECORD_UNLOCK_STARTED Déverrouillage des enregistrements démarré RECORD_UNLOCK_PERCENT Pourcentage de déverrouillage des enregistrements
000000/QSYS/SCPF QUSRSYS QPMCCCAJRN NULL 0 0 NULL NULL 0 NULL NULL NULL NULL
802224/QUSER/QSQSRVR QUSRDIRDB QSQJRN NULL 0 0 NULL NULL 0 NULL NULL NULL NULL
902100/QUSER/QSQSRVR QUSRSYS QPMCCCAJRN NULL 0 0 NULL NULL 0 NULL NULL NULL NULL
969321/QSYS/CRTPFRDTA QUSRSYS QPMCCCAJRN NULL 0 0 NULL NULL 0 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

Afficher l'état des ressources de journal sous contrôle de validation pour un identifiant d'espace de verrouillage donné.

-- Description: Show the status of journal resources under commitment control 
     --    for a specific lock space ID. 
    SELECT * FROM TABLE(QSYS2.DB_TRANSACTION_JOURNAL_INFO('UDB_010000000000A07F'));

Paramètres

ParamètreTypePar défautSignification
LOCK_SPACE_ID CHAR(20) obligatoire Identifiant de l'espace de verrouillage

Colonnes renvoyées (12)

Afficher les 12 colonnes
ColonneTypeSignification
JOURNAL_LIBRARY VARCHAR(10) Bibliothèque du journal
JOURNAL_NAME VARCHAR(10) Nom du journal
COMMIT_CYCLE DECIMAL(21, 0) Cycle de validation
RECORD_LOCKS BIGINT Verrouillages d'enregistrements
PENDING_CHANGES BIGINT Modifications en attente
RECORD_ROLLBACK_STARTED TIMESTAMP Annulation des enregistrements démarrée
RECORD_ROLLBACK_PERCENT INTEGER Pourcentage d'annulation des enregistrements
INDEX_ENTRIES INTEGER Entrées de l'index
INDEX_CLEANUP_STARTED TIMESTAMP Nettoyage de l'index démarré
INDEX_CLEANUP_PERCENT INTEGER Pourcentage de nettoyage de l'index
RECORD_UNLOCK_STARTED TIMESTAMP Déverrouillage des enregistrements démarré
RECORD_UNLOCK_PERCENT INTEGER Pourcentage de déverrouillage des enregistrements