DSPRMTDFN

Afficher définition éloignée

En bref

La commande DSPRMTDFN (Afficher une définition éloignée) vous permet d'afficher ou d'imprimer des définitions éloignées d'un système.

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

Syntaxe minimale

DSPRMTDFN SYSTEM(…)

Paramètres

SYSTEM Nom de système obligatoire
OUTPUT Sortie
OUTFILE Fichier recevant la sortie
OUTMBR Options pour membre de sortie

Astuce : dans une session 5250, tapez DSPRMTDFN 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 DSPRMTDFN (Afficher une définition éloignée) vous permet d'afficher ou d'imprimer des définitions éloignées d'un système. La sortie peut être affichée, imprimée ou orientée vers un fichier base de données.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
SYSTEM	Nom de système	Liste d'éléments	Obligatoire, positionnel 1
	Élément 1: Nom de système	Valeur caractère, ANY, ALL
	Élément 2: Groupe de système	Valeur caractère
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	ADD, REPLACE

Nom de système (SYSTEM)

Nom et groupe du système éloigné qui est affiché.

Les valeurs possibles sont les suivantes :

*ANY: Permet d'afficher la définition par défaut d'un système éloigné ne figurant pas dans les autres postes.
*ALL: Permet d'afficher toutes les définitions de système éloignées.

La valeur possible pour Nom de système est la suivante :

nom-système: Indiquez le nom de système éloigné à afficher.

La valeur possible pour Groupe de système est la suivante :

groupe-système: Indiquez le nom de groupe éloigné du système à afficher, sauf si le nom de groupe est à blanc.

Sortie (OUTPUT)

Indique si la sortie de cette commande est affichée, imprimée ou envoyée à un fichier base de données. Pour plus d'informations, reportez-vous à l'annexe A, intitulée "Expanded Parameter Descriptions" de la brochure CL Reference.

Les valeurs possibles sont les suivantes :

*: La sortie est affichée à l'écran (dans le cas d'un travail interactif) ou imprimée avec la sortie spoule du travail (dans le cas d'un travail par lots).
*PRINT: La sortie est imprimée avec la sortie spoule du travail.
*OUTFILE: La sortie est envoyée dans le fichier base de données indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE).

Fichier recevant la sortie (OUTFILE)

Nom qualifié du fichier base de données auquel la sortie de cette commande est envoyée. Si le fichier n'existe pas, le système en crée un dans la bibliothèque indiquée. Lorsqu'un nouveau fichier est créé, le fichier système QAOCRMTDFN de la bibliothèque QSYS et le format d'enregistrement RMTDFN sont pris comme modèles. Si le fichier existe déjà, il doit avoir ce format.

Pour la bibliothèque, les valeurs possibles sont les suivantes :

*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: Le fichier est recherché dans la bibliothèque en cours pour le travail. Si aucune bibliothèque n'est indiquée pour ce travail, c'est QGPL qui est prise en compte.
nom-bibliothèque: Indiquez le nom de la bibliothèque contenant le fichier.

La valeur seule possible est la suivante :

nom-fichier: Indiquez le nom du fichier de sortie.

Options pour membre de sortie (OUTMBR)

Nom de membre du fichier base de données auquel la sortie est envoyée.

Les valeurs possibles pour le membre recevant la sortie sont les suivantes :

*FIRST: Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et que le membre n'existe pas, un membre portant le nom du fichier indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE) est créé.
nom-membre: Indiquez le membre du fichier qui reçoit la sortie. Si OUTMBR(nom-membre) est indiqué et que le membre n'existe pas, ce dernier est créé par le système.

Les valeurs possibles pour l'opération à effectuer sur le membre sont les suivantes :

*REPLACE: Les données de sortie remplacent l'ensemble des enregistrements du membre indiqué.
*ADD: Les données de sortie sont ajoutées à la suite des enregistrements existants dans le membre indiqué.

Exemples

Exemple 1 : affichage d'une définition de système éloigné spécifique

DSPRMTDFN   SYSTEM(RCHAS1)

Cette commande permet d'afficher les attributs du système éloigné RCHAS1.

Exemple 2 : insertion d'une définition dans un fichier de sortie

DSPRMTDFN   SYSTEM(*ALL)  OUTPUT(*OUTFILE)  OUTFILE(RMTDFNOUT)

Cette commande permet d'écrire les attributs de tous les systèmes éloignés définis dans le fichier de sortie RMTDFNOUT.

Messages d'erreur

Messages *ESCAPE

CPF6A50: Une erreur a été détectée lors d'une opération sur un fichier écran ou un fichier d'imprimante. Error was found during display file or printer file operation.
CPF6DCA: Définition du paramètre SYSTEME incorrecte pour le système local.
CPF6DCC: Définition de système éloigné non trouvée pour &1 &2.
CPF9860: Erreur lors du traitement du fichier de sortie.
CPF9899: Erreur lors du traitement de la commande.