Service SQL IBM i (AS/400) · Fonction table
SYSTOOLS.AUDIT_JOURNAL_JS
Journal d'audit : actions sur les travaux (JS)
Lit les entrées JS du journal d'audit : actions sur les travaux (fin, suspension, changement), avec le travail cible et les profils concernés.
À quoi ça sert
Cette fonction de table lit les entrées de type JS du journal d'audit, écrites quand une action est menée sur un travail : arrêt avec ENDJOB ou ENDJOBABN, modification avec CHGJOB, etc. On y trouve le travail cible (TARGET_QUALIFIED_JOB_NAME, TARGET_JOB_NAME…), le type de travail et les profils en vigueur (EFFECTIVE_USER_PROFILE, REAL_USER_PROFILE…).
Elle répond à la question : qui a arrêté ce travail ? L'exemple d'IBM sélectionne les travaux arrêtés aujourd'hui par ENDJOB ou ENDJOBABN, en filtrant sur ENTRY_TYPE.
Les paramètres sont facultatifs et communs à toutes les fonctions d'audit.
Résultat réel sur un IBM i 7.5
Ce que nous avons exécuté :
SELECT * FROM TABLE(SYSTOOLS.AUDIT_JOURNAL_JS(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 travaux qui ont été arrêtés aujourd'hui avec les commandes CL ENDJOB ou ENDJOBABN.
-- Description: List jobs that were ended today with the ENDJOB or ENDJOBABN CL commands.
SELECT * FROM TABLE(
SYSTOOLS.AUDIT_JOURNAL_JS(
STARTING_TIMESTAMP => CURRENT DATE))
WHERE ENTRY_TYPE IN ('A', 'N' );
Bon à savoir
Ces entrées existent si l'audit des actions sur les travaux (*JOBDTA) est activé pour l'utilisateur ou le système. Le détail des colonnes TARGET_* permet de retrouver le travail dans l'historique avec QSYS2.JOBLOG_INFO.
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 (69)
Afficher les 69 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 |
JOB_TYPE |
VARCHAR(3) | Type de travail |
JOB_TYPE_BASIC |
CHAR(1) | Type de travail (de base) |
JOB_SUBTYPE |
CHAR(1) | Sous-type du travail |
TARGET_QUALIFIED_JOB_NAME |
VARCHAR(28) | Nom qualifié du travail cible |
TARGET_JOB_NAME |
VARCHAR(10) | Nom du travail cible |
TARGET_JOB_USER |
VARCHAR(10) | Utilisateur du travail cible |
TARGET_JOB_NUMBER |
VARCHAR(6) | Numéro du travail cible |
DEVICE_NAME |
VARCHAR(10) | Nom de l'unité |
EFFECTIVE_USER_PROFILE |
VARCHAR(10) | Profil utilisateur effectif |
EFFECTIVE_GROUP_PROFILE |
VARCHAR(10) | Profil de groupe effectif |
SUPPLEMENTAL_GROUP_PROFILES |
VARCHAR(150) | Profils des groupes supplémentaires |
REAL_USER_PROFILE |
VARCHAR(10) | Profil de l'utilisateur réel |
SAVED_USER_PROFILE |
VARCHAR(10) | Profil de l'utilisateur sauvegardé |
REAL_GROUP_PROFILE |
VARCHAR(10) | Profil du groupe réel |
SAVED_GROUP_PROFILE |
VARCHAR(10) | Profil du groupe sauvegardé |
REAL_USER_CHANGED |
VARCHAR(3) | Utilisateur réel modifié |
EFFECTIVE_USER_CHANGED |
VARCHAR(3) | Utilisateur effectif modifié |
SAVED_USER_CHANGED |
VARCHAR(3) | Utilisateur sauvegardé modifié |
REAL_GROUP_CHANGED |
VARCHAR(3) | Groupe réel modifié |
EFFECTIVE_GROUP_CHANGED |
VARCHAR(3) | Groupe effectif modifié |
SAVED_GROUP_CHANGED |
VARCHAR(3) | Groupe sauvegardé modifié |
SUPPLEMENTAL_GROUPS_CHANGED |
VARCHAR(3) | Groupes supplémentaires modifiés |
JOB_DESCRIPTION_LIBRARY |
VARCHAR(10) | Bibliothèque de la description de travail |
JOB_DESCRIPTION |
VARCHAR(10) | Description de travail |
JOB_DESCRIPTION_ASP_NAME |
VARCHAR(10) | Nom de l'ASP de la description de travail |
JOB_DESCRIPTION_ASP_NUMBER |
INTEGER | Numéro de l'ASP de la description de travail |
JOB_QUEUE_LIBRARY |
VARCHAR(10) | Bibliothèque de la file d'attente des travaux |
JOB_QUEUE_NAME |
VARCHAR(10) | Nom de la file d'attente des travaux |
JOB_QUEUE_ASP_NAME |
VARCHAR(10) | Nom de l'ASP de la file d'attente des travaux |
JOB_QUEUE_ASP_NUMBER |
INTEGER | Numéro de l'ASP de la file d'attente des travaux |
OUTPUT_QUEUE_LIBRARY |
VARCHAR(10) | Bibliothèque de la file d'attente de sortie |
OUTPUT_QUEUE_NAME |
VARCHAR(10) | Nom de la file d'attente de sortie |
PRINTER_DEVICE |
VARCHAR(10) | Unité d'impression |
TIME_ZONE_DESCRIPTION_NAME |
VARCHAR(10) | Nom de la description du fuseau horaire |
THREAD_ASP_NAME |
VARCHAR(10) | Nom de l'ASP de l'unité d'exécution |
LIBRARY_LIST_COUNT |
INTEGER | Nombre de bibliothèques de la liste |
LIBRARY_LIST |
VARCHAR(2680) | Liste de bibliothèques |
JOB_USER_IDENTITY_DESCRIPTION |
VARCHAR(5) | Description de l'identité utilisateur du travail |
JOB_USER_IDENTITY |
VARCHAR(10) | Identité utilisateur du travail |
WORKLOAD_GROUP |
VARCHAR(10) | Groupe de charge de travail |
EXIT_QUALIFIED_JOB_NAME |
VARCHAR(28) | Nom qualifié du travail du programme de sortie |
EXIT_JOB_NAME |
VARCHAR(10) | Nom du travail du programme de sortie |
EXIT_JOB_USER |
VARCHAR(10) | Utilisateur du travail du programme de sortie |
EXIT_JOB_NUMBER |
VARCHAR(6) | Numéro du travail du programme de sortie |
EXIT_PROGRAM_LIBRARY |
VARCHAR(10) | Bibliothèque du programme de sortie |
EXIT_PROGRAM |
VARCHAR(10) | Programme de sortie |