RTVAUTLE

La commande RTVAUTLE (Extraire un poste de liste d'autorisation) est utilisée dans un programme CL ou dans une procédure REXX pour extraire les droits d'un utilisateur sur une liste d'autorisation. Utilisée avec la commande CHGAUTLE (Modifier un poste de liste d'autorisation), elle permet d'ajouter des droits à cet utilisateur.

Le nom de la liste d'autorisation et le nom de l'utilisateur doivent être indiqués. Les variables de chacun de ces droits peuvent contenir des blancs si l'utilisateur ne dispose pas des droits ; elles contiennent en revanche la valeur correcte pour la commande CHGAUTLE, si l'utilisateur dispose de ces droits. Les valeurs sont renvoyées dans les variables indiquées pour l'utilisateur concerné.

Les utilisateurs qui peuvent recourir à cette commande pour extraire les droits des utilisateurs présents dans la liste sont les suivants :

• Le propriétaire de la liste d'autorisation.
• Un utilisateur disposant des droits *AUTLMGT sur la liste d'autorisation.
• Un utilisateur disposant des droits spéciaux *ALLOBJ.
• Un utilisateur disposant de droits sur la fonction d'administrateur de la sécurité de la base de données de l'IBM i (QIBM_DB_SECADM).

S'il ne remplit pas ces conditions, il ne peut extraire que ses propres droits ou les droits *PUBLIC.

Paramètres

Liste d'autorisation (AUTL)

Indique la liste d'autorisation dont sont extraits les droits de l'utilisateur.

Ce paramètre est obligatoire.

nom

Indiquez le nom de la liste d'autorisation à modifier.

Utilisat (USER)

Indique l'utilisateur associé aux informations à extraire. Si vous indiquez une variable, elle doit se présenter sous la forme d'une zone de 10 caractères contenant un nom d'utilisateur, ou la valeur *PUBLIC.

Ce paramètre est obligatoire.

*PUBLIC

Les informations renvoyées dans le paramètre indiqué s'appliquent aux utilisateurs n'ayant aucun droit spécifique sur la liste d'autorisation et dont le groupe n'a aucun droit sur cette dernière.

nom

Indiquez le nom du profil de l'utilisateur associé aux informations à extraire.

Variable pour *ALL (10) (ALL)

Indique le nom de la variable utilisée pour renvoyer la valeur spéciale *ALL si l'utilisateur dispose du droit correspondant. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Des blancs sont renvoyés pour cette variable si l'utilisateur ne dispose pas des droits correspondants.

Variable pour *CHANGE (10) (CHANGE)

Indique le nom de la variable utilisée pour renvoyer la valeur spéciale *CHANGE si l'utilisateur dispose du droit de modification. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Des blancs sont renvoyés pour cette variable si l'utilisateur ne dispose pas des droits correspondants.

Variable pour *USE (10) (USE)

Indique le nom de la variable utilisée pour renvoyer la valeur spéciale *USE si l'utilisateur dispose du droit d'utilisation. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Des blancs sont renvoyés pour cette variable si l'utilisateur ne dispose pas des droits correspondants.

Variable pour *EXCLUDE (10) (EXCLUDE)

Indique le nom de la variable utilisée pour renvoyer la valeur spéciale *EXCLUDE si l'utilisateur dispose du droit correspondant. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Des blancs sont renvoyés pour cette variable si l'utilisateur ne dispose pas des droits correspondants.

Variable pour *OBJALTER (10) (OBJALTER)

Indique le nom de la variable utilisée pour renvoyer *OBJALTER si l'utilisateur dispose du droit correspondant. Dans les programmes CL, cette variable comporte 10 caractères. Des blancs sont renvoyés dans la variable si l'utilisateur ne possède pas le droit *OBJALTER.

Des blancs sont renvoyés pour cette variable si l'utilisateur ne dispose pas des droits correspondants.

Variable pour *OBJEXIST (10) (OBJEXIST)

Indique le nom de la variable utilisée pour renvoyer la valeur spéciale *OBJEXIST si l'utilisateur dispose du droit correspondant. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Des blancs sont renvoyés pour cette variable si l'utilisateur ne dispose pas des droits correspondants.

Variable pour *OBJMGT (10) (OBJMGT)

Indique le nom de la variable utilisée pour renvoyer la valeur spéciale *OBJMGT si l'utilisateur dispose du droit de gestion des objets. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Des blancs sont renvoyés pour cette variable si l'utilisateur ne dispose pas des droits correspondants.

Variable pour *OBJOPR (10) (OBJOPR)

Indique le nom de la variable utilisée pour renvoyer la valeur spéciale *OBJOPR si l'utilisateur dispose du droit d'opération sur les objets. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Des blancs sont renvoyés pour cette variable si l'utilisateur ne dispose pas des droits correspondants.

Variable pour *OBJREF (10) (OBJREF)

Indique le nom de la variable utilisée pour renvoyer *OBJREF si l'utilisateur dispose du droit correspondant. Dans les programmes CL, cette variable comporte 10 caractères. Des blancs sont renvoyés dans la variable si l'utilisateur ne possède pas le droit *OBJREF.

Des blancs sont renvoyés pour cette variable si l'utilisateur ne dispose pas des droits correspondants.

Variable pour *READ (10) (READ)

Indique le nom de la variable utilisée pour renvoyer la valeur spéciale *READ si l'utilisateur dispose du droit de lecture. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Des blancs sont renvoyés pour cette variable si l'utilisateur ne dispose pas des droits correspondants.

Variable pour *ADD (10) (ADD)

Indique le nom de la variable utilisée pour renvoyer la valeur spéciale *ADD si l'utilisateur dispose du droit d'ajout. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Des blancs sont renvoyés pour cette variable si l'utilisateur ne dispose pas des droits correspondants.

Variable pour *UPD (10) (UPDATE)

Indique le nom de la variable utilisée pour renvoyer la valeur spéciale *UPD si l'utilisateur dispose du droit de mise à jour. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Des blancs sont renvoyés pour cette variable si l'utilisateur ne dispose pas des droits correspondants.

Variable pour *DLT (10) (DELETE)

Indique le nom de la variable utilisée pour renvoyer la valeur spéciale *DLT si l'utilisateur dispose du droit de suppression. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Des blancs sont renvoyés pour cette variable si l'utilisateur ne dispose pas des droits correspondants.

Variable pour *EXECUTE (10) (EXECUTE)

Indique le nom de la variable utilisée pour renvoyer *EXECUTE si l'utilisateur dispose du droit correspondant. Dans les programmes CL, cette variable comporte 10 caractères. Des espaces sont renvoyés dans la variable si l'utilisateur ne possède pas le droit *EXECUTE.

Des blancs sont renvoyés pour cette variable si l'utilisateur ne dispose pas des droits correspondants.

Variable pour *AUTLMGT (10) (AUTLMGT)

Indique le nom de la variable utilisée pour renvoyer la valeur spéciale *AUTLMGT si l'utilisateur dispose du droit de gestion de la liste d'autorisation.

Des blancs sont renvoyés pour cette variable si l'utilisateur ne dispose pas des droits correspondants.

Exemples

ADDAUTLE   AUTL(PAYROLL)  USER(TOM)
           AUT(*OBJOPR *READ *UPD *AUTLMGT)

Lorsque l'utilisateur SMITH appelle un programme en langage de contrôle contenant les éléments suivants :

DCL     &CHG        *CHAR 10
DCL     &ALL        *CHAR 10
DCL     &USE        *CHAR 10
DCL     &EXCL       *CHAR 10
DCL     &OBJOP      *CHAR 10
DCL     &ALTER      *CHAR 10
DCL     &REFER      *CHAR 10
DCL     &READ       *CHAR 10
DCL     &ADD        *CHAR 10
DCL     &UPD        *CHAR 10
DCL     &DLT        *CHAR 10
DCL     &EXEC       *CHAR 10
DCL     &AUTLM      *CHAR 10
 :
RTVAUTLE   AUTL(PAYROLL)  USER(TOM)  USE(&USE)  +
           OBJOPR(&OBJOP)  AUTLMGT(&AUTLM)

Cette commande extrait les droits suivants de la liste d'autorisation PAYROLL pour l'utilisateur TOM : *USE, *OBJOPR et *AUTLMGT. Si TOM ne dispose pas de ces droits, des blancs sont renvoyés.

Messages d'erreur

Messages *ESCAPE

CPF22A7

L'utilisateur &1 n'est pas sur la liste d'autorisation &2 : aucun droit extrait.

CPF22A8

Non autorisé à extraire les droits d'usage de l'utilisateur &1.

CPF2204

Profil utilisateur &1 non trouvé.

CPF2283

La liste d'autorisation &1 n'existe pas.

CPF2289

Impossible d'allouer la liste d'autorisation &1.