CHKDLO

La commande CHKDLO (Vérifier l'existence d'un document ou dossier) permet de vérifier si un objet existe et, le cas échéant, si un utilisateur est autorisé à y accéder.

Il peut être particulièrement utile d'effectuer ces vérifications avant que l'utilisateur tente d'accéder à plusieurs objets simultanément. La commande CHKDLO sert également à tester la validité de noms d'objets contenus dans des variables CL et à vérifier les droits sur ces objets sous la dépendance du programme.

Lorsque cette commande est lancée, le système recherche l'objet demandé. S'il le trouve, il vérifie si l'utilisateur détient l'autorisation précisée dans la commande CHKDLO. Si l'objet est introuvable ou si l'utilisateur n'a pas les droits appropriés, un message d'échappement s'affiche.

Lorsqu'elle est utilisée dans un programme CL, la commande CHKDLO est suivie de la commande MONMSG (Intercepter un message), qui intercepte les messages générés à l'exécution de cette commande.

Paramètres

Document ou dossier (DLO)

Document ou dossier sur lequel porte la vérification.

Ce paramètre est obligatoire.

nom

Nom du document ou du dossier sur lequel porte la vérification.

*SYSOBJNAM

Le nom d'objet système identifie le document ou le dossier sur lequel porte la vérification. Ce paramètre doit être précisé dans le cas d'un document ne faisant pas partie d'un dossier. S'il est défini, il peut aussi remplacer un nom de dossier ou de document. Le paramètre SYSOBJNAM et DLO(*SYSOBJNAM) doivent être indiqués ensemble.

Dossier (FLR)

Nom du dossier contenant le document ou le dossier sur lequel porte la vérification.

*NONE

L'objet en cours de vérification ne fait pas partie d'un dossier.

nom

Indiquez le nom du dossier contenant le document ou le dossier sur lequel porte la vérification, mais uniquement si un nom de dossier ou de document est précisé au paramètre DLO.

Nom d'objet système (SYSOBJNAM)

Nom d'objet système de l'objet sur lequel porte la vérification.

nom

Indiquez le nom d'objet système du document ou du dossier qui est vérifié. Vous devez l'indiquer si vous avez précisé *SYSOBJNAM au paramètre DLO.

Type d'objet (OBJTYPE)

Indique si la vérification porte sur un document ou un dossier. OBJTYPE(*DOC) ne peut pas être précisé si un nom de document ou de dossier est indiqué au paramètre DLO et que FLR(*NONE) soit également précisé.

*ANY

L'objet vérifié peut être un document ou un dossier.

*DOC

L'objet vérifié est un document.

*FLR

L'objet vérifié est un dossier.

Droits (AUT)

Droits sur lesquels porte la vérification.

*NONE

Les droits ne sont pas vérifiés.

*ALL

L'utilisateur peut effectuer toutes les opérations, à l'exception de celles réservées au propriétaire ou soumises au droit de gestion de la liste d'autorisation (*AUTLMGT). L'utilisateur a un droit d'existence sur l'objet Il peut également effectuer des fonctions de base sur ce dernier, le modifier, définir son niveau de protection et en transférer la propriété.

*CHANGE

L'utilisateur peut effectuer toutes les opérations sur l'objet, à l'exception de celles réservées au propriétaire ou contrôlées par les droits d'existence de l'objet (*OBJEXIST) et de gestion de l'objet (*OBJMGT). L'utilisateur peut réaliser des fonctions de base sur l'objet et le modifier. Le droit *CHANGE fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que les droits sur toutes les données. Si l'objet est une liste d'autorisation, vous pouvez ajouter, modifier ou supprimer des utilisateurs dans cette liste.

*USE

L'utilisateur peut effectuer des opérations de base sur l'objet, telles que l'exécution d'un programme ou la lecture d'un fichier. Il ne peut pas le modifier. Le droit d'utilisation (*USE) fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que le droit d'exécution (*EXECUTE).

*EXCLUDE

L'utilisateur n'a pas accès à l'objet.

Identificateur utilisateur (USRID)

Indique l'ID et l'adresse de l'utilisateur pour lequel la vérification de l'objet est effectuée. Si l'ID et l'adresse indiqués n'appartiennent pas à l'utilisateur qui a ouvert la session, leur propriétaire doit disposer du droit spécial *ALLOBJ (tous les objets) ou les deux utilisateurs doivent être inscrits sur le répertoire système et celui qui a ouvert la session doit être autorisé (à l'aide de la commande GRTUSRPMN) à agir pour le compte de l'utilisateur désigné. (Cette procuration est accordée à l'aide de la commande GRTUSRPMN.)

Valeurs uniques

*CURRENT

L'objet est vérifié pour le compte de l'utilisateur qui a ouvert la session. L'utilisateur doit être inscrit dans le répertoire du système ou disposer du droit spécial *ALLOBJ.

Elément 1 : ID utilisateur

ID-utilisateur

Indiquez l'identificateur (ID) de l'utilisateur pour le compte duquel l'objet est vérifié.

Elément 2 : Adresse

adresse

Indiquez l'adresse de l'utilisateur pour le compte duquel l'objet est vérifié.

Remarque :Si l'ID et l'adresse indiqués n'appartiennent pas à l'utilisateur qui a ouvert la session, leur propriétaire doit disposer du droit spécial *ALLOBJ ou les deux utilisateurs doivent être inscrits dans le répertoire du système et celui qui a ouvert la session doit être autorisé (à l'aide de la commande GRTUSRPMN) à agir pour le compte de l'utilisateur désigné. Ce paramètre n'est nécessaire que si une valeur autre que *NONE est précisée au paramètre AUT.

Exemples

CHKDLO   DLO(FLR1)  OBJTYPE(*ANY)  AUT(*NONE)
         USERID(USER1 ADDR1)

Cette commande permet de vérifier l'existence d'un dossier FLR1 pour un utilisateur dont l'ID utilisateur est USER1 et l'adresse ADDR1. Le droit d'accès de l'utilisateur à FLR1 n'est pas vérifié.

Messages d'erreur

Messages *ESCAPE

CPF8A11

La commande CHKDLO a échoué.

CPF8A75

Non autorisé à accéder au dossier &1.

CPF8A77

Dossier &1 introuvable.

CPF8A82

Document &2 introuvable dans dossier &1.

CPF8A83

Non autorisé au document &2 du dossier &1.