DSPPGMADP

Afficher programmes adoptant

En bref

La commande DSPPGMADP (Afficher les programmes adoptant) permet d'afficher les objets qui adoptent les droits spéciaux et privés du profil utilisateur indiqué.

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

Syntaxe minimale

DSPPGMADP USRPRF(…)

Paramètres

USRPRF Profil utilisateur obligatoire
OBJTYPE Type d'objet
OUTPUT Sortie
OUTFILE Fichier recevant la sortie
OUTMBR Options pour membre de sortie

Astuce : dans une session 5250, tapez DSPPGMADP 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 DSPPGMADP (Afficher les programmes adoptant) permet d'afficher les objets qui adoptent les droits spéciaux et privés du profil utilisateur indiqué. Vous pouvez ainsi évaluer les conséquences de l'adoption d'un programme sur la sécurité.

Restrictions :

Vous devez disposer du droit de gestion de l'objet (*OBJMGT) sur le profil utilisateur.
Le profil utilisateur indiqué dans la commande est verrouillé lors de l'exécution de la commande. Ce verrouillage empêche, par exemple, la modification de la propriété des objets. Si ce profil détient un grand nombre d'objets, il peut être verrouillé pendant une longue période.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
USRPRF	Profil utilisateur	Nom	Obligatoire, positionnel 1
OBJTYPE	Type d'objet	Valeurs uniques: ALL Autres valeurs (jusqu'à 3 répétitions): PGM, SQLPKG, SRVPGM	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 le profil utilisateur dont les droits sont adoptés.

Ce paramètre est obligatoire.

nom: Indiquez le nom d'un profil utilisateur. Les objets sont vérifiés pour déterminer s'ils adoptent des droits privés et spéciaux de ce profil utilisateur.

Type d'objet (OBJTYPE)

Indique le type des objets à afficher.

Valeurs uniques

*ALL: Tous les objets qui adoptent le profil utilisateur indiqué dans le paramètre Profil utilisateur (USRPRF) sont affichés.

Autres valeurs (jusqu'à 3 répétitions)

*PGM: Seuls les programmes qui adoptent le profil utilisateur indiqué sont répertoriés.
*SQLPKG: Seuls les modules SQL qui adoptent le profil utilisateur indiqué sont répertoriés.
*SRVPGM: Seuls les programmes de service adoptant le profil utilisateur indiqué sont affichés.

Sortie (OUTPUT)

Indique si la sortie générée par la commande doit être affichée sur le poste de travail demandeur, ou imprimée avec la sortie spoule du travail.

*: La sortie est affichée (s'il s'agit d'un travail interactif) ou imprimée en 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 :Si un nouveau fichier est créé, le fichier système QADPGMAD de la bibliothèque QSYS et de format QSYPGMAD est utilisé comme modèle.

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

DSPPGMADP   USRPRF(ABC)  OUTPUT(*PRINT)

Cette commande imprime la liste des objets qui adoptent les droits spéciaux et privés du profil utilisateur ABC.

Messages d'erreur

Messages *ESCAPE

CPF2204: Profil utilisateur &1 non trouvé.
CPF2213: Impossible d'allouer le profil utilisateur &1.
CPF2217: Non autorisé au profil utilisateur &1.
CPF9845: Erreur lors de l'ouverture du fichier &1.
CPF9846: Erreur lors du traitement du fichier &1 de &2.
CPF9850: Substitution non admise pour fichier imprimante &1.
CPF9860: Erreur lors du traitement du fichier de sortie.