CHGAUD

Modifier la valeur d'audit

En bref

La commande CHGAUD (Modifier une valeur d'audit) vous permet de définir ou modifier l'audit d'un objet.

CHGAUD se lit CHG (Modifier) + AUD. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CHGAUD OBJ(…)

Paramètres

OBJ Objet obligatoire
OBJAUD Valeur d'audit d'objet
SUBTREE Branche du répertoire
SYMLNK Lien symbolique

Astuce : dans une session 5250, tapez CHGAUD puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande CHGAUD (Modifier une valeur d'audit) vous permet de définir ou modifier l'audit d'un objet. Vous pouvez modifier le droit sur un groupe d'objets associés à l'aide d'un masque de nom d'objet.

La commande CHGAUD permet également de modifier l'audit d'une arborescence lorsque la modification d'audit s'étend au répertoire, à son contenu et au contenu de tous les sous-répertoires associés. Indiquée avec SUBTREE(*ALL), cette commande tente de modifier l'audit de tous les objets de la branche. Le système envoie un message de diagnostic pour chaque objet dont l'audit n'est pas modifiable. Une fois la modification d'audit tentée en vain sur tous les objets, le système envoie un message d'arrêt programme. Si la modification d'audit aboutit pour tous les objets, le système envoie un message d'achèvement.

Si un objet lien symbolique est détecté (dans le paramètre Objet (OBJ) ou dans le traitement d'une branche), il reçoit la valeur indiquée pour le paramètre Lien symbolique (SYMLNK). S'il s'agit du traitement d'une branche, l'opération s'arrête car un objet lien symbolique ne peut pas comporter de branche.

Pour plus d'informations sur les commandes du système de fichiers intégré, reportez-vous aux Rubriques Système de fichiers intégré de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Restrictions :

Vous devez disposer du droit spécial *AUDIT (audit) pour exécuter cette commande. Vous pouvez alors mettre l'audit d'un objet en fonction ou hors fonction et ce, que vous disposiez ou non de droits sur cet objet.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
OBJ	Objet	Chemin d'accès	Obligatoire, positionnel 1
OBJAUD	Valeur d'audit d'objet	NONE, USRPRF, CHANGE, ALL	Facultatif, positionnel 2
SUBTREE	Branche du répertoire	NONE, ALL	Facultatif
SYMLNK	Lien symbolique	NO, YES	Facultatif

Objet (OBJ)

Indique l'objet (ou le masque correspondant à plusieurs objets) pour lequel les valeurs d'audit doivent être modifiées.

Pour obtenir de plus amples informations relatives à la spécification des noms de chemin, reportez-vous à "Object naming rules" dans la rubrique Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Ce paramètre est obligatoire.

Remarque :Ce paramètre est compatible Unicode. Pour plus d'informations, reportez-vous à la section sur la prise en charge Unicode dans CL, dans les Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

nom-chemin: Indiquez le nom du chemin des objets pour lesquels les valeurs d'audit doivent être modifiées.
Le nom du chemin de l'objet peut être soit un nom simple soit un nom qualifié du nom du répertoire contenant l'objet. Vous pouvez utiliser un masque dans la dernière partie du nom de chemin. Un astérisque (*) représente tout nombre de caractères et un point d'interrogation (?) correspond à un caractère unique. Si le nom de chemin est qualifié ou qu'il contient un masque, il doit être indiqué entre apostrophes.

Valeur d'audit d'objet (OBJAUD)

Indique la valeur d'audit d'objet à associer à l'objet.

*NONE: L'utilisation ou la modification de l'objet ne provoquent pas la consignation d'un poste d'audit dans le journal de sécurité.
*USRPRF: Le profil de l'utilisateur qui accède à l'objet détermine l'envoi d'un enregistrement d'audit lors de cet accès. Le paramètre OBJAUD de la commande CHGUSRAUD permet d'activer la fonction d'audit pour un utilisateur spécifique.
*CHANGE: Tous les accès en modification à cet objet sont consignés.
*ALL: Tous les accès en modification ou en lecture effectués par tous les utilisateurs sur cet objet sont consignés.

Branche du répertoire (SUBTREE)

Indique si les objets de la branche doivent être modifiés lorsque l'objet désigné par le paramètre Objet (OBJ) est un répertoire ou une bibliothèque.

*NONE

Les objets indiqués par le paramètre OBJ sont modifiés. Si l'objet est un répertoire ou une bibliothèque, il est modifié, mais son contenu ne l'est pas.

*ALL

Les objets indiqués par le paramètre OBJ sont modifiés. Si l'objet est un répertoire ou une bibliothèque, il est vérifié ainsi que son contenu et celui de tous les sous-répertoires associés.

Remarque :Le critère de concordance par rapport au paramètre OBJ ne s'applique qu'aux objets de premier niveau. Si l'objet de premier niveau est un répertoire ou une bibliothèque, le critère de concordance ne s'applique pas à son contenu ni à celui des sous-répertoires associés.

Remarque :La durée d'exécution de cette commande peut être longue avec SUBTREE(*ALL) lorsque de nombreux sous-répertoires doivent être traités.

Une fois que la commande a commencé à traiter une branche d'un répertoire spécifique, les objets localisés et traités peuvent être affectés par les opérations qui mettent à jour l'organisation des objets dans l'arborescence de répertoire spécifiée. Cela inclut, sans caractère limitatif, les éléments suivants :

Ajout, suppression ou nouvelle dénomination des liens d'objet
Montage ou démontage des systèmes de fichiers
Mise à jour du répertoire racine effectif pour le processus qui appelle la commande
Mise à jour du contenu d'un lien symbolique

Pour traiter la branche du répertoire, le code du système peut augmenter le nombre maximal de descripteurs de fichier, dans la portée du processus, qui peuvent être ouverts lors du traitement. Cette opération est effectuée afin que la commande ne soit pas susceptible d'échouer en raison d'un manque de descripteurs. Cette valeur maximale de portée de processus n'est pas réinitialisée à la fin de la commande.

Lien symbolique (SYMLNK)

Si l'objet est un lien symbolique, permet d'indiquer si vous voulez modifier le lien symbolique ou l'objet qu'il désigne.

*NO: L'objet lien symbolique n'est pas modifié, contrairement à l'objet désigné par le lien symbolique.
*YES: Si l'objet est un lien symbolique, le lien symbolique est modifié. L'objet désigné par le lien symbolique n'est pas modifié.

Exemples

Exemple 1 : modification de la valeur d'audit d'objet d'un fichier

CHGAUD   OBJ('/QSYS.LIB/PAYROLL.LIB/PAYFILE.FILE')
         OBJAUD(*CHANGE)

Cette commande modifie la valeur d'audit d'objet du fichier PAYFILE de la bibliothèque PAYROLL. La valeur d'audit du fichier PAYFILE est modifiée de façon à ce que tout accès en modification au fichier par tout utilisateur soit consigné par le système.

Les exemples ci-après utilisent le diagramme suivant :

*            sym1 (lien symbolique vers dir1)
*
*
*                       dir1
*                       * * *
*                     *   *   *
*                    *    *    *
*               dir2.1  dir2.2  dir2.3
*                  *      *       *
*                  *      *       *
*               dir3.1  dir3.2  sym3.3 (lien symbolique vers dirA)
*
*
*                       dirA
*                       * * *
*                     *   *   *
*                    *    *    *
*               dirB.1  dirB.2  dirB.3
*

Exemple 2 : modification de la valeur d'audit d'objet d'un lien symbolique avec SYMLNK(*NO)

CHGAUD   OBJ('/sym1')  OBJAUD(*CHANGE) SUBTREE(*ALL) SYMLNK(*NO)

Cette commande détermine d'abord si des branches doivent être traitées. L'objet désigné dans le paramètre OBJ est un lien symbolique. Par conséquent, le paramètre SUBTREE est ignoré, car un objet lien symbolique ne possède pas de branche. Ensuite, l'objet désigné par le lien symbolique sym1 (dir1) devient la cible de l'opération car le paramètre SYMLNK indique que l'objet de lien symbolique ne doit pas être la cible de l'opération.

Dans cet exemple, la valeur d'audit d'objet de dir1 est modifiée de façon à ce que tout accès en modification au répertoire par tout utilisateur soit consigné par le système. La valeur d'audit d'objet de l'objet lien symbolique (sym1) et celle du contenu de dir1 ne sont pas modifiées.

Exemple 3 : modification de la valeur d'audit d'objet d'un lien symbolique avec SYMLNK(*YES)

CHGAUD   OBJ('/sym1')  OBJAUD(*CHANGE) SUBTREE(*ALL) SYMLNK(*YES)

Cette commande détermine d'abord si des branches doivent être traitées. L'objet désigné dans le paramètre OBJ est un lien symbolique. Par conséquent, le paramètre SUBTREE est ignoré, car un objet lien symbolique ne possède pas de branche. Ensuite, l'objet de lien symbolique (sym1) devient la cible de l'opération car le paramètre SYMLNK indique que l'objet de lien symbolique doit être la cible de l'opération.

Dans cet exemple, la valeur d'audit d'objet de sym1 est modifiée de façon à ce que tout accès en modification au lien symbolique par tout utilisateur soit consigné par le système. La valeur d'audit d'objet de l'objet désigné par le lien symbolique (dir1) et celle du contenu de dir1 ne sont pas modifiées.

Exemple 4 : modification de la valeur d'audit d'objet d'un répertoire avec SUBTREE(*ALL) et SYMLNK(*NO)

CHGAUD   OBJ('/dir1')  OBJAUD(*CHANGE) SUBTREE(*ALL) SYMLNK(*NO)

Cette commande détermine d'abord si des branches doivent être traitées. L'objet désigné dans le paramètre OBJ est un répertoire. Par conséquent, les branches sont traitées. Si un objet *SYMLNK est détecté lors du traitement de l'arborescence, il reçoit la valeur du paramètre SYMLNK. Lorsque le paramètre SYMLNK a pour valeur *NO, l'objet désigné par le lien symbolique devient la cible de l'opération. Ensuite, le traitement de cette branche de l'arborescence s'arrête, car l'objet *SYMLNK ne possède pas de branche.

Dans cet exemple, la valeur d'audit d'objet de dir1, dir2.1, dir2.2, dir2.3, dir3.1, dir3.2, dirA est modifiée de façon à ce que tout accès en modification à ces répertoires par tout utilisateur soit consigné par le système. La valeur d'audit d'objet de sym3.3, dirB.1, dirB.2, dirB.3 n'est pas modifiée.

Exemple 5 : modification de la valeur d'audit d'objet d'un répertoire avec SUBTREE(*ALL) et SYMLNK(*YES)

CHGAUD   OBJ('/dir1')  OBJAUD(*CHANGE) SUBTREE(*ALL) SYMLNK(*YES)

Cette commande détermine d'abord si des branches doivent être traitées. L'objet désigné dans le paramètre OBJ est un répertoire. Par conséquent, les branches sont traitées. Si un objet *SYMLNK est détecté lors du traitement de l'arborescence, il reçoit la valeur du paramètre SYMLNK. Lorsque le paramètre SYMLNK a pour valeur *YES, l'objet de lien symbolique devient la cible de l'opération. Ensuite, le traitement de cette branche de l'arborescence s'arrête, car l'objet *SYMLNK ne possède pas de branche.

Dans cet exemple, la valeur d'audit d'objet de dir1, dir2.1, dir2.2, dir2.3, dir3.1, dir3.2, sym3.3 est modifiée de façon à ce que tout accès en modification à ces répertoires et au lien symbolique correspondant par tout utilisateur soit consigné par le système. La valeur d'audit d'objet de dirA, dirB.1, dirB.2, dirB.3 n'est pas modifiée.

Exemple 6 : modification de la valeur d'audit d'objet d'un répertoire avec SUBTREE(*NONE) et SYMLNK(*NO)

CHGAUD   OBJ('/dir1')  OBJAUD(*CHANGE) SUBTREE(*NONE) SYMLNK(*NO)

Cette commande ne traite pas les branches. L'objet désigné dans le paramètre OBJ n'est pas un lien symbolique. Par conséquent, le paramètre SYMLNK est ignoré.

La valeur d'audit d'objet de dir1 est modifiée de façon à ce que tout accès en modification au répertoire par tout utilisateur soit consigné par le système.

REMARQUE :

Pour que les objets dirB.1, dirB.2 et dirB.3 deviennent la cible de l'opération, incluez-les individuellement dans le paramètre OBJ de la commande ou indiquez la commande avec OBJ('/dirA') and SUBTREE(*ALL).

Messages d'erreur

Messages *ESCAPE

CPE3526: Journal damaged.
CPE3527: Journal inactive.
CPE3528: Erreur d'espace de journal ou de mémoire système. Journal space or system storage error.
CPE3529: Le journal est distant. Journal is remote.
CPE3530: Un nouveau récepteur de journal est nécessaire. New journal receiver is needed.
CPE3531: Un nouveau journal est nécessaire. New journal is needed.
CPE3532: Object already journaled.
CPE3450: Le descripteur n'est pas valide. Descriptor not valid.
CPFA0AA: Une erreur s'est produite pendant l'allocation d'espace.
CPFA0AB: Erreur d'opération pour l'objet. L'objet est &1.
CPFA0AD: Fonction non acceptée par le système de fichiers.
CPFA0A2: Données incorrectes transmises à l'opération.
CPFA0A3: La résolution du nom de chemin provoque une boucle.
CPFA0A4: Trop de fichiers ouverts pour le traitement.
CPFA0A7: Le nom de chemin est trop long.
CPFA0A9: Objet introuvable. L'objet est &1.
CPFA0B1: Opération demandée non admise. Incident d'accès.
CPFA0DE: Type d'objet incorrect pour la demande. L'objet est &1.
CPFA0D4: Une erreur s'est produite dans le système de fichiers. Code erreur &1.
CPFA08B: Le nom de chemin ne peut pas commencer par *.
CPFA08C: Masque non admis dans répertoire du nom de chemin.
CPFA085: Répertoire initial de l'utilisateur &1 introuvable.
CPFA086: Apostrophe manquante dans nom de chemin.
CPFA087: Le nom de chemin contient un caractère indéfini.
CPFA088: Masque de nom de chemin incorrect.
CPFA089: Masque non admis dans nom de chemin.
CPFA091: Masque non admis pour le nom de l'utilisateur.
CPFA092: Le nom de chemin n'a pas été converti.
CPFA094: Le nom de chemin n'a pas été indiqué.
CPFBC50: Nom(s) d'accès introuvable(s).
CPF22B0: Non autorisé à modifier la valeur d'audit.
CPF223A: &1 objets modifiés, &2 objets non modifiés.
CPF22F0: Erreurs imprévues lors du traitement.
CPF4ACF: Echec de l'opération pour l'objet &1 dans &2 type *&3 en raison d'erreurs de réplication.