RTVDLOAUT

La commande RTVDLOAUT permet d'extraire les droits attribués sur un dossier ou document classé.

Restrictions :

• Un utilisateur souhaitant extraire des droits doit figurer dans le répertoire de distribution du système.
• Un utilisateur doit au moins disposer du droit d'utilisation *USE sur le document ou dossier.
• Un utilisateur disposant de droits inférieurs au droit *ALL sur le document ou dossier ne peut extraire que ses droits ou ceux du propriétaire.
• Un utilisateur souhaitant extraire l'ensemble des droits doit disposer du droit *ALL ou du droit spécial *ALLOBJ ou bien être le propriétaire du document ou dossier.
• Un utilisateur souhaitant extraire les droits publics sur le dossier *ROOT doit disposer du droit spécial *ALLOBJ.

Paramètres

Document ou dossier (DLO)

Nom du document ou dossier pour lequel sont extraits les droits.

*ROOT

Le dossier principal contient l'ensemble des dossiers de premier niveau. Lorsque le dossier *ROOT est indiqué, seuls les droits publics sont retournés par le paramètre PUBAUT. Aucun autre droit n'est retourné.

*LADNTSP

L'horodatage du nom LADN (nom de document attribué par la bibliothèque) indiqué au paramètre LADNTSP est utilisé pour identifier le document ou dossier.

*SYSOBJNAM

Le nom d'objet système indiqué au paramètre SYSOBJNAM est utilisé pour identifier le document ou dossier.

nom

Indiquez le nom attribué par l'utilisateur au document ou au dossier.

Dossier (FLR)

Nom du dossier contenant l'objet indiqué au paramètre DLO.

*NONE

Le nom du dossier contenant l'objet n'est pas indiqué, l'objet ne figure pas dans un dossier, l'objet est indiqué au paramètre LADNTSP ou SYSOBJNAM, ou la valeur *ROOT a été attribuée au paramètre DLO.

nom

Indiquez le nom du dossier contenant l'objet.

Remarque :FLR(*NONE) doit être indiqué si l'objet est un dossier de premier niveau.

Identificateur du document (DOCID)

Nom de document ou dossier attribué par la bibliothèque.

*NONE

L'objet n'est pas identifié à l'aide de son identificateur de document (DOCID).

identificateur-document

Indiquez l'identificateur du document ou dossier. Cet identificateur comporte 24 caractères hexadécimaux, au format YYYYMMDDHHMNSSHSSNSNSNSN, où :

• AAAA = année
• MM = mois
• JJ = jour
• HH = heures
• MN = minutes
• SS = secondes
• CS = centièmes de seconde
• NSNSNSNS = nom système

Horodatage LADN (LADNTSP)

Horodatage LADN du document ou dossier.

*NONE

L'objet n'est pas identifié par son horodatage LADN.

horodatage

Indiquez l'horodatage LADN du document ou dossier. Cet horodatage comporte 16 caractères hexadécimaux, au format YYYYMMDDHHMNSSHS, où :

• AAAA = année
• MM = mois
• JJ = jour
• HH = heures
• MN = minutes
• SS = secondes
• CS = centièmes de seconde

Nom d'objet système (SYSOBJNAM)

Nom de l'objet système.

*NONE

L'objet n'est pas identifié à l'aide de son nom d'objet système.

nom

Indiquez le nom d'objet système (10 caractères) du document ou dossier.

Premier poste de droit util (STRUSRAUTE)

Permet d'indiquer le numéro du premier droit utilisateur à utiliser lors de l'extraction de droits utilisateur spécifiques (paramètre USRAUT). Le paramètre STRUSRAUTE permet d'extraire des droits utilisateur spécifiques pour un objet DLO comportant plus de 50 droits utilisateur spécifiques. Si aucune variable CL n'est indiquée au paramètre USRAUT, ce dernier est ignoré.

1

Les droits utilisateurs seront retournés en commençant par le premier droit utilisateur spécifique.

2-99 999

Les droits utilisateur seront retournés en commençant par le droit indiqué. Si la valeur indiquée est supérieure au nombre de droits utilisateur spécifiques pour l'objet DLO, un message d'erreur est émis et aucun droit utilisateur spécifique n'est renvoyé.

Variable pour OWNER (10) (OWNER)

Indique le nom d'une variable CL de 10 caractères utilisée pour extraire le propriétaire du document ou dossier sélectionné.

Variable pour AUTL (10) (AUTL)

Indique le nom d'une variable CL de 10 caractères utilisée pour extraire la liste d'autorisation attribuée au document ou dossier sélectionné. La valeur *NONE est retournée si aucune liste d'autorisation n'est attribuée.

Variable pour SENSITIV (20) (SENSITIV)

Indique le nom d'une variable CL de 20 caractères utilisée pour extraire le niveau de protection attribué au document ou dossier sélectionné.

*NONE

Le document n'est pas protégé.

*PERSONAL

Le document est destiné personnellement à un utilisateur.

*PRIVATE

Le document contient des informations auxquelles seul le propriétaire doit accéder.

*CONFIDENTIAL

Le document contient des informations dont la manipulation obéit à des règles internes à la société.

Variable pour PUBAUT (10) (PUBAUT)

Indique le nom d'une variable CL de 10 caractères utilisée pour extraire les droits publics attribués au document ou dossier sélectionné.

*USE

L'utilisateur peut afficher, imprimer ou copier le document ou dossier.

*CHANGE

L'utilisateur peut effectuer toutes les opérations admises pour le droit *USE et peut également modifier et marquer le document pour stockage hors ligne.

*ALL

L'utilisateur peut effectuer toutes les opérations sur le document, excepté modifier la propriété du document ou dossier ou s'attribuer le droit de gestion du document après révocation des droits.

*EXCLUDE

Tous les utilisateurs ne disposant pas de droits sur ce document ou dossier ne sont pas autorisés à y accéder.

USER DEF

Les droits sur ce document ne sont pas ceux définis par le système (*ALL, *CHANGE, *USE, *EXCLUDE) mais sont définis par l'utilisateur.

*AUTL

Le droit précisé dans la liste d'autorisation utilisée pour ce document détermine le droit public.

Variable pour CHKOUTUSR (32) (CHKOUTUSR)

Indique le nom d'une variable CL de 32 caractères utilisée pour extraire le profil de l'utilisateur ou d'un utilisateur agissant en son nom, qui a verrouillé le document. Si le document n'a été verrouillé par aucun utilisateur, cette zone est à blanc. Si le document n'a été verrouillé par aucun utilisateur agissant au nom d'un autre utilisateur, les 16 dernières positions de cette zone sont à blanc.

Variable pour ACC (220) (ACC)

Indique le nom d'une variable CL de 200 caractères utilisée pour extraire les codes d'accès attribués au document ou dossier sélectionné.

Variable pour USRAUT (1020) (USRAUT)

Indique le nom d'une variable CL de 1020 caractères utilisée pour extraire les droits utilisateur spécifiques attribués au document ou dossier. USRAUT retourne au maximum 50 droits spécifiques par appel de la commande RTVDLOAUT. Si plus de 50 droits utilisateur spécifiques sont associés au document ou dossier, vous pouvez utiliser le paramètre STRUSRAUTE lors des appels suivants de la commande RTVDLOAUT pour retourner les droits utilisateur en commençant par les numéros de postes indiqués.

Dans la variable CL de 1020 caractères figurent aussi le nombre total d'utilisateurs possédant les droits requis, le nombre de droits retournés ainsi que les numéros des droits de début et de fin.

Par exemple :

RTVDLOAUT DLO(MONDOC) FLR(MONDOS) USRAUT(&RTNUSRAUT) + STRUSRAUTE(1)

est exécutée lorsque 55 utilisateurs sont autorisés pour MONDOC. Le nombre total de droits utilisateur spécifiques sera égal à 55. Les postes relatifs aux droits qui seront renvoyés seront au nombre de 50. Le premier de ces postes portera le numéro 1, et le dernier, le numéro 51.

Variable pour GRPAUT (340) (GRPAUT)

Indique le nom d'une variable CL de 340 caractères utilisée pour extraire les droits de groupe attribués au document ou dossier indiqué. Seuls les groupes associés à l'utilisateur de cette commande sont retournés.

Variable pour PGP (10) (PGP)

Indique le nom d'une variable CL de 10 caractères utilisée pour extraire le groupe principal attribué au document ou dossier indiqué. La valeur *NONE est retournée si aucun groupe principal n'a été attribué.

Exemples

Exemple 1 : Recherche du propriétaire d'un objet de la bibliothèque de documents

RTVDLOAUT   DLO(MYDOC)  FLR(MYFLR)  OWNER(&OWNER)

Cette commande extrait les informations sur le propriétaire de l'objet de bibliothèque de documents MYDOC dans le dossier MYFLR et enregistre la valeur dans la variable &OWNER.

Exemple 2 : Recherche des droits d'utilisateur privé sur un document

RTVDLOAUT   DLO(MYDOC)  FLR(MYFLR)
            USRAUT(&RTNUSRAUT)  STRUSRAUTE(1)

Cette commande extrait les droits d'utilisateur associés au document MYDOC du dossier MYFLR et enregistre la liste dans la variable &RTNUSRAUT. Cette liste peut contenir un maximum de 50 utilisateurs privés ainsi que leurs droits.

Messages d'erreur

Messages *ESCAPE

CPF8AC0

La commande &1 a échoué.