CHGATR

La commande Modifier attribut (CHGATR) permet de modifier un attribut d'un objet ou d'un groupe d'objets. Il est possible d'utiliser un masque pour modifier un attribut d'un groupe d'objets.

Cette commande permet également de modifier un attribut d'une arborescence de répertoires lorsque l'attribut a été modifié pour le répertoire indiqué, pour son contenu et pour le contenu de tous ses sous-répertoires. Si SUBTREE(*ALL) est précisé, la commande tente de modifier un maximum d'objets de la sous-arborescence. Un message de diagnostic est émis pour chacun des objets dont l'attribut n'a pas pu être modifié. Une fois l'opération tentée sur tous les objets, un message d'arrêt programme est envoyé en cas d'erreur. Si l'attribut de chaque objet a été modifié sans erreur, un message d'achèvement est émis.

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 :

• L'utilisateur doit disposer du droit d'exécution (*X) sur les répertoires des préfixes de nom de chemin, excepté lors de la modification de l'attribut *CRTOBJAUD.
• Lors du traitement d'une sous-arborescence, l'utilisateur doit disposer des droits de lecture (*R) et d'exécution (*X) sur le nom de chemin et sur tous les sous-répertoires de ce chemin, excepté lors de la modification de l'attribut *CRTOBJAUD.
• L'utilisateur doit disposer des droits spéciaux *ALLOBJ et *SECADM pour modifier les attributs *CRTOBJSCAN, *SCAN, *RUNEXIT ou *CRTRUNEXIT.
• L'utilisateur doit être le propriétaire de l'objet ou disposer du droit spécial *ALLOBJ sur l'objet, afin de définir les attributs *RSTDRNMUNL, *SETUID et *SETGID de l'objet.
• L'utilisateur doit disposer des droits spéciaux *AUDIT pour définir l'attribut *CRTOBJAUD de l'objet répertoire.
• Pour tous les systèmes de fichiers, excepté QSYS.LIB, QSYS.LIB d'ASP indépendant et QDLS, l'utilisateur doit disposer du droit de gestion sur l'objet (*OBJMGT) pour modifier l'attribut *ALWCKPWRT, *INHCKPWRT, *ALWSAV, *USECOUNT, *DISKSTGOPT ou *MAINSTGOPT.
• Pour tous les systèmes de fichiers, excepté QSYS.LIB, QSYS.LIB d'ASP indépendant et QDLS, l'utilisateur doit disposer du droit d'écriture (*W) sur l'objet pour modifier tous les attributs, sauf indication contraire.
• La modification de l'attribut *INHCKPWRT ou *CRTRUNEXIT pour un objet qui n'est pas un répertoire échoue et génère les messages d'erreur CPFA0AD et CPFB414.
• Pour modifier l'attribut *USECOUNT d'un objet sur les systèmes de fichiers QSYS.LIB et QSYS.LIB d'ASP indépendant, l'utilisateur doit disposer du droit d'opération (*OBJOPR) et de gestion (*OBJMGT) s'il s'agit d'un objet de type *FILE, des droits *X et *OBJMGT si l'objet est un membre de fichier base de données et du droit *OBJMGT si l'objet n'est pas de type *FILE ou n'est pas un membre de fichier base de données.
• Pour le système de fichiers QDLS, l'utilisateur doit disposer des droits *W et *OBJMGT pour modifier l'attribut *USECOUNT.
• Cette commande autorise les unités d'exécution multiples sous certaines conditions. En effet, la restriction suivante s'applique :

  Cette commande n'autorise pas les unités d'exécution multiples si l'objet sur lequel s'exécute cette fonction réside sur un système de fichiers qui lui-même ne les autorise pas. Seuls les systèmes de fichiers suivants autorisent les unités d'exécution multiples pour cette fonction :

  • Racine (/)
  • QOpenSys
  • Défini par l'utilisateur
  • QNTC
  • QSYS.LIB
  • QSYS.LIB d'ASP indépendant
  • QOPT
  • Système de fichiers réseau (NFS)
  • QFileSvr.400

Particularités du système de fichiers racine (/), QOpenSys et du système de fichiers défini par l'utilisateur

• L'attribut *USECOUNT n'est pris en charge que pour les objets de type *STMF. Toute tentative de paramétrage de cet attribut sur d'autres objets donne lieu à l'échec de l'opération.
• La valeur *YES ne peut pas être indiquée pour l'attribut *ALWSAV pour /dev/null, /dev/zero ou les objets de type *SOCKET. Toute tentative de paramétrage de cet attribut sur ces objets donne lieu à l'échec de l'opération.
• La valeur *YES ne peut pas être spécifiée pour l'attribut *RUNEXIT pour les objets de type *SOCKET ou *SYMLNK. Toute tentative de paramétrage de cet attribut sur ces objets donne lieu à l'échec de l'opération.
• L'attribut *SETGID du répertoire a une incidence sur l'ID groupe (GID) pour les objets créés dans ce répertoire. Si l'attribut $SETGID du répertoire parent est hors fonction, l'ID groupe (GID) est paramétré sur le GID de l'unité d'exécution créant le répertoire. Si l'attribut *SETGID du répertoire parent est en fonction, l'ID groupe (GID) du nouvel objet est paramétré sur le GID du répertoire parent. Pour tous les autres systèmes de fichiers, le GID du nouvel objet est paramétré sur le GID du répertoire parent.
• Lors de la définition de l'attribut *RSTDRNMUNL, *SETUID ou *SETGID sur un objet comportant un groupe principal, l'attribut doit correspondre à l'ID du groupe principal ou à un des ID de groupe supplémentaires de l'appelant de cette commande ; dans le cas contraire, l'attribut *SETGID a pour valeur *NO.

Particularités des systèmes de fichiers QSYS.LIB et QSYS.LIB d'ASP indépendant

• Les attributs suivants peuvent être définis sur les objets de ces systèmes de fichiers :
  • *CRTOBJAUD
  • *USECOUNT

    Lorsque l'attribut *USECOUNT d'un fichier de base de données est défini, le nombre de jours d'utilisation de tous les membres de ce fichier est également remis à zéro.

  • *TEXT
• QSYS.LIB et QSYS.LIB d'ASP indépendant ne prennent pas en charge la définition des attributs *SETUID ou *SETGID. Ces derniers sont ignorés s'ils sont indiqués.
• Toute tentative de définition d'un autre attribut donne lieu à l'échec de l'opération.

Particularité du système de fichiers réseau

• Lorsque les attributs ci-dessous sont indiqués pour les objets du système de fichiers réseau (NFS), l'opération échoue si l'attribut n'est pas paramétré sur la valeur d'attribut suivante.
  • S'il est défini, l'attribut *READONLY doit avoir pour valeur *NO.
  • S'il est défini, l'attribut *HIDDEN doit avoir pour valeur *NO.
  • S'il est défini, l'attribut *PCSYSTEM doit avoir pour valeur *NO.
  • S'il est défini, l'attribut *PCARCHIVE doit avoir pour valeur *NO ; cependant, si l'objet est de type *STMF, l'attribut doit avoir pour valeur *YES.
  • S'il est défini, l'attribut *SYSARCHIVE doit avoir pour valeur *NO.

  Les attributs *USECOUNT, *CCSID, *ALWSAV, *ALWCKPWRT, *DISKSTGOPT, *MAINSTGOPT, *CRTOBJAUD, *INHCKPWRT, *RUNEXIT et *CRTRUNEXIT ne peuvent pas être définis sur des objets du système de fichiers réseau (NFS), sinon l'opération échoue.

• Le client NFS prend en charge les attributs *SETUID, *SETGID et *RSTDRNMUNL en les transmettant au serveur via le réseau et en les réacheminant vers l'appelant. La prise en charge ou non de la définition de ces attributs par un système de fichiers réseau particulier est fonction du serveur. La plupart des serveurs peuvent masquer les attributs *SETUID et *SETGID si l'option NOSUID est indiquée lors de l'exportation. Cependant, par défaut, ces attributs sont pris en charge.

Particularité du système de fichiers QOPT

• Si *YES est indiqué pour l'attribut *ALWSAV, l'opération échoue.
• QOPT ne prend pas en charge la définition des attributs *SETUID, *SETGID, *RSTDRNMUNL, *CRTOBJAUD, *RUNEXIT et *CRTRUNEXIT pour les formats de support optique. Si un de ces attributs est indiqué, l'opération échoue.

Différences du système de fichiers QDLS

• Les attributs suivants peuvent être définis sur les objets de ce système de fichiers :
  • *CCSID
  • *HIDDEN
  • *PCARCHIVE
  • *READONLY
  • *SYSARCHIVE
  • *USECOUNT (pour les documents uniquement)
  • *TEXT
  • *RUNEXIT
  • *CRTRUNEXIT

  Toute tentative de définition d'un attribut autre que *SETUID ou *SETGID donne lieu à l'échec de l'opération.

• QDLS ne prend pas en charge la définition des attributs *SETUID ou *SETGID. Ces derniers sont ignorés s'ils sont indiqués.

Particularités de QFileSvr.400

• Les attributs suivants peuvent être définis sur les objets de ce système de fichiers :
  • *CCSID
  • *CRTOBJAUD

    Remarque :Pour que la modification de l'attribut *CRTOBJAUD aboutisse, les profils utilisateur QSECOFR doivent être activés sur les systèmes source et cible, et leurs mots de passe doivent correspondre.

  • *CRTOBJSCAN
  • *HIDDEN
  • *PCARCHIVE
  • *PCSYSTEM
  • *READONLY
  • *SCAN
  • *SYSARCHIVE

  Toute tentative de définition d'un attribut autre que *SETUID, *SETGID ou *RSTDRNMUNL conduit à l'échec de l'opération.

• QFileSvr.400 prend en charge les attributs *SETUID, *SETGID et *RSTDRNMUNL en les transmettant au serveur et en les réacheminant vers l'appelant.

Particularités de QNTC

• QNTC prend en charge la définition des attributs suivants en les transférant au serveur et en les préparant pour l'appelant :
  • *HIDDEN
  • *PCARCHIVE
  • *PCSYSTEM
  • *READONLY

  Toute tentative de définition d'un attribut autre que *SETUID ou *SETGID donne lieu à l'échec de l'opération.

• QNTC ne prend pas en charge la définition des attributs *SETUID ou *SETGID. Ces derniers sont ignorés s'ils sont indiqués.

Paramètres

Objet (OBJ)

Indique le nom de chemin de l'objet ou un masque correspondant au nom des objets dont l'attribut sera modifié. Il peut s'agir d'un nom simple ou d'un nom qualifié indiquant le nom du répertoire contenant l'objet. Vous pouvez indiquer un masque pour la dernière partie du nom. Un astérisque (*) correspond à un nombre quelconque de caractères, alors qu'un point d'interrogation (?) correspond à un caractère unique. Si le nom est qualifié ou contient un masque, il doit être placé entre apostrophes (').

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/.

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/.

Attribut (ATR)

Indique l'attribut à modifier.

*READONLY

Indique s'il est possible d'écrire des données dans l'objet ou de le supprimer, de modifier ou de supprimer ses attributs étendus et de modifier sa taille.

Les valeurs admises pour le paramètre Nouvelle valeur (VALUE) sont les suivantes :

*YES

L'objet ne peut être ni modifié, ni supprimé.

*NO

L'objet peut être modifié ou supprimé.

*HIDDEN

Indique si l'objet peut être affiché à l'aide d'une liste de répertoires ordinaire.

Les valeurs admises pour le paramètre VALUE sont les suivantes :

*YES

L'objet est caché et ne peut pas être affiché à l'aide d'une liste de répertoires ordinaire.

*NO

L'objet n'est pas caché et peut être affiché à l'aide d'une liste de répertoires ordinaire.

*PCSYSTEM

Indique si l'objet est un fichier système PC exclu des recherches de répertoires normales.

Les valeurs admises pour le paramètre VALUE sont les suivantes :

*YES

L'objet est un fichier système PC.

*NO

L'objet n'est pas un fichier système PC.

*PCARCHIVE

Indique si l'objet a été modifié depuis la dernière sauvegarde ou réinitialisation du fichier effectuée par un client PC.

Les valeurs admises pour le paramètre VALUE sont les suivantes :

*YES

L'objet a été modifié.

*NO

L'objet n'a pas été modifié.

*SYSARCHIVE

Indique si l'objet a été modifié et doit être sauvegardé. Cette option est activée lorsque l'heure de modification d'un objet est mise à jour et désactivée lorsque l'objet a été sauvegardé.

Les valeurs admises pour le paramètre VALUE sont les suivantes :

*YES

L'objet a été modifié et doit être sauvegardé.

*NO

L'objet n'a pas été modifié et ne doit pas être sauvegardé.

*CCSID

ID codé de jeu de caractères (CCSID) des données et des attributs étendus de l'objet.

Remarque :La modification du CCSID n'entraîne pas la conversion des données ou des attributs étendus. Elle permet uniquement de modifier la valeur associée à l'objet. Cela s'applique également aux données contenues dans les attributs étendus associés à l'objet.

Les valeurs admises pour le paramètre VALUE sont les suivantes :

1 à 65533

CCSID des données et des attributs étendus de l'objet.

*ALWCKPWRT

Si l'objet est un fichier STREAM, indique si le fichier STREAM peut être partagé entre lecteurs et éditeurs lors d'une sauvegarde qui a lieu en même temps que le traitement des points de contrôle. Si l'objet est un répertoire, indique si des liens peuvent être ajoutés, supprimés ou renommés dans le répertoire lors d'une opération de sauvegarde en mise à jour. La modification de la valeur en cours de cet attribut peut entraîner des résultats inattendus. Pour plus de détails sur cet attribut, reportez-vous au manuel Reprise du système, SC41-5304.

Les valeurs admises pour le paramètre VALUE sont les suivantes :

*YES

Si l'objet est un fichier STREAM, il peut être partagé entre lecteurs et éditeurs lors d'une sauvegarde qui a lieu en même temps que le traitement des points de contrôle. Si l'objet est un répertoire, des liens peuvent être ajoutés, supprimés ou renommés dans le répertoire lors d'une opération de sauvegarde en mise à jour.

*NO

Si l'objet est un fichier STREAM, il peut être partagé entre lecteurs uniquement lors d'une sauvegarde qui a lieu en même temps que le traitement des points de contrôle. Si l'objet est un répertoire, aucun lien ne peut être ajouté, supprimé ou renommé dans le répertoire lors d'une opération de sauvegarde en mise à jour.

*INHCKPWRT

Indique si les nouveaux objets créés dans un répertoire doivent hériter des options de traitement de point de contrôle de sauvegarde en mise à jour du répertoire parent.

Cet attribut s'applique uniquement aux répertoires des systèmes de fichiers racine (/), QOpenSys et définis par l'utilisateur.

Les valeurs admises pour le paramètre VALUE sont les suivantes :

*YES

L'attribut *INHCKPWRT pour les nouveaux objets répertoire créés dans ce répertoire prend la valeur *YES. L'attribut *ALWCKPWRT pour les nouveaux objets créés dans ce répertoire prend la valeur *YES.

*NO

L'attribut *INHCKPWRT pour les nouveaux objets répertoire créés dans ce répertoire prend la valeur *NO. L'attribut *ALWCKPWRT pour les nouveaux objets créés dans ce répertoire prend la valeur *NO.

*USECOUNT

Nombre de jours durant lesquels un objet a été utilisé. L'utilisation peut être différente selon le système de fichiers et les types d'objets individuels pris en charge par le système de fichiers. Elle peut correspondre à l'ouverture ou à la fermeture d'un fichier ou se rapporter à l'ajout de liens, à l'attribution d'un nouveau nom, à la restauration ou au verrouillage d'un objet. Lorsque cet attribut est modifié, le nombre de jours d'utilisation sera remis à zéro et la date d'utilisation sera définie sur la date en cours.

La valeur admise pour le paramètre VALUE est la suivante :

*RESET

Le nombre de jours d'utilisation sera remis à zéro et la date d'utilisation sera définie sur la date en cours.

*DISKSTGOPT

Procédure d'allocation de mémoire secondaire du système à un objet indiqué. Cette option prend effet immédiatement et participe à l'allocation suivante de mémoire secondaire à l'objet. Cette option s'applique uniquement aux fichiers STREAM des systèmes de fichiers racine (/), QOpenSys et définis par l'utilisateur. Cette option n'est pas prise en compte pour les fichiers STREAM *TYPE1.

Les valeurs admises pour le paramètre VALUE sont les suivantes :

*NORMAL

La mémoire secondaire est allouée normalement : au fur et à mesure des besoins en mémoire secondaire supplémentaire, celle-ci sera allouée à des domaines dimensionnés logiquement afin de répondre aux besoins en espace en cours ainsi qu'aux futurs besoins prévisibles tout en minimisant le nombre d'opérations d'E-S sur le disque. Si l'objet ne possède pas l'attribut *DISKSTGOPT, la valeur par défaut est utilisée.

*MINIMIZE

La mémoire secondaire est allouée afin de minimiser l'espace utilisé par l'objet : au fur et à mesure des besoins en mémoire secondaire supplémentaire, celle-ci sera allouée à des domaines de petite taille afin de répondre aux besoins en espace en cours. L'accès à un objet composé de plusieurs petits domaines augmente le nombre d'opérations d'E-S sur le disque pour cet objet.

*DYNAMIC

Le système fixe automatiquement la mémoire secondaire optimale allouée à l'objet, en équilibrant l'espace utilisé et les opérations d'E-S sur le disque. Par exemple, lorsqu'un fichier possède beaucoup de domaines de petite taille, il est fréquemment lu et modifié en écriture. Par conséquent, les allocations de mémoire secondaire futures nécessiteront des domaines plus grands afin de réduire le nombre d'opérations d'E-S sur le disque. Sinon, lorsqu'un fichier est fréquemment tronqué, les allocations futures de mémoire secondaire nécessiteront des domaines plus petits pour réduire l'espace utilisé. De plus, les informations sont gérées par les tailles de fichier STREAM pour le système et son activité. Ces informations sur la taille des fichiers vous aident également à déterminer la mémoire secondaire optimale allouée à l'objet par rapport à la taille des autres objets.

*MAINSTGOPT

Procédure d'allocation et d'utilisation de mémoire principale par le système pour l'objet indiqué. L'option fonctionnera à la prochaine ouverture de l'objet indiqué. Cette option s'applique uniquement aux fichiers STREAM des systèmes de fichiers racine (/), QOpenSys et définis par l'utilisateur.

Les valeurs admises pour le paramètre VALUE sont les suivantes :

*NORMAL

La mémoire principale est allouée normalement. Le maximum de mémoire possible est alloué et utilisé. Le nombre d'opérations d'E-S sur le disque est réduit car les informations sont placées dans la mémoire cache de la mémoire principale. Si l'objet ne possède pas l'attribut *MAINSTGOPT, la valeur par défaut est utilisée.

*MINIMIZE

La mémoire principale est allouée afin de réduire l'espace utilisé par l'objet. Le minimum de mémoire principale possible est alloué et utilisé. L'utilisation de la mémoire principale est ainsi réduite alors que le nombre des opérations d'E-S sur le disque augmente car moins d'informations sont placées en mémoire cache dans la mémoire principale.

*DYNAMIC

Le système fixe automatiquement la mémoire principale optimale allouée à l'objet, selon l'activité des autres systèmes et le degré d'occupation de la mémoire principale. Si la mémoire principale est peu occupée, un maximum de mémoire principale est alloué et utilisé afin de réduire le nombre d'opérations d'E-S sur le disque. Dans le cas contraire, un volume de mémoire principale moindre est alloué afin de limiter les conflits. Cette option agit uniquement lorsque l'option de pagination du pool de mémoire a la valeur *CALC. Lorsque l'option de pagination du pool de mémoire a la valeur *FIXED, le résultat est le même qu'avec *NORMAL. Lorsque l'accès à l'objet s'effectue via un serveur de fichiers, l'option est sans effet. Elle se comporte de la même façon qu'avec la valeur *NORMAL.

*CRTOBJSCAN

Indique si les objets créés dans un répertoire vont être scannés lorsque des programmes d'exit sont enregistrés sur un des points d'exit liés au scannage du système de fichiers intégré.

Les points d'exit liés au scannage du système de fichiers intégré sont les suivants :

• QIBM_QP0L_SCAN_OPEN - Programme d'exit d'analyse à l'ouverture du système de fichiers intégré QIBM_QP0L_SCAN_OPEN - Integrated File System Scan on Open Exit Program
• QIBM_QP0L_SCAN_CLOSE - Programme d'exit d'analyse à la fermeture du système de fichiers intégré QIBM_QP0L_SCAN_CLOSE - Integrated File System Scan on Close Exit Program

Pour plus d'informations sur ces points d'exit, reportez-vous au manuel Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/).

Cette option s'applique uniquement aux répertoires des systèmes de fichiers racine (/), QOpenSys et définis par l'utilisateur. Même si cet attribut peut être défini pour les répertoires *TYPE1 et *TYPE2, seuls les objets figurant dans les répertoires *TYPE2 sont réellement scannés, quelle que soit la valeur définie pour cet attribut.

Les valeurs admises pour le paramètre VALUE sont les suivantes :

*YES

Une fois qu'un objet est créé dans le répertoire, l'objet va être scanné conformément aux règles décrites dans les programmes d'exit liés au scannage, si l'objet a été modifié ou si le logiciel de scannage a été mis à jour depuis le dernier scannage de l'objet. Si le répertoire ne possède pas l'attribut *CRTOBJSCAN, la valeur par défaut est utilisée.

*NO

Après la création d'un objet dans le répertoire, l'objet n'est pas scanné par les programmes d'exit liés au scannage.

Remarque :Si la valeur *NOPOSTRST du paramètre QSCANFSCTL n'est pas indiquée lors de la restauration d'un objet comportant cet attribut, l'objet est scanné au moins une fois après la restauration.

*CHGONLY

Une fois qu'un objet est créé dans le répertoire, cet objet est scanné conformément aux règles décrites dans les programmes d'exit liés au scannage, s'il a été modifié depuis la dernière fois qu'il a été scanné. Il n'est pas scanné si le logiciel de scannage a été mis à jour. Cet attribut ne prend effet que si la valeur système *USEOCOATR a été indiquée pour QSCANFSCTL. Dans le cas contraire, on considère que l'attribut a pour valeur *YES.

Remarque :Si la valeur *NOPOSTRST du paramètre QSCANFSCTL n'est pas indiquée lors de la restauration d'un objet comportant cet attribut, l'objet est scanné au moins une fois après la restauration.

*SCAN

Indique si l'objet va être scanné lorsque des programmes d'exit sont enregistrés sur un des points d'exit liés au scannage du système de fichiers intégré.

Les points d'exit liés au scannage du système de fichiers intégré sont les suivants :

• QIBM_QP0L_SCAN_OPEN - Programme d'exit d'analyse à l'ouverture du système de fichiers intégré QIBM_QP0L_SCAN_OPEN - Integrated File System Scan on Open Exit Program
• QIBM_QP0L_SCAN_CLOSE - Programme d'exit d'analyse à la fermeture du système de fichiers intégré QIBM_QP0L_SCAN_CLOSE - Integrated File System Scan on Close Exit Program

Pour plus d'informations sur ces points d'exit, reportez-vous au manuel Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/).

Cette option s'applique uniquement aux fichiers STREAM des systèmes de fichiers "racine" (/), QOpenSys et définis par l'utilisateur, qui ne sont pas des volumes virtuels ou des espace de stockage de serveur de réseau. Même si cet attribut peut être défini pour les répertoires *TYPE1 et *TYPE2, seuls les objets figurant dans les répertoires *TYPE2 sont réellement scannés, quelle que soit la valeur définie pour cet attribut.

Les valeurs admises pour le paramètre VALUE sont les suivantes :

*YES

L'objet est scanné conformément aux règles décrites dans les programmes d'exit liés au scannage, s'il a été modifié ou si le logiciel de scannage a été mis à jour depuis le dernier scannage de l'objet. Si l'objet ne possède pas l'attribut *SCAN, la valeur par défaut est utilisée.

*NO

L'objet n'est pas scanné par les programmes d'exit liés au scannage.

Remarque :Si la valeur *NOPOSTRST du paramètre QSCANFSCTL n'est pas indiquée lors de la restauration d'un objet comportant cet attribut, l'objet est scanné au moins une fois après la restauration.

*CHGONLY

L'objet est scanné conformément aux règles décrites dans les programmes d'exit liés au scannage, s'il a été modifié depuis la dernière fois qu'il a été scanné. Il n'est pas scanné si le logiciel de scannage a été mis à jour. Cet attribut ne prend effet que si la valeur système *USEOCOATR a été indiquée pour QSCANFSCTL. Dans le cas contraire, on considère que l'attribut a pour valeur *YES.

Remarque :Si la valeur *NOPOSTRST du paramètre QSCANFSCTL n'est pas indiquée lors de la restauration d'un objet comportant cet attribut, l'objet est scanné au moins une fois après la restauration.

*ALWSAV

Indique si l'objet peut être sauvegardé ou non.

Remarque :Il est fortement conseillé de ne pas modifier cet attribut pour les objets créés par le système.

Les valeurs admises pour le paramètre VALUE sont les suivantes :

*YES

Cet objet est sauvegardé lors de l'utilisation de la commande Sauvegarder objet (SAV) ou de l'API QsrSave(). Si l'objet ne possède pas l'attribut *ALWSAV, la valeur par défaut est utilisée.

*NO

Cet objet n'est pas sauvegardé lors de l'utilisation de la commande SAV ou de l'API QsrSave().

En outre, si cet objet est un répertoire, aucun des objets de la sous-arborescence du répertoire n'est sauvegardé, sauf s'ils ont explicitement été indiqués comme objet à sauvegarder. La sous-arborescence comprend tous les sous-répertoires et les objets de ces sous-répertoires.

Remarque :Si cet attribut est choisi pour un objet auquel des droits privés sont associés ou qu'il est choisi pour le répertoire d'un objet auquel des droits privés sont associés, la remarque ci-dessous s'applique. Lors de la sauvegarde des droits privés, le fait que l'attribut *ALWSAV d'un objet a pour valeur *NO n'est pas pris en compte. (Les droits privés peuvent être sauvegardés à l'aide de la commande SAVSYS ou SAVSECDTA ou de l'API QSRSAVO.) Par conséquent, lors de la restauration d'un droit privé à l'aide de la commande RSTAUT, le message CPD3776 s'affiche pour chaque objet qui n'a pas été sauvegardé car son attribut *ALWSAV avait pour valeur *NO ou car l'objet n'a pas été indiqué lors de la sauvegarde et qu'il se trouvait dans un répertoire dont l'attribut *ALWSAV avait pour valeur *NO.

*RSTDRNMUNL

Des restrictions s'appliquent aux opérations de changement de nom et de suppression de lien pour les objets d'un répertoire. Les objets peuvent être liés à un répertoire dans lequel cet attribut est activé. Cependant, ils ne peuvent pas être rebaptisés ou leur lien avec le répertoire ne peut être supprimé, sauf si l'utilisateur qui effectue l'opération remplit une ou plusieurs des conditions suivantes :

1. L'utilisateur est le propriétaire de l'objet.
2. L'utilisateur est le propriétaire du répertoire.
3. L'utilisateur dispose des droits spéciaux sur tous les objets (*ALLOBJ).

Cette restriction ne s'applique qu'aux répertoires. Cet attribut peut être activé pour d'autres types d'objets ; cependant, il sera ignoré. En outre, cet attribut ne peut être indiqué que pour les objets des systèmes de fichiers réseau (NFS), QFileSvr.400, "racine" (/), QOpenSys ou définis par l'utilisateur. Les systèmes de fichiers NFS et QFileSvr.400 prennent en charge cet attribut en le transmettant au serveur et en le réacheminant vers l'appelant. Cet attribut est également identique au bit mode S_ISVTX d'un objet.

Les valeurs admises pour le paramètre VALUE sont les suivantes :

*YES

D'autres restrictions s'appliquent aux opérations de changement de nom et de suppression de lien.

*NO

Aucune autre restriction ne s'applique aux opérations de changement de nom et de suppression de lien.

*SETUID

L'ID utilisateur effectif (UID) est défini au moment de l'exécution. Cette valeur n'est pas prise en compte si l'objet indiqué est un répertoire.

Les valeurs admises pour le paramètre VALUE sont les suivantes :

*YES

Le propriétaire de l'objet est l'ID utilisateur effectif (UID) au moment de l'exécution.

*NO

L'ID utilisateur (UID) n'est pas défini au moment de l'exécution.

*SETGID

L'ID groupe effectif (GID) est défini au moment de l'exécution.

Les valeurs admises pour le paramètre VALUE sont les suivantes :

*YES

Si l'objet est un fichier, l'ID groupe (GID) est défini au moment de l'exécution. Si l'objet est un répertoire, l'ID groupe (GID) des objets créés dans le répertoire est défini sur le GID du répertoire parent.

*NO

Si l'objet est un fichier, l'ID groupe (GID) n'est pas défini au moment de l'exécution. Si l'objet est un répertoire d'un système de fichiers racine (/), QOpenSys ou défini par l'utilisateur, l'ID groupe (GID) des objets créés dans le répertoire est défini sur le GID effectif de l'unité d'exécution créant l'objet.

*CRTOBJAUD

Indique la valeur d'audit des objets créés dans ce répertoire.

Cet attribut s'applique uniquement aux répertoires des systèmes de fichiers racine (/), QOpenSys, QSYS.LIB, QSYS.LIB d'ASP indépendant, QFileSvr.400 et définis par l'utilisateur.

Les valeurs admises pour le paramètre VALUE sont les suivantes :

*SYSVAL

La valeur d'audit des objets du répertoire est déterminée par la valeur système QCRTOBJAUD.

*NONE

Le fait d'utiliser cet objet ou de le modifier ne provoque pas l'envoi d'un poste d'audit au journal de sécurité.

*USRPRF

Le profil de l'utilisateur qui accède à l'objet permet de déterminer si un enregistrement d'audit doit être envoyé pour cet accès. Le paramètre OBJAUD de la commande CHGUSRAUD (Modifier audit d'utilisateur) est utilisé pour modifier l'audit d'un utilisateur spécifique.

*CHANGE

Tous les accès en modification effectués par tous les utilisateurs sur 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.

*TEXT

Indique une brève chaîne de texte associée à l'objet. La valeur VALUE(*NONE) doit également être indiquée. La valeur du paramètre TEXT sera utilisée pour la brève chaîne de texte. Les valeurs admises pour le paramètre TEXT sont les suivantes :

*BLANK

Aucun texte n'est indiqué. En cas de texte existant associé à l'objet, ce texte est supprimé.

valeur-caractère

Il est possible d'indiquer jusqu'à 50 caractères. Le texte indiqué remplace tout texte précédent.

*RUNEXIT

Permet d'indiquer si un ou plusieurs programmes de point d'exit enregistrés seront appelés lors de l'ouverture ou de la fermeture de l'objet.

Les points d'exit liés à l'ouverture du système de fichiers intégré sont les suivants :

• QIBM_QP0L_OBJ_OPEN - Integrated File System Open Exit Program
• QIBM_QP0L_OBJ_CLOSE - Integrated File System Close Exit Program

Pour plus d'informations sur ces points d'exit, reportez-vous au manuel Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/).

Les valeurs admises pour le paramètre VALUE sont les suivantes :

*YES

Les programmes de point d'exit seront appelés avant l'ouverture et après la fermeture de l'objet.

*NO

Les programmes de point d'exit ne seront pas appelés lors de l'ouverture ou de la fermeture de l'objet.

*CRTRUNEXIT

Indique la valeur *RUNEXIT utilisée pour les objets créés dans ce répertoire. Indique également la valeur *CRTRUNEXIT utilisée pour les répertoires créés dans ce répertoire.

Les valeurs admises pour le paramètre VALUE sont les suivantes :

*YES

Tous les objets créés dans ce répertoire seront créés avec la valeur *YES affectée au paramètre *RUNEXIT. De plus, tous les répertoires créés dans ce répertoire seront créés avec la valeur *YES affectée au paramètre *CRTRUNEXIT.

*NO

Tous les objets créés dans ce répertoire seront créés avec la valeur *NO affectée au paramètre *RUNEXIT. De plus, tous les répertoires créés dans ce répertoire seront créés avec la valeur *NO affectée au paramètre *CRTRUNEXIT.

Nouvelle valeur (VALUE)

Valeur utilisée pour modifier l'attribut des objets indiqués.

*YES

Admise pour les attributs *READONLY, *HIDDEN, *PCSYSTEM, *PCARCHIVE, *SYSARCHIVE, *ALWCKPWRT, *INHCKPWRT, *ALWSAV, *CRTOBJSCAN, *SCAN, *RSTDRNMUNL, *RUNEXIT, *CRTRUNEXIT, *SETUID et *SETGID. Pour obtenir une description de cette valeur pour chaque attribut, reportez-vous à l'attribut correspondant dans le Attribut (ATR) ATR.

*NO

Admise pour les attributs *READONLY, *HIDDEN, *PCSYSTEM, *PCARCHIVE, *SYSARCHIVE, *ALWCKPWRT, *INHCKPWRT, *ALWSAV, *CRTOBJSCAN, *SCAN, *RSTDRNMUNL, *RUNEXIT, *CRTRUNEXIT, *SETUID et *SETGID. Pour obtenir une description de cette valeur pour chaque attribut, reportez-vous à l'attribut correspondant dans le paramètre ATR.

*RESET

Admise pour l'attribut *USECOUNT. Le nombre de jours d'utilisation sera remis à zéro et la date d'utilisation sera définie sur la date en cours.

*NORMAL

Valeur admise pour les attributs *DISKSTGOPT et *MAINSTGOPT. Pour obtenir une description de cette valeur pour chaque attribut, reportez-vous à l'attribut correspondant dans le paramètre ATR.

*MINIMIZE

Valeur admise pour les attributs *DISKSTGOPT et *MAINSTGOPT. Pour obtenir une description de cette valeur pour chaque attribut, reportez-vous à l'attribut correspondant dans le paramètre ATR.

*DYNAMIC

Valeur admise pour les attributs *DISKSTGOPT et *MAINSTGOPT. Pour obtenir une description de cette valeur pour chaque attribut, reportez-vous à l'attribut correspondant dans le paramètre ATR.

*CHGONLY

Valeur admise pour les attributs *CRTOBJSCAN et *SCAN. Pour obtenir une description de cette valeur pour chaque attribut, reportez-vous à l'attribut correspondant dans le paramètre ATR.

*SYSVAL

Admise pour l'attribut *CRTOBJAUD. Pour obtenir une description de cette valeur pour chaque attribut, reportez-vous à l'attribut correspondant dans le paramètre ATR.

*NONE

Admise pour l'attribut *CRTOBJAUD. Obligatoire pour l'attribut *TEXT. Pour obtenir une description de cette valeur pour chaque attribut, reportez-vous à l'attribut correspondant dans le paramètre ATR.

*USRPRF

Admise pour l'attribut *CRTOBJAUD. Pour obtenir une description de cette valeur pour chaque attribut, reportez-vous à l'attribut correspondant dans le paramètre ATR.

*CHANGE

Admise pour l'attribut *CRTOBJAUD. Pour obtenir une description de cette valeur pour chaque attribut, reportez-vous à l'attribut correspondant dans le paramètre ATR.

*ALL

Admise pour l'attribut *CRTOBJAUD. Pour obtenir une description de cette valeur pour chaque attribut, reportez-vous à l'attribut correspondant dans le paramètre ATR.

1 à 65533

Admise pour l'attribut *CCSID. Indiquez l'ID codé de jeu de caractères (CCSID) des données et des attributs étendus de l'objet.

Branche du répertoire (SUBTREE)

Indique si l'attribut spécifié pour les objets de la sous-arborescence doit être modifié lorsque Objet (OBJ) désigne un objet de type répertoire.

*NONE

L'attribut des objets désignés par OBJ est modifié. Si l'objet est un répertoire, son attribut est modifié, mais celui de son contenu reste inchangé.

*ALL

L'attribut des objets désignés par OBJ est modifié. Si l'objet est un répertoire, son contenu est modifié, de même que le contenu de tous ses sous-répertoires.

Remarque :Le filtrage du paramètre OBJ ne s'applique qu'aux objets de premier niveau. Si l'objet de premier niveau est un répertoire, le filtrage ne s'applique pas à son contenu, ni au contenu de ses sous-répertoires.

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 le dernier élément du nom de chemin est un lien symbolique, indique si l'attribut du lien symbolique ou de l'objet désigné par ce lien doit être modifié.

*NO

L'attribut du lien symbolique n'est pas modifié. L'attribut de l'objet désigné par ce lien est modifié.

*YES

Si l'objet est un lien symbolique, l'attribut de ce lien est modifié. L'attribut de l'objet désigné par ce lien n'est pas modifié.

Texte (TEXT)

Indique une chaîne de texte à associer à l'objet.

*BLANK

Aucun texte n'est indiqué. En cas de texte existant associé à l'objet, ce texte est supprimé. Si une valeur autre que ATR(*TEXT) est indiquée, cette valeur doit également être indiquée.

valeur-alphanumérique

Il est possible d'indiquer jusqu'à 50 caractères. Le texte indiqué remplace tout texte précédent.

Exemples

Exemple 1 : Modification d'attribut pour une sous-arborescence de répertoires

CHGATR   OBJ('/MYINFO')  ATR(*HIDDEN)  VALUE(*YES)
         SUBTREE(*ALL)

Les attributs *HIDDEN de l'objet MESINFOS sont modifiés pour que celui-ci deviennent un objet caché. Si MESINFOS est un répertoire, cet attribut est modifié pour tous les objets contenus dans celui-ci et ses sous-répertoires car *ALL est indiqué pour le paramètre SUBTREE.

Messages d'erreur

Messages *ESCAPE

CPFA0AD

Fonction non acceptée par le système de fichiers.

CPFB414

Attributs modifiés pour les objets &1. Objets &2 non modifiés.