Service SQL IBM i (AS/400) · Fonction table
SYSTOOLS.AUDIT_JOURNAL_PF
Journal d'audit : opérations sur les PTF (PF)
Lit les entrées PF du journal d'audit : opérations sur les PTF (installation, application, retrait), avec produit, PTF, option et action en attente.
À quoi ça sert
Cette fonction de table lit les entrées de type PF du journal d'audit, écrites par les opérations de maintenance des PTF : chargement, application, retrait. ENTRY_ACTION et ENTRY_ACTION_DETAIL décrivent l'action. Elle donne aussi le produit (PRODUCT_ID), son niveau de version, l'identifiant de la PTF (PTF_IDENTIFIER), l'option, l'état d'action en attente et l'action à la prochaine IPL.
On s'en sert pour documenter l'historique de maintenance : qui a appliqué des PTF, à quelle date, et dans quel ordre. Elle sert aussi à repérer des opérations non prévues dans la fenêtre de maintenance.
L'exemple d'IBM compte, pour aujourd'hui, le nombre d'occurrences de chaque action.
Résultat réel sur un IBM i 7.5
Ce que nous avons exécuté :
SELECT COUNT(*) AS ACTION_COUNT, ENTRY_ACTION, MIN(ENTRY_ACTION_DETAIL) FROM TABLE(
SYSTOOLS.AUDIT_JOURNAL_PF(
STARTING_TIMESTAMP => CURRENT DATE ))
WHERE ENTRY_TYPE = 'P'
GROUP BY ENTRY_ACTION
ORDER BY ACTION_COUNT
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
Pour chaque action sur les PTF réalisée aujourd'hui, compter le nombre d'occurrences et afficher la description de l'action.
-- Description: For each PTF action that has been performed today, list the number of
-- times it occurred along with the description of the action.
SELECT COUNT(*) AS ACTION_COUNT, ENTRY_ACTION, MIN(ENTRY_ACTION_DETAIL) FROM TABLE(
SYSTOOLS.AUDIT_JOURNAL_PF(
STARTING_TIMESTAMP => CURRENT DATE ))
WHERE ENTRY_TYPE = 'P'
GROUP BY ENTRY_ACTION
ORDER BY ACTION_COUNT;
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 (54)
Afficher les 54 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 |
ENTRY_ACTION |
VARCHAR(4) | Action de l'entrée |
ENTRY_ACTION_DETAIL |
VARCHAR(200) | Détail de l'action de l'entrée |
PRODUCT_ID |
VARCHAR(7) | Identifiant du produit |
PRODUCT_RELEASE_LEVEL |
VARCHAR(6) | Niveau d'édition du produit |
PTF_IDENTIFIER |
VARCHAR(7) | Identifiant de la PTF |
PRODUCT_OPTION |
VARCHAR(4) | Option du produit |
LOAD_ID |
VARCHAR(4) | Identifiant de chargement |
PRODUCT_MINIMUM_LEVEL |
VARCHAR(2) | Niveau minimal du produit |
PRODUCT_MAXIMUM_LEVEL |
VARCHAR(2) | Niveau maximal du produit |
PRODUCT_LIBRARY |
VARCHAR(10) | Bibliothèque du produit |
ACTION_PENDING |
VARCHAR(3) | Action en attente |
IPL_ACTION |
VARCHAR(25) | Action d'IPL |
EXIT_PROGRAM_LIBRARY |
VARCHAR(10) | Bibliothèque du programme de sortie |
EXIT_PROGRAM |
VARCHAR(10) | Programme de sortie |
EXIT_PROGRAM_ACTION |
VARCHAR(21) | Action du programme de sortie |
SUPERSEDED_BY_PTF |
VARCHAR(7) | PTF remplaçante |
APPLY_TYPE |
VARCHAR(8) | Type d'application |
DEVICE_NAME |
VARCHAR(10) | Nom de l'unité |
IMAGE_CATALOG |
VARCHAR(10) | Catalogue d'images |
MEDIA_PROMPT |
VARCHAR(10) | Invite de média |
HIPER_PTFS |
VARCHAR(3) | PTF HIPER |
COPY_SERVICE_PTFS |
VARCHAR(3) | Copie des PTF de service |
OMIT_PTFS |
VARCHAR(3) | PTF à omettre |
AUTOMATIC_IPL |
VARCHAR(3) | IPL automatique |
IPL_RESTART_TYPE |
VARCHAR(5) | Type de redémarrage d'IPL |
QPZSYNC_PARAMETER |
CHAR(1) | Paramètre QPZSYNC |
IPL_TYPE |
VARCHAR(10) | Type d'IPL |
ABNORMAL_IPL |
VARCHAR(3) | Indicateur d'IPL anormal |
LIC_RESTORED |
VARCHAR(3) | Code interne sous licence restauré |
LIC_IPL_REQUESTED |
VARCHAR(3) | IPL du code interne sous licence demandé |
RESTART_SHARED_ACTIVATION_GROUP |
VARCHAR(3) | Redémarrage du groupe d'activation partagé |