Aller au contenu

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ètreTypePar défautSignification
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
ColonneTypeSignification
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é