Voyons cela de plus près

est invoqué (toutefois, il
n’est pas nécessaire de posséder une
licence PSF/400 pour pouvoir utiliser
les fonctions PDF et e-mail).
En principe, on créera de multiples
unités de serveur PDF : leur
nombre dépend des besoins des applications
concernées. On peut
configurer un nombre quelconque
d’unités PDF. On configure un serveur
PDF en créant une unité imprimante
et un PSF Configuration
Object associé. Voici, par exemple,
les commandes pour une configuration
PDF qui transmet le(s) fichier(s)
PDF au e-mail :

CRTDEVPRT
    DEVD(PDF1)
    TYPE(*IPDS)
    MODEL(0)
    LANATTACH(*IP)
    AFP(*YES)
    PORT(5013)
    FONT(416 12)
    RMTLOCNAME('127.0.0.1')
    USRDFNOBJ(QGPL/PDF1
*PSFCFG)
    TEXT('PDF Server 1 for Email')

CRTPSFCFG
    PSFCFG(PDF1)
    PDFGEN(*MAIL)
    PDFMULT(*YES)
    PDFDTAQ(QGPL/PDFQ1)
    PDFMAPPGM(QGPL/EMAIL)
    TEXT('PSF Configuration Object 1')

Avec la description d’unité imprimante
virtuelle, le paramètre critique
est le RMTLOCNAME. C’est
une adresse de retour codée en dur,
requise par le processus de transformation
de PDF.

Le PSF Configuration Object définit
l’option de distribution (PDFGEN)
comme e-mail, IFS, ou file d’attente
de sortie. Il indique si des
fichiers PDF simples ou multiples seront
créés (PDFMULT). Il fournit une
file d’attente de données dans laquelle
les résultats de la fonction email
sont enregistrés (PDFDTAQ).
Et, si un programme de sortie de
personnalisation utilisateur est utilisé,
il fournit le lieu pour référencer
ce programme (PDFMAPPGM).
Dans cet exemple, l’option de
destination PDF est e-mail. Si vous
voulez l’IFS comme votre destination,
vous devez indiquer le nom du
répertoire IFS avec le paramètre
PDFDIR. Si vous réécrivez le fichier
PDF dans une file d’attente de sortie,
vous devez fournir ce nom de file
d’attente avec le paramètre PDFOUTQ.
L’autre élément clé dans l’architecture
PDF et e-mail est le fichier
d’imprimante iSeries. Chaque application
qui génère une sortie a un fichier
d’imprimante. Celui-ci peut
avoir deux composants : les paramètres
du job et les spécifications de
dessin de page (DDS).

Les paramètres du job sont gérés
à  l’aide des commandes Create,
Change, et Override Printer File. Le
serveur PDF recherche une valeur
dans le paramètre USRDFNDTA du
fichier d’imprimante (précisément,
MAILTAG) qui fournit soit l’ID e-mail
réel, soit une valeur que le programme
de sortie utilisateur peut associer
à  un ID e-mail réel. Dans certaines
applications, on ne peut pas
changer ou remplacer le fichier d’imprimante
de l’application avant que
le fichier spoule n’ait été créé. Dans
de tels cas, on peut utiliser CHGSPLFA
(Change Spool File Attributes)
une fois que la sortie se trouve dans
la file d’attente de sortie et ajouter la
référence e-mail au paramètre
USRDTA.

Si l’on veut segmenter la sortie
d’une application en plusieurs fichiers
PDF, une méthode consiste à 
utiliser les mots-clés Start Page
Group et End Page Group dans DDS
pour définir à  la fois les limites des
segments et l’ID du e-mail (ou une
valeur qui fera l’association avec un
ID e-mail) pour chaque segment.
Pour savoir comment insérer ces
triggers de segmentation dans un fichier
spoule iSeries, reportez-vous à 
iSeries Printing Redbook VI :
Delivering the Output of e-Business
(SG24-6250).

Si vous référencez un programme
de sortie, le processus du
serveur PDF échangera des données
avec ce programme. A l’intérieur du
programme de sortie utilisateur, on
dispose d’un handle vers les paramètres
de fichiers spoule, y compris
le tag mail. On peut fort bien imaginer
qu’une application utilise le tag
mail comme valeur de consultation
pour obtenir une adresse e-mail
réelle.

Bien entendu, dans un programme
de sortie, vous êtes aux
commandes. Vous pouvez décider
d’envoyer par e-mail chaque fichier
PDF ou d’en sauter certains. Vous
pouvez envoyer certains fichiers
à  de multiples destinations. Le
programme de sortie vous permet
aussi de personnaliser le texte du
e-mail.