DSPAUTLOBJ

Afficher objets de liste d'aut

En bref

La commande DSPAUTLOBJ (Afficher les objets d'une liste d'autorisation) permet d'afficher la liste des objets sécurisés par la liste d'autorisation indiquée pour le paramètre Liste d'autorisation (AUTL).

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

Syntaxe minimale

DSPAUTLOBJ AUTL(…)

Paramètres

AUTL Liste d'autorisation obligatoire
OUTPUT Sortie
OUTFILE Fichier recevant la sortie
OUTMBR Options pour membre de sortie

Astuce : dans une session 5250, tapez DSPAUTLOBJ 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

Les utilisateurs autorisés à afficher les objets sont les suivants :

Un utilisateur qui figure dans la liste et qui possède des droits autres que *EXCLUDE.
Un utilisateur qui ne figure pas dans la liste et qui possède des droits publics autres que *EXCLUDE.
Un utilisateur qui dispose de droits sur la fonction d'administrateur de la sécurité de la base de données de l'IBM i (QIBM_DB_SECADM).

En revanche, si les droits privés l'empêchent d'utiliser un objet, *NOT AUTHORIZED s'affiche en regard de l'objet dans la zone de texte.

La vue QSYS2.AUTHORIZATION_LIST_INFO renvoie des informations similaires.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
AUTL	Liste d'autorisation	Nom	Obligatoire, positionnel 1
OUTPUT	Sortie	, PRINT, *OUTFILE	Facultatif, positionnel 2
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

Liste d'autorisation (AUTL)

Indique la liste d'autorisation dont la liste d'objets doit être affichée.

Ce paramètre est obligatoire.

nom: Indiquez le nom de la liste d'autorisation.

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 QADALO de la bibliothèque QSYS et de format QSYDALO 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

DSPAUTLOBJ   AUTL(PAYROLL)  OUTPUT(*OUTFILE)
             OUTFILE(*LIBL/PAYROLL)  OUTMBR(DARL *REPLACE)

Cette commande place la sortie dans le fichier base de données PAYROLL, sous le nom de membre DARL. Si ce dernier existe déjà, le système le supprime et ajoute les nouveaux enregistrements.

Messages d'erreur

Messages *ESCAPE

CPF22AF: Aucun droit sur les objets protégés par liste d'autorisation &1.
CPF2283: La liste d'autorisation &1 n'existe pas.
CPF2289: Impossible d'allouer la liste d'autorisation &1.
CPF9860: Erreur lors du traitement du fichier de sortie.