DSPPFM

Afficher membre fich physique

En bref

La commande DSPPFM (Afficher un membre de fichier physique) permet d'afficher un membre de fichier physique base de données.

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

Syntaxe minimale

DSPPFM FILE(…)

Paramètres

FILE Fichier obligatoire
MBR Membre
FROMRCD A partir de l'enregistrement

Astuce : dans une session 5250, tapez DSPPFM 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 : Environnements interactifs (*INTERACT *IPGM *IREXX *EXEC)
Compatible multitâche : Non

La commande DSPPFM (Afficher un membre de fichier physique) permet d'afficher un membre de fichier physique base de données. Les enregistrements sont affichés en ordre d'arrivée, même si le fichier a été défini avec un accès par clé. Vous pouvez faire défiler le fichier, rechercher un enregistrement par son rang, ou encore indiquer une position de départ dans l'enregistrement. Vous pouvez également choisir d'afficher les enregistrements sous forme alphanumérique ou hexadécimale.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FILE	Fichier	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Fichier	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
MBR	Membre	Nom, FIRST, LAST	Facultatif, positionnel 2
FROMRCD	A partir de l'enregistrement	Entier non signé, 1, END, ALLDATA	Facultatif

Fichier (FILE)

Indique le nom et la bibliothèque du fichier physique contenant le membre à afficher.

Ce paramètre est obligatoire.

Qualificatif 2: Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB: Bibliothèque de l'unité d'exécution en cours utilisée pour localiser le fichier. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours, la bibliothèque QGPL est utilisée.

nom: Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Membre (MBR)

Indique le nom du membre à afficher.

*FIRST: Le premier membre du fichier physique indiqué est affiché.
*LAST: Le dernier membre du fichier physique indiqué est affiché.
nom-membre: Indiquez le nom du membre.

A partir de l'enregistrement (FROMRCD)

Désigne l'enregistrement de fichier physique qui sera affiché sur la première ligne de l'affichage initial. Si le numéro d'enregistrement précisé correspond à un enregistrement supprimé, l'écran affiche le premier enregistrement suivant celui qui a été supprimé. Vous pouvez afficher autant d'enregistrements que nécessaire à l'aide des touches de défilement de page.

Les valeurs possibles sont les suivantes :

1: L'enregistrement numéro 1 ou le premier enregistrement non supprimé du fichier physique est affiché. Pour un fichier réparti, il s'agit du premier enregistrement non supprimé du membre local ; seules les données locales seront affichées.
*END: Le dernier enregistrement non supprimé du fichier physique est affiché. La valeur *END indique la dernière page remplie afin que le dernier enregistrement du fichier physique apparaisse au bas de l'écran. Pour un fichier réparti, il s'agit du dernier enregistrement non supprimé du membre local ; seules les données locales seront affichées.
*ALLDATA: Toutes les données d'un fichier réparti, y compris les données éloignées, sont affichées. Si *ALLDATA est indiqué pour un fichier non réparti, le système le traite comme FROMRCD(1).
numéro-enregistrement: Indiquez le numéro de l'enregistrement affiché sur la première ligne de l'écran initial. Pour un fichier réparti, il s'agit du numéro d'enregistrement du membre local ; seules les données locales seront affichées.

Exemples

Exemple 1 : affichage du premier membre d'un fichier

DSPPFM   FILE(TESTA)

Cette commande permet d'afficher le premier membre d'un fichier physique nommé TESTA. Le fichier est recherché dans la liste des bibliothèques.

Exemple 2 : affichage d'un membre de fichier

DSPPFM   FILE(SAMPLE/TESTB)  MBR(PROGRAM)

Cette commande permet d'afficher le membre PROGRAM du fichier physique TESTB dans la bibliothèque SAMPLE.

Messages d'erreur

Messages *ESCAPE

CPF8056: &1 de &2 n'est pas un fichier physique.
CPF9810: Bibliothèque &1 non trouvée.
CPF9812: Fichier &1 non trouvé dans la bibliothèque &2.
CPF9820: Non autorisé à utiliser la bibliothèque &1.
CPF9822: Non autorisé au fichier &1 de &2.
CPF9845: Erreur lors de l'ouverture du fichier &1.
CPF9846: Erreur lors du traitement du fichier &1 de &2.
CPF9847: Erreur lors de la fermeture du fichier &1 de bibliothèque &2.