PRTAFPDTA

Imprimer des données AFP

En bref

La commande PRTAFPDTA (Imprimer des données AFP) imprime la sortie envoyée par un ordinateur hôte IBM 370.

PRTAFPDTA se lit PRT (Imprimer) + AFPDTA. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

PRTAFPDTA FILE(…)

Paramètres

FILE Fichier obligatoire
MBR Membre
DEV Unité imprimante
FORMDF Définition d'imprimé
COPIES Nombre d'exemplaires
STRPAGE Page de début
ENDPAGE Page de fin
FIDELITY Fidélité d'impression

Astuce : dans une session 5250, tapez PRTAFPDTA 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 PRTAFPDTA (Imprimer des données AFP) imprime la sortie envoyée par un ordinateur hôte IBM 370. Elle permet à l'utilisateur d'indiquer le fichier à imprimer, ainsi que les paramètres de contrôle d'impression.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FILE	Fichier	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Fichier	Nom
	Qualificatif 2: Bibliothèque	Nom, LIBL, CURLIB
MBR	Membre	Nom, *FIRST	Facultatif
DEV	Unité imprimante	Nom, JOB, SYSVAL	Facultatif
FORMDF	Définition d'imprimé	Valeurs uniques: DEVD, INLINE Autres valeurs: Nom d'objet qualifié	Facultatif
	Qualificatif 1: Définition d'imprimé	Nom
	Qualificatif 2: Bibliothèque	Nom, LIBL, CURLIB
COPIES	Nombre d'exemplaires	1-255, 1	Facultatif
STRPAGE	Page de début	Entier, 1	Facultatif
ENDPAGE	Page de fin	Entier, *END	Facultatif
FIDELITY	Fidélité d'impression	ABSOLUTE, CONTENT	Facultatif

Fichier (FILE)

Indique le fichier contenant le flot de données AFP (AFPDS) à imprimer. Cette commande ne prend en charge que des fichiers physiques. Si vous utilisez la commande OVRPRTF (Substituer fichier imprimante) avec PRTAFPDTA, ne remplacez pas le type d'unité (paramètre DEVTYPE).

Ce paramètre est obligatoire.

Qualificateur 1 : Fichier

nom: Indiquez le nom du fichier AFPDS à imprimer.

Qualificateur 2 : Bibliothèque

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques du travail 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 en cours n'est définie pour le travail, la bibliothèque QGPL est prise par défaut.
nom: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Membre (MBR)

Indique le membre contenant les données à imprimer.

*FIRST: Le premier membre du fichier base de données est utilisé.
nom: Indiquez le nom du membre de fichier contenant les données à imprimer.

Unité imprimante (DEV)

Indique le nom de l'imprimante à utiliser pour le fichier.

*JOB: L'imprimante utilisée est celle indiquée dans la description de travail.
*SYSVAL: La valeur système QPRTDEV est utilisée.
nom: Indiquez le nom de l'imprimante.

Définition d'imprimé (FORMDF)

Indique la définition d'imprimé à utiliser lors de l'impression du fichier. Une définition d'imprimé est un objet ressource qui définit les caractéristiques de l'imprimé, telles que les fonds de page, la position des données de page sur l'imprimé, le nombre d'exemplaires et les modifications apportées aux pages. La définition d'imprimé se trouve en entrée du fichier en cours d'impression, ou dans une bibliothèque.

Valeurs uniques

*DEVD: La définition d'imprimé en cours d'utilisation est contenue dans la description d'unité. Si aucune valeur n'est spécifiée, *DEVD est prise par défaut.
*INLINE: La définition d'imprimé à utiliser est associée au fichier imprimante.

Qualificateur 1 : Définition d'imprimé

nom: Indiquez le nom de la définition d'imprimé qui doit exister dans la bibliothèque spécifiée. Vous pouvez utiliser 8 caractères au maximum.

Qualificateur 2 : Bibliothèque

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques du travail jusqu'à ce que la première occurrence soit trouvée.
*CURLIB: La recherche porte sur la bibliothèque en cours du travail. Si aucune bibliothèque en cours n'est définie pour le travail, la bibliothèque QGPL est prise par défaut.
nom: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Nombre d'exemplaires (COPIES)

Indique le nombre d'exemplaires de fichiers spoule en cours d'impression.

1: Un exemplaire de la sortie est imprimé.
1-255: Indiquez le nombre d'exemplaires à imprimer.

Page de début (STRPAGE)

Indique la page à laquelle doit débuter l'impression. Ce paramètre est utilisé pour l'impression partielle d'un fichier.

1: L'impression débute en page 1. Si la page de début n'est pas indiquée, la valeur 1 est prise par défaut.
entier: Indiquez le numéro de page auquel doit débuter l'impression.

Page de fin (ENDPAGE)

Indique la page à laquelle doit s'arrêter l'impression. Ce paramètre est utilisé pour l'impression partielle d'un fichier se terminant à un numéro de page indiqué. Si vous avez également indiqué un numéro de page de début, le numéro précisé dans ce paramètre doit lui être égal ou supérieur. Si une page de fin dépassant la fin du fichier est indiquée, aucune condition d'erreur n'est créée.

*END: L'impression s'arrête à la fin du fichier.
entier: Indiquez le numéro de page auquel doit s'arrêter l'impression.

Fidélité d'impression (FIDELITY)

Indique le degré de précision requis lors de l'impression du fichier.

*ABSOLUTE: Le travail n'est imprimé que si l'impression peut se dérouler conformément aux spécifications du flot de données et des contrôles externes.
*CONTENT: Imprime le fichier à l'aide de tous les traitements d'exceptions disponibles.

Exemples

Exemple 1 : impression de pages spécifiques

PRTAFPDTA   FILE(MYLIB/MYFILE)  STRPAGE(2)  ENDPAGE(6)

Cette commande permet d'imprimer le premier membre du fichier MYFILE présent dans la bibliothèque MYLIB (depuis la page 2 à la page 6).

Exemple 2 : impression à l'aide de tous les traitements d'exception disponibles

PRTAFPDTA   FILE(MYLIB/MYFILE)  FORMDF(F10101)  FIDELITY(*CONTENT)

Cette commande permet d'imprimer le premier membre du fichier MYFILE présent dans la bibliothèque MYLIB, ceci à l'aide d'une définition d'imprimé de F10101 et de tous les traitements d'exception disponibles.

Messages d'erreur

Messages *ESCAPE

CPF511B: Flot de données incorrect pour l'enregistrement &2 du fichier &1.
PQT4001: Flot de données incorrect dans zone structurée &2 du fichier &1.
PQT4003: Définition d'imprimé &2 non trouvée dans la bibliothèque.
PQT4004: Numéro de la page de début (&1) supérieur à celui de la page de fin (&2).
PQT4006: Traitement du fichier &1 impossible car zones de longueur variable.
PQT4007: Flot de données incorrect dans fichier &1.