MRGFORMD

Fusionner description imprimé

En bref

La commande MRGFORMD (Fusionner une description d'imprimé) permet de fusionner un fichier spoule en sortie et un fichier base de données contenant une description d'imprimé, celle-ci étant conçue au moyen de la commande STRAPF (Démarrer APF).

Syntaxe minimale

MRGFORMD FORMD(…) FILE(…)

Paramètres

FORMD Description d'imprimé obligatoire
FILE Fichier obligatoire
SPLF Fichier spoule
JOB Nom du travail
SPLNBR Numéro de fichier spoule
COPIES Nombre d'exemplaires
DEV Unité
SPOOL Sortie en spoule
OUTQ File d'attente en sortie
FORMTYPE Type d'imprimé
OUTSPLF Fichier spoule en sortie
SCHEDULE Prévision de sortie
JOBD Description de travail

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

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande MRGFORMD (Fusionner une description d'imprimé) est disponible dans le logiciel Outils de développement d'applications (ADT), 5761-WDS. Pour plus de détails sur les Fonctions évoluées d'impression (APF), consultez le manuel Advanced Printer Function Guide, SC09-1361.

Remarque :Une entrée ne doit pas être précédée d'un astérisque, excepté dans le cas d'une "valeur spéciale" affichée (sur l'écran ou dans l'aide) avec un astérisque.

Messages d'erreur pour MRGFORMD

Messages *ESCAPE

APF5101: Ouverture du fichier imprimante &1 impossible.
APF5102: Une erreur s'est produite lors d'un accès au fichier spoule.
APF5104: Description d'imprimé non disponible.
APF5105: Description d'imprimé incorrecte.
APF5106: Vous n'êtes pas autorisé à utiliser la fonction demandée.
APF5107: Une erreur est survenue sur l'unité &3.
APF5121: Le fichier &1 de &2 est incorrect pour l'utilitaire APF.
APF9901: Erreur dans l'utilitaire APF.
APF9910: Impossible d'effectuer une opération d'entrée-sortie sur un fichier écran.
APF9911: Impossible d'effectuer une opération d'E/S sur un fichier base de données.
APF9912: Impossible d'ouvrir le fichier APF.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FORMD	Description d'imprimé	Nom	Obligatoire, positionnel 1
FILE	Fichier	Nom d'objet qualifié	Obligatoire, positionnel 2
	Qualificatif 1: Fichier	Nom
	Qualificatif 2: Bibliothèque	Nom, LIBL, CURLIB
SPLF	Fichier spoule	Nom, *NONE	Facultatif
JOB	Nom du travail	Valeurs uniques: * Autres valeurs: Nom de travail qualifié	Facultatif
	Qualificatif 1: Nom du travail	Nom
	Qualificatif 2: Utilisateur	Nom
	Qualificatif 3: Numéro	000000-999999
SPLNBR	Numéro de fichier spoule	1-999999, ONLY, LAST	Facultatif
COPIES	Nombre d'exemplaires	1-255, *FILE	Facultatif
DEV	Unité	Nom, FILE, JOB, *SYSVAL	Facultatif
SPOOL	Sortie en spoule	YES, NO, *FILE	Facultatif
OUTQ	File d'attente en sortie	Valeurs uniques: FILE, JOB, DEV Autres valeurs: Nom d'objet qualifié*	Facultatif
	Qualificatif 1: File d'attente en sortie	Nom
	Qualificatif 2: Bibliothèque	Nom, LIBL, CURLIB
FORMTYPE	Type d'imprimé	Valeur caractère, FILE, STD	Facultatif
OUTSPLF	Fichier spoule en sortie	Nom, *FRMD, ' '	Facultatif
SCHEDULE	Prévision de sortie	FILE, IMMED, JOBEND, FILEEND	Facultatif
JOBD	Description de travail	Valeurs uniques: NONE Autres valeurs: Nom d'objet qualifié*	Facultatif
	Qualificatif 1: Description de travail	Nom, QBATCH
	Qualificatif 2: Bibliothèque	Nom, LIBL, CURLIB

Description d'imprimé (FORMD)

Indique le nom de la description d'imprimé utilisée pour la fusion ou l'impression d'un imprimé.

Ce paramètre est obligatoire.

Fichier (FILE)

Indique le nom et la bibliothèque du fichier contenant la description d'imprimé.

Ce paramètre est obligatoire.

Pour la bibliothèque, les valeurs possibles sont :

*LIBL: Le fichier est recherché dans la liste des bibliothèques.
*CURLIB: Le fichier est recherché dans la bibliothèque en cours pour le travail. Si la bibliothèque en cours ne figure pas dans la liste, QGPL est prise par défaut.
nom-bibliothèque: Entrez le nom de la bibliothèque où sera placé le fichier.

Fichier spoule (SPLF)

Indique le nom du fichier spoule en sortie contenant les données qui seront fusionnées avec la description d'imprimé.

Les valeurs possibles sont les suivantes :

*NONE: Il n'est pas nécessaire d'indiquer un fichier spoule en sortie.
nom-fichier-spoule: Entrez le nom du fichier spoule en sortie.

Nom du travail (JOB)

Indique le nom du travail contenant le fichier spoule en sortie qui sera fusionné avec la description d'imprimé.

Les valeurs possibles sont les suivantes :

*

Indique que c'est le travail en cours qui contient le fichier spoule.

numéro-travail

Entrez le nom du travail qui a créé le fichier spoule que vous désirez fusionner. Si vous n'indiquez pas de nom de travail, le nom de travail simplifié est recherché dans la liste de tous les travaux du système.

utilisateur: Le nom utilisateur indique le profil utilisateur permettant de contrôler l'exécution du travail.
numéro: Numéro de travail attribué par le système.

Numéro de fichier spoule (SPLNBR)

Indique le numéro du fichier spoule en sortie que vous désirez fusionner avec la description d'imprimé.

Les valeurs possibles sont les suivantes :

*LAST: Indique que c'est le dernier fichier spoule portant le nom indiqué qui doit être fusionné avec la description d'imprimé indiquée.
*ONLY: Indique qu'un seul fichier spoule porte le nom indiqué en regard de l'invite Fichier spoule (paramètre SPLF).
numéro-fichier-spoule: Entrez le numéro du fichier spoule en sortie que vous désirez fusionner avec la description d'imprimé.

Nombre d'exemplaires (COPIES)

Indique le nombre d'exemplaires du fichier spoule en sortie fusionné que vous désirez imprimer.

Les valeurs possibles sont les suivantes :

*FILE: Le nombre d'exemplaires à imprimer est celui de la valeur COPIES, indiquée pour le fichier imprimante QPAPFPRT.
nombre-exemplaires: Entrez le nombre d'exemplaires du fichier spoule en sortie fusionné que vous désirez imprimer.

Unité (DEV)

Indique le nom de l'imprimante à utiliser pour l'impression de l'imprimé ou de la sortie fusionnée.

Les valeurs possibles sont les suivantes :

*FILE: L'imprimante à utiliser est celle indiquée pour le paramètre DEV du fichier imprimante QPAPFPRT.
*SYSVAL: L'imprimante à utiliser est indiquée par la valeur système QPRTDEV.
*JOB: L'imprimante à utiliser est indiquée par le fichier unité du travail.
nom-unité: Entrez le nom de l'imprimante à utiliser pour l'impression de l'imprimé ou de la sortie fusionnée.

Sortie en spoule (SPOOL)

Indique si les données doivent être imprimées en différé.

Les valeurs possibles sont les suivantes :

*FILE: L'attribut du fichier spoule sera celui utilisé dans le fichier imprimante QPAPFPRT.
*YES: Les données seront imprimées en différé.
*NO: Les données ne seront pas imprimées en différé.

File d'attente en sortie (OUTQ)

Indique dans quelle file d'attente en sortie sera placé le fichier spoule en sortie fusionné.

Les valeurs possibles sont les suivantes :

*FILE: La file d'attente en sortie est celle indiquée dans le fichier imprimante QPAPFPRT.
*DEV: La file d'attente, associée par défaut à l'imprimante indiquée à l'invite Unité (paramètre DEV), sera utilisée.
*JOB: La file d'attente en sortie, indiquée dans la description de travail associée au travail d'impression en différé sera utilisée.
nom-file-d'attente-sortie: Entrez le nom et la bibliothèque de la file d'attente en sortie dans laquelle sera placé le fichier spoule en sortie. Les valeurs possibles pour le nom de bibliothèque sont les suivantes :
*LIBL: La file d'attente en sortie est recherchée dans la liste des bibliothèques.
*CURLIB: La file d'attente en sortie est recherchée dans la bibliothèque en cours pour le travail. Si la bibliothèque en cours ne figure pas dans la liste, QGPL est prise par défaut.
nom-bibliothèque: Entrez le nom de la bibliothèque où se trouve la file d'attente en sortie.

Type d'imprimé (FORMTYPE)

Indique le type d'imprimé à utiliser pour le fichier spoule en sortie fusionné.

Les valeurs possibles sont les suivantes :

*FILE: Le type d'imprimé indiqué dans le fichier imprimante QPAPFPRT sera utilisé.
*STD: Le fichier spoule en sortie fusionné doit être imprimé sur le type d'imprimé standard utilisé sur votre site.
type-imprimé: Entrez le nom du type d'imprimé pour le fichier spoule en sortie.

Fichier spoule en sortie (OUTSPLF)

Indique le nom du fichier spoule en sortie fusionné dans la file d'attente en sortie.

Les valeurs possibles sont les suivantes :

*FRMD: C'est le nom de la description d'imprimé qui est utilisé.
nom-fichier-spoule-sortie: Entrez le nom (10 caractères au maximum) du fichier spoule en sortie fusionné dans la file d'attente en sortie.

Prévision de sortie (SCHEDULE)

Indique à quel moment le fichier spoule en sortie fusionné doit être disponible pour un éditeur de spoule.

Les valeurs possibles sont les suivantes :

*FILE: Le fichier spoule en sortie fusionné doit être disponible pour un éditeur de spoule dans les conditions indiquées en regard de l'invite Prévision de sortie (paramètre SCHEDULE). du fichier imprimante QPAPFPRT.
*IMMED: Le fichier spoule en sortie fusionné doit être immédiatement disponible.
*JOBEND: Le fichier spoule en sortie fusionné doit être disponible une fois le travail en cours terminé.
*FILEEND: Le fichier spoule en sortie fusionné doit être disponible une fois la fin du fichier en cours atteinte.

Description de travail (JOBD)

Indique le nom de la description de travail à utiliser lors de la soumission du travail.

Les valeurs possibles sont les suivantes :

*NONE: L'impression doit être effectuée conformément à la description de travail en cours.
nom-description-travail: Entrez le nom et la bibliothèque de la description de travail à utiliser lors de la soumission du travail. Les valeurs possibles pour le nom de bibliothèque sont les suivantes :
*LIBL: La description de travail est recherchée dans la liste des bibliothèques.
*CURLIB: La description de travail est recherchée dans la bibliothèque en cours pour ce travail. Si la bibliothèque en cours ne figure pas dans la liste, QGPL est prise par défaut.
nom-bibliothèque: Entrez le nom de la bibliothèque où se trouve la description de travail.

Exemples

None

Messages d'erreur

Messages *ESCAPE

APF5101: Ouverture du fichier imprimante &1 impossible.
APF5102: Une erreur s'est produite lors d'un accès au fichier spoule.
APF5104: Description d'imprimé non disponible.
APF5105: Description d'imprimé incorrecte.
APF5106: Vous n'êtes pas autorisé à utiliser la fonction demandée.
APF5107: Une erreur est survenue sur l'unité &3.
APF5121: Le fichier &1 de &2 est incorrect pour l'utilitaire APF.
APF9901: Erreur dans l'utilitaire APF.
APF9910: Impossible d'effectuer une opération d'entrée-sortie sur un fichier écran.
APF9911: Impossible d'effectuer une opération d'E/S sur un fichier base de données.
APF9912: Impossible d'ouvrir le fichier APF.