Aller au contenu

DSPUSRPRF

Afficher un profil utilisateur

En bref

La commande DSPUSRPRF (Afficher un profil utilisateur) permet d'afficher le contenu d'un profil utilisateur : les limites opérationnelles de l'utilisateur sur les ressources du système, le nom des objets, commandes et unités sur lesquels il détient des droits spécifiques, ainsi que le nom des…

DSPUSRPRF se lit DSP (Afficher) + USRPRF. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

DSPUSRPRF USRPRF(…)

Paramètres

  • USRPRF Profil utilisateur obligatoire
  • TYPE Type d'information
  • OUTPUT Sortie
  • OUTFILE Fichier recevant la sortie
  • OUTMBR Options pour membre de sortie

Astuce : dans une session 5250, tapez DSPUSRPRF puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande DSPUSRPRF (Afficher un profil utilisateur) permet d'afficher le contenu d'un profil utilisateur : les limites opérationnelles de l'utilisateur sur les ressources du système, le nom des objets, commandes et unités sur lesquels il détient des droits spécifiques, ainsi que le nom des objets dont il est propriétaire et pour lesquels il représente le groupe principal. Ce contenu comprend le nom des objets, commandes et unités sur lesquels l'utilisateur détient des droits spécifiques, ainsi que le nom des objets dont il est propriétaire et pour lesquels il représente le groupe principal.

Les objets appartenant au profil utilisateur n'apparaissent pas sur les écrans *CMDAUT, *DEVAUT, *OBJAUT ou *OBJPGP.

Cette commande n'affiche pas le mot de passe ni les informations concernant les objets autorisés pour une utilisation publique. Le mot de passe du document ne s'affiche pas à l'écran *BASIC ni sur une sortie de commande CL. Tout utilisateur du système peut être autorisé à utiliser la commande DSPUSRPRF, mais l'utilisateur ayant émis la demande doit détenir les droits de lecture (*READ) sur le profil utilisateur affiché.

L'exécution de la fonction DSPUSRPRF peut être longue, suivant le nombre d'objets dont le profil est propriétaire et qu'il est autorisé à utiliser.

Restrictions : Le nom de l'utilisateur ne peut être indiqué sous la forme USRPRF(*ALL) ou USRPRF(nom-générique) que lorsque TYPE(*BASIC) et OUTPUT(*OUTFILE) sont indiqués.

Les vues QSYS2.USER_INFO et QSYS2.GROUP_PROFILE_ENTRIES renvoient des informations similaires.

Paramètres

Mot-clé Description Valeurs possibles Remarques
USRPRF Profil utilisateur Nom générique, nom, *ALL Obligatoire, positionnel 1
TYPE Type d'information *BASIC, *ALL, *CMDAUT, *DEVAUT, *GRPMBR, *OBJAUT, *OBJOWN, *OBJPGP Facultatif, positionnel 2
OUTPUT Sortie *, *PRINT, *OUTFILE Facultatif
OUTFILE Fichier recevant la sortie Nom d'objet qualifié Facultatif
Qualificatif 1: Fichier recevant la sortie Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
OUTMBR Options pour membre de sortie Liste d'éléments Facultatif
Élément 1: Membre recevant la sortie Nom, *FIRST
Élément 2: Remplacement ou ajout enregs *REPLACE, *ADD

Profil utilisateur (USRPRF)

Indique les profils utilisateur à afficher.

Ce paramètre est obligatoire.

*ALL
Tous les profils utilisateur sont affichés.
nom-générique
Indique le nom générique du profil utilisateur à afficher. Un nom générique est une chaîne de caractères contenant un ou plusieurs caractères suivis d'un astérisque (*). Si un nom générique est indiqué, tous les profils utilisateur dont le nom commence par le même préfixe que ce nom générique sont affichés.
nom
Indique le nom du profil utilisateur à afficher.

Remarque :*ALL ou un nom générique ne peuvent être indiqués que lorsque TYPE(*BASIC) et OUTPUT(*OUTFILE) le sont également.

Type d'information (TYPE)

Indique les types d'informations pouvant être affichés. Vous pouvez afficher les types d'informations suivants :

  • Les informations de base du profil utilisateur.
  • Les commandes pour lesquelles le profil utilisateur détient des droits spécifiques.
  • Les unités pour lesquelles le profil utilisateur détient des droits spécifiques.
  • Tous les objets (y compris les commandes et les unités) pour lesquels l'utilisateur détient des droits spécifiques, et les droits attribués pour ces objets.
  • Les objets qui sont la propriété de l'utilisateur.
  • Les objets pour lesquels l'utilisateur constitue le groupe principal.
  • Les membres du groupe, si le profil utilisateur est un profil de groupe.
*BASIC
Tous les paramètres définis dans le profil utilisateur.
*ALL
Toutes les informations du profil utilisateur.
*CMDAUT
Commandes CL sur lesquelles l'utilisateur a des droits spécifiques.
*DEVAUT
Unités sur lesquelles l'utilisateur a des droits spécifiques.
*OBJAUT
Nom des objets (à l'exception des objets associés à des droits publics) sur lesquels l'utilisateur a des droits spécifiques, nature de ces droits et type de ces objets.
*OBJOWN
Nombre total, nom, type des objets possédés et bibliothèque dans laquelle ils résident. Indique également si l'objet est un dépositaire de droits.
*OBJPGP
Nombre total, nom, type des objets pour lesquels l'utilisateur représente le groupe principal, bibliothèque dans laquelle ces objets résident et droits du groupe principal. Indique également si l'objet est un dépositaire de droits.
*GRPMBR
Membres d'un groupe. Ces informations ne peuvent être obtenues que si le profil utilisateur affiché est un profil de groupe.

Sortie (OUTPUT)

Indique la destination de la sortie générée par la commande.

*
La sortie est affichée (s'il s'agit d'un travail interactif) ou imprimée avec la sortie spoule du travail (s'il s'agit d'un travail par lots).
*PRINT
Le résultat est placé dans un fichier spoule de la file d'attente en sortie du travail.
*OUTFILE
La sortie est dirigée vers le fichier base de données indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE).

Fichier recevant la sortie (OUTFILE)

Indique le fichier de base de données vers lequel la sortie générée par la commande est dirigée. Si ce fichier n'existe pas, la commande en crée un dans la bibliothèque précisée. S'il existe déjà, les droits publics sur le fichier sont les mêmes que le droit de création de la pour la bibliothèque contenant le fichier. Pour afficher ce droit, utilisez la commande DSPLIBD (Afficher une description de bibliothèque).

Qualificatif 1 : Fichier recevant la sortie

nom
Indiquez le nom du fichier de base de données vers lequel la sortie générée de la commande est dirigée.

Qualificateur 2: Biblio

*LIBL
Le fichier est recherché dans la liste des bibliothèques. Si le système ne le trouve pas, il en crée un dans la bibliothèque en cours. S'il n'existe pas de bibliothèque en cours, le fichier est créé dans la bibliothèque QGPL.
*CURLIB
Bibliothèque de l'unité d'exécution en cours utilisée pour localiser le fichier. Si cette bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.
nom
Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Remarque :S'il s'agit d'une création de fichier et que *BASIC est indiqué pour le paramètre TYPE Type d'information (TYPE), le système utilise comme modèle QADSPUPB dans QSYS avec pour nom de format QSYDSUPB.

S'il s'agit d'une création de fichier et que *OBJAUT est indiqué pour le paramètre TYPE, le système utilise comme modèle QADSPUPA dans QSYS avec pour nom de format QSYDSUPA.

S'il s'agit d'une création de fichier et que *OBJOWN est indiqué pour le paramètre TYPE, le système utilise comme modèle QADSPUPO dans QSYS avec pour nom de format QSYDSUPO.

S'il s'agit d'une création de fichier et que *OBJPGP est indiqué pour le paramètre TYPE, le système utilise comme modèle QADSPUPG dans QSYS avec pour nom de format QSYDSUPG.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre de fichier base de données dans lequel est envoyée la sortie de la commande.

Elément 1 : Membre recevant la sortie

*FIRST
Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et que le membre n'existe pas, le système en crée un du nom indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE). Si le membre existe, vous avez la possibilité d'ajouter de nouveaux enregistrements à la fin du membre existant ou de le mettre à blanc et de lui ajouter les nouveaux enregistrements.
nom
Indiquez le nom du membre de fichier destiné à recevoir la sortie. Si aucun membre de ce nom n'existe, le système le crée.

Elément 2 : Remplacement ou ajout enregs

*REPLACE
Le système met à blanc le membre existant et ajoute les nouveaux enregistrements.
*ADD
Le système ajoute les nouveaux enregistrements à la suite des enregistrements existants.

Exemples

Exemple 1 : affichage des informations de base

DSPUSRPRF   USRPRF(THSMITH)

Cette commande affiche les informations de base du profil utilisateur THSMITH car TYPE(*BASIC) est la valeur par défaut. Les commandes, unités et objets dont l'utilisateur a le droit de se servir ne sont pas affichés. Etant donné que OUTPUT(*) est également pris par défaut, les informations opérationnelles sont affichées ou imprimées selon la méthode de soumission de la commande.

Exemple 2 : impression d'une liste d'objets

DSPUSRPRF   USRPRF(RTJOHNSON)  TYPE(*OBJOWN)  OUTPUT(*PRINT)

Cette commande imprime la liste des objets dont RTJOHNSON est propriétaire. Cette liste contient les noms et les types des objets, ainsi que les noms des bibliothèques où ils sont situés.

Messages d'erreur

Messages *ESCAPE

CPF22DF
Impossible de traiter la demande pour le profil utilisateur &1.
CPF22D8
Utilisation d'un nom générique incorrect pour un profil utilisateur.
CPF22D9
Il n'existe pas de profil utilisateur du nom indiqué.
CPF22EB
Impossible de traiter la demande pour le profil utilisateur &1.
CPF2204
Profil utilisateur &1 non trouvé.
CPF2213
Impossible d'allouer le profil utilisateur &1.
CPF2217
Non autorisé au profil utilisateur &1.
CPF2257
Le profil utilisateur &1 n'est pas un profil de groupe.
CPF9860
Erreur lors du traitement du fichier de sortie.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.