DLTAUTCOL

La commande DLTAUTCOL permet de supprimer les informations de collecte des droits pour un utilisateur, un objet ou un groupe d'objets.

Lors de la suppression des informations de collecte des droits pour un utilisateur :

• Le paramètre TYPE(*USRPRF) doit être indiqué.
• Les informations de collecte des droits pour un utilisateur ne peuvent être supprimées que lorsque la collecte des droits pour l'utilisateur spécifié est terminée à l'aide de la commande ENDAUTCOL (Terminer collecte droits).
• Le référentiel de collecte des droits pour l'utilisateur indiqué et les éventuelles informations de collecte des droits qu'il contient sont supprimés. La collecte des droits est démarrée pour cet utilisateur et le référentiel de collecte des droits est créé lorsque la commande STRAUTCOL (Démarrer collecte droits) est exécutée pour cet utilisateur.

Lors de la suppression des informations de collecte des droits pour des objets :

• Le paramètre TYPE(*OBJ) doit être indiqué.
• Les informations de collecte des droits pour un objet ne peuvent être supprimées que lorsque la collecte des droits pour les objets est terminée à l'aide de la commande ENDAUTCOL (Terminer collecte droits) avec l'option TYPE(*OBJAUTCOL).
• Les informations de collecte des droits pour l'objet ou le groupe d'objets indiqué sont supprimées.
• Le référentiel de collecte des droits pour les objets n'est supprimé que lorsque l'option OBJ(*ALL) est indiquée car le référentiel d'objets contient des informations pour un grand nombre d'objets.
• Vous pouvez supprimer les informations de collecte des droits pour un groupe d'objets associés à l'aide d'un masque de nom d'objet que vous indiquez au paramètre Objet (OBJ).
• Les informations de collecte des droits peuvent être supprimées pour une arborescence lorsque la suppression s'étend au répertoire, à son contenu et au contenu de tous les sous-répertoires associés. Lorsque l'option SUBTREE(*ALL) est indiquée, cette commande tente de supprimer les informations de collecte des droits pour tous les objets de la branche.

• 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 :

• Cette commande est fournie avec le droit public *EXCLUDE.
• Pour utiliser cette commande, vous devez disposer des droits spéciaux *ALLOBJ ou posséder des droits sur la fonction d'administrateur de la sécurité de la base de données de l'IBM i (QIBM_DB_SECADM).

Paramètres

Type de collecte des droits (TYPE)

Indique le type de collecte des droits à supprimer.

*USRPRF

Le référentiel de collecte des droits pour l'utilisateur indiqué et les éventuelles informations de collecte des droits qu'il contient sont supprimés.

*OBJ

Les informations de collecte des droits pour l'objet ou le groupe d'objets indiqué sont supprimées.

Profil utilisateur (USRPRF)

Indique le profil utilisateur dont le référentiel de collecte des droits et les informations de collecte des droits seront supprimés. Ce paramètre n'est admis que si TYPE(*USRPRF) est indiqué.

Les profils utilisateur suivants fournis par IBM ne sont pas admis pour ce paramètre :

QANZAGENT QAUTPROF QBRMS QCLUMGT QCLUSTER QCOLSRV QDBSHR QDBSHRDO QDFTOWN QDIRSRV QDLFM QDOC QDSNX QEJB QEJBSVR QFNC QGATE QIBMHELP QIPP QLPAUTO QLPINSTALL QLWISVR QMGTC QMSF QNETSPLF QNFSANON QNTP QPEX QPM400 QRJE QSNADS QSPL QSPLJOB QSRV QSRVAGT QSRVBAS QSYS QTCM QTCP QTFTP QTSTRQS QWEBADMIN QWSERVICE QYCMCIMOM QYPSJSVR

nom

Indiquez le nom du profil utilisateur dont le référentiel de collecte des droits et les informations de collecte des droits seront supprimés.

Objet (OBJ)

Indique l'objet (ou le masque correspondant à plusieurs objets) pour lequel les informations de collecte des droits seront supprimées. Ce paramètre n'est admis que si TYPE(*OBJ) est spécifié.

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

*ALL

Le référentiel de collecte des droits pour un objet et les informations de collecte des droits pour tous les objets seront supprimés.

nom-chemin

Indiquez le nom du chemin des objets pour lesquels les informations de collecte des droits seront supprimé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.

Inclusion objets dépendants (INCDEPOBJ)

Permet d'indiquer si les informations de collecte des droits pour les objets dépendants doivent être supprimées.

*NO

Les informations de collecte des droits pour les objets dépendants ne seront pas supprimées.

*LF

Si l'objet indiqué au paramètre Objet (OBJ) est un fichier physique, les informations de collecte des droits pour les fichiers logiques qui dépendent des données du fichier physique seront également supprimées.

Branche du répertoire (SUBTREE)

Permet d'indiquer si les informations de collecte des droits pour les objets de l'arborescence doivent ou non être supprimées si l'objet indiqué au paramètre Objet (OBJ) est un répertoire ou une bibliothèque.

*NONE

Les informations de collecte des droits pour les objets indiqués au paramètre OBJ sont supprimées. Si l'objet est un répertoire ou une bibliothèque, les informations de collecte des droits seront supprimées, mais les informations de collecte des droits pour le contenu du répertoire ou de la bibliothèque ne seront pas supprimées.

*ALL

Les informations de collecte des droits pour les objets indiqués au paramètre OBJ sont supprimées. Si l'objet est un répertoire ou une bibliothèque, les informations de collecte des droits seront supprimées, ainsi que les informations de collecte des droits pour le contenu du répertoire ou de la bibliothèque et les informations de collecte des droits pour le contenu de tous les sous-répertoires.

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 s'il convient de supprimer les informations de collecte des droits pour le lien symbolique ou pour l'objet qu'il désigne.

*NO

Les informations de collecte des droits pour l'objet de lien symbolique ne sont pas supprimées. Les informations de collecte des droits pour l'objet désigné par le lien symbolique sont supprimées.

*YES

Si l'objet est un lien symbolique, les informations de collecte des droits pour le lien symbolique sont supprimées. Les informations de collecte des droits pour l'objet désigné par le lien symbolique ne sont pas supprimées.

Exemples

Exemple 1 : suppression des informations de collecte des droits pour un utilisateur

DLTAUTCOL  TYPE(*USRPRF) USER(USER1)

Cette commande permet de supprimer le référentiel de collecte des droits pour USER1, ainsi que les données contenues dans ce référentiel.

Exemple 2 : suppression des informations de collecte des droits pour un fichier

DLTAUTCOL  TYPE(*OBJ) OBJ('/QSYS.LIB/MYAPPLIB.LIB/MYAPPINFO.FILE')

Cette commande supprime les informations de droits collectées pour le fichier MYAPPINFO dans la bibliothèque MYAPPLIB.

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 3 : suppression des informations de collecte des droits pour un lien symbolique avec SYMLNK(*NO)

DLTAUTCOL  TYPE(*OBJ) OBJ('/sym1') 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, les informations de collecte des droits pour dir1 sont supprimées. Les informations de collecte des droits pour l'objet de lien symbolique (sym1) et celles du contenu de dir1 ne sont pas supprimées.

Exemple 4 : suppression des informations de collecte des droits pour un lien symbolique avec SYMLNK(*YES)

DLTAUTCOL  TYPE(*OBJ) OBJ('/sym1') 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, les informations de collecte des droits pour sym1 sont supprimées. Les informations de collecte des droits pour l'objet désigné par le lien symbolique (dir1) et celles du contenu de dir1 ne sont pas supprimées.

Exemple 5 : suppression des informations de collecte des droits pour un répertoire avec SUBTREE(*ALL) et SYMLNK(*NO)

DLTAUTCOL  TYPE(*OBJ) OBJ('/dir1') 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, les informations de collecte des droits pour dir1, dir2.1, dir2.2, dir2.3, dir3.1, dir3.2, dirA sont supprimées. Les informations de collecte des droits pour sym3.3, dirB.1, dirB.2, dirB.3 ne sont pas supprimées.

Exemple 6 : suppression des informations de collecte des droits pour un répertoire avec SUBTREE(*ALL) et SYMLNK(*YES)

DLTAUTCOL  TYPE(*OBJ) OBJ('/dir1') 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, les informations de collecte des droits pour dir1, dir2.1, dir2.2, dir2.3, dir3.1, dir3.2, sym3.3 sont supprimées. Les informations de collecte des droits pour dirA, dirB.1, dirB.2, dirB.3 ne sont pas supprimées.

Exemple 7 : suppression des informations de collecte des droits pour un répertoire avec SUBTREE(*NONE) et SYMLNK(*NO)

DLTAUTCOL  TYPE(*OBJ) OBJ('/dir1') 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é.

Les informations de collecte des droits pour dir1 sont supprimées.

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

Exemple 8 : suppression des informations de collecte des droits pour tous les objets

DLTAUTCOL  TYPE(*OBJ) OBJ(*ALL)

Le référentiel de collecte des droits et les informations de collecte des droits pour tous les objets seront supprimés.

Messages d'erreur

Messages *ESCAPE

CPFA0AA

Une erreur s'est produite pendant l'allocation d'espace.

CPF2204

Profil utilisateur &1 non trouvé.

CPF2227

Une ou plusieurs erreurs survenues lors du traitement de la commande.

CPF4AC5

Vous n'êtes pas autorisé à démarrer, terminer, supprimer ou modifier la collecte des droits.

CPF4AC8

Le référentiel de collecte des droits ne peut pas être supprimé pour l'utilisateur &1.

CPF4ACB

Informations sur la collecte des droits supprimées pour &1 objets, non supprimées pour &2 objets.

CPF4ACD

Impossible de supprimer les informations de collecte des droits.