DSPDLONAM

Afficher nom doc ou dossier

En bref

La commande DSPDLONAM (Afficher un nom de document ou de dossier) permet d'afficher ou d'imprimer la présentation secondaire des noms de documents, documents de distribution ou dossiers classés.

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

Syntaxe minimale

DSPDLONAM DLO(…)

Paramètres

DLO Document ou dossier obligatoire
FLR Dossier
DOCID Identificateur du document
LADNTSP Horodatage LADN
SYSOBJNAM Nom d'objet système
OBJCLS Classe d'objet
OUTPUT Sortie

Astuce : dans une session 5250, tapez DSPDLONAM 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 DSPDLONAM (Afficher un nom de document ou de dossier) permet d'afficher ou d'imprimer la présentation secondaire des noms de documents, documents de distribution ou dossiers classés.

Restrictions :

Pour afficher les différents formats du nom, vous devez disposer du droit *USE (utilisation) sur le document ou le dossier classé.
Pour afficher les différents formats du nom du document de distribution, vous devez disposer du droit spécial *ALLOBJ (tous les objets).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
DLO	Document ou dossier	Valeur caractère, DOCID, LADNTSP, *SYSOBJNAM	Obligatoire, positionnel 1
FLR	Dossier	Valeur caractère, *NONE	Facultatif, positionnel 2
DOCID	Identificateur du document	Valeur caractère, *NONE	Facultatif
LADNTSP	Horodatage LADN	0000000000000001-FFFFFFFFFFFFFFFF, *NONE	Facultatif
SYSOBJNAM	Nom d'objet système	Nom, *NONE	Facultatif
OBJCLS	Classe d'objet	DOC, FLR, *DST	Facultatif
OUTPUT	Sortie	, PRINT	Facultatif

Document ou dossier (DLO)

Indique le document ou dossier dont les noms secondaires doivent s'afficher à l'écran ou être imprimés.

Ce paramètre est obligatoire.

*DOCID: Le document ou dossier est identifié par son LADN (nom de document attribué par la bibliothèque) précisé au paramètre DOCID. Le paramètre Dossier (FLR) doit avoir pour valeur *NONE.
*LADNTSP: Le document ou dossier est identifié par son horodatage LADN (nom de document attribué par la bibliothèque) indiqué au paramètre LADNSTP. Le paramètre FLR doit être *NONE.
*SYSOBJNAM: Le document ou dossier est identifié par le nom d'objet système indiqué au paramètre SYSOBJNAM. Le paramètre FLR doit être *NONE.
nom: Indiquez le nom attribué par l'utilisateur au document ou au dossier. Le dossier qui contient ce document ou ce dossier est précisé dans le paramètre FLR.

Ce paramètre est obligatoire.

Dossier (FLR)

Indique le chemin du dossier qui contient le document ou le dossier désigné dans le paramètre Document ou dossier (DLO). Le paramètre FLR doit être *NONE lorsque le paramètre DLO est *DOCID, *LADNTSP, ou *SYSOBJNAM.

*NONE: Le document ou dossier n'appartient à aucun dossier, ou est identifié par le paramètre DOCID, LADNTSP, ou SYSOBJNAM.
nom: Indique le nom du dossier qui contient le document ou le dossier désigné dans le paramètre DLO.

Identificateur du document (DOCID)

Indique le nom attribué au document par la bibliothèque. Il s'agit en fait du nom que le système a attribué au document lors de la création de ce dernier. Les documents classés hors du système local ont exclusivement ce type de nom. Les noms de documents attribués par la bibliothèque peuvent être déterminés à l'aide de la commande QRYDOCLIB (Interroger une bibliothèque de documents) ou à l'aide du message renvoyé par la commande FILDOC (Classer un document).

Les noms de documents attribués par la bibliothèque ont une longueur de 24 caractères, et doivent se conformer au format suivant :

AAAAMMJJHHMNSSCSNSNSNSNS

dans lequel :

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

*NONE: Aucun LADN n'est indiqué pour cet objet.
nom: Indique le nom attribué par la bibliothèque à l'objet du document ou dossier. Le LADN peut être défini à l'aide de la commande QRYDOCLIB (Interroger une bibliothèque de documents) ou du message renvoyé pour la commande FILDOC (Classer un document) ou une autre commande.

Horodatage LADN (LADNTSP)

Indique l'horodatage LADN du document ou du dossier. L'horodatage LADN est spécifié uniquement lorsque la valeur *LADNTSP est indiquée dans le paramètre Document ou dossier (DLO).

*NONE: Aucun horodatage LADN n'est indiqué pour cet objet.
horodatage: Indique l'horodatage LADN de la bibliothèque de documents.

Nom d'objet système (SYSOBJNAM)

Indique le nom d'objet système du document ou du dossier. Le nom d'objet système est spécifié uniquement lorsque la valeur *SYSOBJNAM est indiquée dans le paramètre Document ou dossier (DLO).

*NONE: Aucun nom d'objet système n'est indiqué pour cet objet.
nom: Indique le nom d'objet système de la bibliothèque de documents.

Classe d'objet (OBJCLS)

Indique la classe de l'objet à rechercher.

*DOC: Le document ou dossier indiqué est un document classé.
*FLR: Le document ou dossier indiqué est un dossier.
*DST: Le document ou dossier est un document de distribution.

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 à l'écran (dans le cas d'un travail interactif). La sortie est imprimée avec la sortie spoule de travaux (dans le cas d'un travail par lots).

*PRINT: Le résultat est placé dans un fichier spoule de la file d'attente en sortie du travail.

Exemples

DSPDLONAM    DLO(MYDOC)  FLR(MYFLR)  OBJCLS(*DOC)

Cette commande permet de trouver le document MYDOC dans le dossier MYFLR et d'afficher toutes les formes de son nom. Si le travail s'exécute en mode de traitement par lots, les informations sont imprimées et non affichées.

Messages d'erreur

Messages *ESCAPE

CPF8AC0: La commande &1 a échoué.
CPF8AC1: Accès aux documents de distribution non autorisé.
CPF8A75: Non autorisé à accéder au dossier &1.
CPF8A77: Dossier &1 introuvable.
CPF8A82: Document &2 introuvable dans dossier &1.
CPF8A83: Non autorisé au document &2 du dossier &1.