Service SQL IBM i (AS/400) · Fonction table
SYSTOOLS.AUDIT_JOURNAL_M7
Journal d'audit : réplication Db2 Mirror (M7)
Lit les entrées M7 du journal d'audit : critères de réplication de Db2 Mirror for i (règles d'inclusion, bibliothèques, objets, versions).
À quoi ça sert
Cette fonction de table lit les entrées de type M7 du journal d'audit, relatives aux critères de réplication de Db2 Mirror for i. On y trouve l'action (ACTION, ACTION_DETAIL), la règle (RULE_IDENTIFIER, INCLUSION_STATE), l'IASP, la bibliothèque, le type et le nom d'objet, ainsi que des informations de version et le nombre d'objets ou de lignes affectés.
Elle ne sert que si Db2 Mirror (option 48 de 5770SS1) est configuré. Elle permet de savoir quelle bibliothèque ou quel objet a été ajouté ou retiré de la réplication, par qui et quand : un point sensible, car un objet non répliqué est absent du second nœud.
Les paramètres de sélection sont facultatifs et communs aux fonctions d'audit. L'exemple d'IBM filtre sur la bibliothèque APPLIB1 pour la dernière semaine.
Résultat réel sur un IBM i 7.5
Ce que nous avons exécuté :
SELECT * FROM TABLE(SYSTOOLS.AUDIT_JOURNAL_M7(STARTING_TIMESTAMP => CURRENT TIMESTAMP - 90 DAYS)) X
Aucune entrée de ce type dans le journal d'audit sur les 90 derniers jours : ce type d'événement n'est pas audité ou ne s'est pas produit sur notre IBM i de test.
L'exemple d'IBM
Lister les changements de réplication qui ont touché la bibliothèque APPLIB1 durant cette semaine.
-- Description: List any replication changes that affected APPLIB1 this week.
SELECT * FROM TABLE(
SYSTOOLS.AUDIT_JOURNAL_M7(
STARTING_TIMESTAMP => CURRENT TIMESTAMP - 7 DAYS ))
WHERE LIBRARY_NAME = 'APPLIB1';
Bon à savoir
Sans Db2 Mirror, la fonction ne renvoie normalement aucune ligne.
Paramètres
| Paramètre | Type | Par défaut | Signification |
|---|---|---|---|
STARTING_RECEIVER_NAME |
VARCHAR(10) | '*CURAVLCHN' | Nom du récepteur de journal de départ |
ENDING_RECEIVER_NAME |
VARCHAR(10) | '*CURRENT' | Nom du récepteur de journal de fin |
STARTING_TIMESTAMP |
TIMESTAMP | NULL | Horodatage de début |
ENDING_TIMESTAMP |
TIMESTAMP | NULL | Horodatage de fin |
USER_NAME |
VARCHAR(10) | '*ALL' | Nom du profil utilisateur |
JOB |
VARCHAR(28) | '*ALL' | Nom qualifié du travail |
PROGRAM |
VARCHAR(10) | '*ALL' | Programme |
STARTING_SEQUENCE |
DECIMAL(21, 0) | NULL | Numéro de séquence de départ |
ENDING_SEQUENCE |
DECIMAL(21, 0) | NULL | Numéro de séquence de fin |
STARTING_RECEIVER_LIBRARY |
VARCHAR(10) | '*CURRENT' | Bibliothèque du récepteur de journal de départ |
ENDING_RECEIVER_LIBRARY |
VARCHAR(10) | '*CURRENT' | Bibliothèque du récepteur de journal de fin |
Colonnes renvoyées (42)
Afficher les 42 colonnes
| Colonne | Type | Signification |
|---|---|---|
ENTRY_TIMESTAMP |
TIMESTAMP | Horodatage de l'entrée |
SEQUENCE_NUMBER |
DECIMAL(21, 0) | Numéro de séquence |
USER_NAME |
VARCHAR(10) | Nom du profil utilisateur |
QUALIFIED_JOB_NAME |
VARCHAR(28) | Nom qualifié du travail |
JOB_NAME |
VARCHAR(10) | Nom du travail |
JOB_USER |
VARCHAR(10) | Profil utilisateur du travail |
JOB_NUMBER |
VARCHAR(6) | Numéro du travail |
THREAD |
BIGINT | Unité d'exécution (thread) |
PROGRAM_LIBRARY |
VARCHAR(10) | Bibliothèque du programme |
PROGRAM_NAME |
VARCHAR(10) | Nom du programme |
PROGRAM_LIBRARY_ASP_DEVICE |
VARCHAR(10) | Unité ASP de la bibliothèque du programme |
PROGRAM_LIBRARY_ASP_NUMBER |
INTEGER | Numéro de l'ASP de la bibliothèque du programme |
REMOTE_PORT |
INTEGER | Port distant |
REMOTE_ADDRESS |
VARCHAR(46) | Adresse distante |
SYSTEM_NAME |
VARCHAR(8) | Nom du système |
SYSTEM_SEQUENCE_NUMBER |
DECIMAL(21, 0) | Numéro de séquence système |
RECEIVER_LIBRARY |
VARCHAR(10) | Bibliothèque du récepteur de journal |
RECEIVER_NAME |
VARCHAR(10) | Nom du récepteur de journal |
RECEIVER_ASP_DEVICE |
VARCHAR(10) | Unité ASP du récepteur de journal |
RECEIVER_ASP_NUMBER |
INTEGER | Numéro d'ASP du récepteur de journal |
ARM_NUMBER |
INTEGER | Numéro ARM |
ENTRY_TYPE |
CHAR(1) | Type de l'entrée |
ENTRY_TYPE_DETAIL |
VARCHAR(200) | Détail du type de l'entrée |
ACTION |
VARCHAR(7) | Action à exécuter |
ACTION_DETAIL |
VARCHAR(200) | Détail de l'action |
RULE_IDENTIFIER |
BIGINT | Identifiant de la règle |
INCLUSION_STATE |
VARCHAR(10) | État d'inclusion |
IASP_NAME |
VARCHAR(10) | Nom de l'ASP indépendant |
LIBRARY_NAME |
VARCHAR(10) | Nom de la bibliothèque |
OBJECT_TYPE |
VARCHAR(8) | Type de l'objet |
OBJECT_NAME |
VARCHAR(10) | Nom de l'objet |
ORIGINAL_LIBRARY_NAME |
VARCHAR(10) | Nom d'origine de la bibliothèque |
SYSTEM_VALUE |
VARCHAR(10) | Valeur système |
ENVIRONMENT_VARIABLE |
VARCHAR(128) | Variable d'environnement |
APPLY_LABEL |
VARCHAR(26) | Libellé d'application |
NUMBER_OF_OBJECTS |
BIGINT | Nombre d'objets |
AFFECTED_ROWS |
BIGINT | Nombre de lignes affectées |
VERSION_ENTRY_NUMBER |
BIGINT | Numéro d'entrée de la version |
VERSION_GROUP |
VARCHAR(10) | Groupe de versions |
VERSION_NAME |
VARCHAR(30) | Nom de la version |
VERSION_IDENTIFIER |
VARCHAR(11) | Identifiant de la version |
VERSION_ACTIVATION_TIME |
VARCHAR(9) | Heure d'activation de la version |