CHGOBJAUD

Modifier l'audit d'objet

En bref

La commande CHGOBJAUD (Modifier l'audit d'objet) permet aux utilisateurs disposant du droit spécial *AUDIT de définir ou de modifier un audit d'objet.

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

Syntaxe minimale

CHGOBJAUD OBJ(…) OBJTYPE(…) OBJAUD(…)

Paramètres

OBJ Objet obligatoire
OBJTYPE Type d'objet obligatoire
ASPDEV Unité ASP
OBJAUD Valeur d'audit d'objet obligatoire

Astuce : dans une session 5250, tapez CHGOBJAUD 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 CHGOBJAUD (Modifier l'audit d'objet) permet aux utilisateurs disposant du droit spécial *AUDIT de définir ou de modifier un audit d'objet. 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. La valeur système QAUDCTL contrôle la mise en et hors fonction de l'audit. L'attribut d'audit d'un objet peut être affiché à l'aide de la commande DSPOBJD (Afficher une description d'objet).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
OBJ	Objet	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Objet	Nom générique, nom, *ALL
	Qualificatif 2: Biblio	Nom, LIBL, USRLIBL, CURLIB, ALL, ALLUSR, ALLAVL, *ALLUSRAVL
OBJTYPE	Type d'objet	ALL, ALRTBL, AUTHLR, AUTL, BNDDIR, CFGL, CHTFMT, CLD, CLS, CMD, CNNL, COSD, CRG, CRQD, CSI, CSPMAP, CSPTBL, CTLD, DEVD, DSTMF, DTAARA, DTADCT, DTAQ, EDTD, EXITRG, FCT, FILE, FNTRSC, FNTTBL, FORMDF, FTR, GSS, IGCDCT, IGCTBL, IGCSRT, IMGCLG, IPXD, JOBD, JOBQ, JOBSCD, JRN, JRNRCV, LIB, LIND, LOCALE, M36, M36CFG, MEDDFN, MENU, MGTCOL, MODD, MODULE, MSGF, MSGQ, NODGRP, NODL, NTBD, NWID, NWSCFG, NWSD, OUTQ, OVL, PAGDFN, PAGSEG, PDFMAP, PDG, PGM, PNLGRP, PRDAVL, PRDDFN, PRDLOD, PSFCFG, QMFORM, QMQRY, QRYDFN, RCT, S36, SBSD, SCHIDX, SPADCT, SQLPKG, SQLUDT, SQLXSR, SRVPGM, SSND, SVRSTG, TBL, TIMZON, USRIDX, USRPRF, USRQ, USRSPC, VLDL, WSCST	Obligatoire, positionnel 2
ASPDEV	Unité ASP	Nom, , SYSBAS	Facultatif
OBJAUD	Valeur d'audit d'objet	NONE, USRPRF, CHANGE, ALL	Obligatoire, positionnel 3

Objet (OBJ)

Indique les objets pour lesquels les valeurs d'audit doivent être modifiées.

Ce paramètre est obligatoire.

Qualificatif 1 : Objet

*ALL: Tous les objets auquel le type d'objet indiqué a été attribué sont modifiés.
nom-générique: Indiquez le nom générique des objets pour lesquels les valeurs d'audit doivent être modifiées.
Un nom générique est une chaîne comportant un ou plusieurs caractères suivis d'un astérisque (*), par exemple, ABC*. L'astérisque représente des caractères admis. Un nom générique spécifie tous les objets dont les noms commencent par le préfixe générique sur lesquels l'utilisateur dispose de droits. Si aucun astérisque n'est associé au nom (de préfixe) générique, le système considère qu'il s'agit du nom complet de l'objet.
nom: Indiquez le nom de l'objet pour lequel les valeurs d'audit doivent être modifiées. Si la recherche porte sur plusieurs bibliothèques, plusieurs objets peuvent être modifiés uniquement si les valeurs *ALL, *ALLUSR, *ALLAVL, ou *ALLUSRAVL sont spécifiées pour le qualificateur de bibliothèque.

Qualificatif 2 : Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB: La recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL. Si le paramètre Unité ASP (ASPDEV) est indiqué lorsque cette valeur est utilisée, la valeur ASPDEV(*) est la seule valeur admise.

*USRLIBL: S'il existe un poste de bibliothèque en cours dans la liste des bibliothèques de l'unité d'exécution en cours, la recherche porte sur celle-ci ainsi que sur les bibliothèques de la partie utilisateur de la liste des bibliothèques. Dans le cas contraire, la recherche porte uniquement sur les bibliothèques de la partie utilisateur de la liste des bibliothèques. Si le paramètre Unité ASP (ASPDEV) est indiqué lorsque cette valeur est utilisée, la valeur ASPDEV(*) est la seule valeur admise.

*ALL: La recherche porte sur toutes les bibliothèques de pools de mémoire secondaire (ASP) indiquées à l'invite Unité ASP (paramètre ASPDEV).

*ALLUSR

La recherche porte sur toutes les bibliothèques utilisateur des pools de mémoire secondaire (ASP) définies à l'invite Unité ASP (paramètre ASPDEV).

Les bibliothèques utilisateur sont des bibliothèques dont le nom ne commence pas par la lettre Q, à l'exception de celles qui suivent :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques ci-après dont le nom commence par la lettre Q soient fournies par IBM, elles contiennent des données utilisateur fréquemment modifiées. En conséquence, elles sont également considérées comme des bibliothèques utilisateur :

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2xxxxx  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

'xxxxx' représente le numéro de l'ASP principal.
L'utilisateur peut créer une bibliothèque de nom différent, au format QUSRVxRxMx, pour chacune des éditions précédentes prises en charge par IBM, afin d'y stocker les commandes utilisateur à compiler dans un programme CL pour une édition précédente. En ce qui concerne la bibliothèque utilisateur QUSRVxRxMx, VxRxMx correspond à une version, édition et niveau de modification précédents encore admis par IBM.

*ALLAVL: La recherche porte sur toutes les bibliothèques des ASP disponibles.

*ALLUSRAVL: La recherche porte sur toutes les bibliothèques des ASP utilisateur disponibles. Consultez *ALLUSR pour obtenir une définition des bibliothèques utilisateur.

nom: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Type d'objet (OBJTYPE)

Indique le type des objets à modifier. Pour plus d'informations, reportez-vous à la description du paramètre OBJTYPE dans la rubrique "Commonly used parameters: Expanded descriptions" du manuel 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.

*ALL: Tous les types d'objet portant le nom d'objet indiqué sont modifiés.
type-objet: Indiquez le type des objets pour lesquels les valeurs d'audit doivent être modifiées.

Unité ASP (ASPDEV)

Indiquez le nom d'unité de pool de mémoire secondaire (ASP) où la bibliothèque contenant l'objet (paramètre OBJ) est située. Si la bibliothèque de l'objet réside dans un ASP ne faisant pas partie de l'espace de nom de la bibliothèque, associé au travail, ce paramètre doit être précisé pour s'assurer que l'objet correct est utilisé comme cible pour l'exécution de cette commande.

*: L'objet est recherché dans les ASP faisant actuellement partie de l'espace de nom de la bibliothèque du travail. Ceci inclut l'ASP système (ASP numéro 1), tous les ASP utilisateurs de base définis (ASP numéros 2 à 32) et, si le travail est associé à un groupe d'ASP, tous les ASP indépendants du groupe ASP.
*SYSBAS: L'objet est recherché dans l'ASP système et dans tous les ASP utilisateur. La recherche ne porte sur aucun ASP indépendant, même si le travail est associé à un groupe d'ASP.
nom: Indiquez le nom de l'unité de l'ASP indépendant dans lequel l'objet est recherché. Cet ASP doit avoir été activé (en mettant en fonction l'unité ASP) et avoir l'état DISPONIBLE. La recherche ne s'effectue pas sur l'ASP système et sur les ASP utilisateur de base.

Valeur d'audit d'objet (OBJAUD)

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

Ce paramètre est obligatoire.

*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 accédant à cet objet est utilisé pour déterminer si un enregistrement d'audit doit être envoyé pour cet accès. Le mot clé OBJAUD de la commande CHGUSRAUD est utilisé pour mettre l'audit en fonction pour un utilisateur précis.
*CHANGE: Tous les accès en modification à cet objet sont consignés.
*ALL: Tous les accès en modification ou en lecture à cet objet sont consignés.

Exemples

CHGOBJAUD   OBJ(PAYROLL/PAYFILE)  OBJTYPE(*FILE)
            OBJAUD(*CHANGE)

Cette commande modifie la valeur d'audit de l'objet PAYFILE de la bibliothèque PAYROLL dont le type d'objet est *FILE. La valeur d'audit du fichier PAYFILE est modifiée de façon à ce que tout changement apporté à ce fichier par tout utilisateur soit consigné dans le journal d'audit QAUDJRN de la bibliothèque QSYS.

Messages d'erreur

Messages *ESCAPE

CPF2208: Objet &1 de la bibliothèque &3 type *&2 non trouvé.
CPF22B0: Non autorisé à modifier la valeur d'audit.
CPF22CB: La valeur d'audit de certains objets n'a pas été modifiée.
CPF22FE: Valeur d'audit peut être non modifiée pour objet &1 de &3, type *&2.
CPF4ACF: Echec de l'opération pour l'objet &1 dans &2 type *&3 en raison d'erreurs de réplication.
CPF9801: Objet &2 non trouvé dans la bibliothèque &3.
CPF9803: Impossible d'allouer l'objet &2 de la bibliothèque &3.
CPF980B: Objet &1 de bibliothèque &2 indisponible.
CPF9810: Bibliothèque &1 non trouvée.
CPF9814: Unité &1 non trouvée.
CPF9873: Accès à l'objet impossible en raison de l'état de l'ASP.
CPF98A1: Objet correspondant au nom indiqué introuvable.