Introduzione
i4Mail
Spool Mailer for IBM(R) iSeries(R)-AS/400(R)
Guida Utente
(c) 2004 Sysap
---------------------------------------------------------------------
i4Mail e' un Client di posta elettronica per IBM iSeries-AS/400
che utilizza funzioni Smtp native per inviare e-mail direttamente
dall'AS/400.
i4Mail automatizza l'invio degli spool come allegato di un messaggio
di posta elettronica in formato Htm,Pdf,Doc,Txt.
i4Mail puo' anche prelevare gli spool esistenti dalle code di stampa
per inviarli successivamente alla loro creazione.
Tramite il sw FaxMaker, inoltre, i4Mail diventa un Fax-Client
per inviare gli spool via fax direttamente dai programmi AS/400.
Prerequisiti
AS/400 - funzioni base
- Qualsiasi modello Cisc o Risc con Os400 release 3.2 o successivo
- Instradamento ad Interner per l'invio della posta.
AS/400 - funzioni opzionali
- Per la conversione nativa PDF, occorre che sia installata la
libreria QFNTCPL compresa nel sistema operativo base,
(SS1 Opzione 8 - OS/400 - AFP Compatibility Fonts)
- Per l'invio di fax, e' necessario disporre di sw FaxMaker o
altri prodotti per l'invio di fax
nota: i4Mail e' predisposto per l'invio automatizzato di fax
tramite FaxMaker® (www.gfi.com), un prodotto di terze parti
non compreso nella fornitura di i4Mail.
La compatibilita' con altri prodotti o routines puo' essere
implementata su richiesta.
Limitazioni
- La conversione nativa PDF non puo' elaborare spool di dimensioni
maggiori di 16 MB.
Installazione
Per installare i4Mail sul sistema seguire le istruzioni sulla
pagina di download del sito.
Dopo aver eseguito la procedura di SETUP, consultare i capitoli
/Configurazione e /Avviamento della Guida Utente.
Nota sulla libreria
Se si e' scelto di installare il programma in una libreria diversa
da "I4MAIL", sostituire "I4MAIL" con il nome della libreria scelta.
Nota sulla denominazione dei programmi
I nomi dei programmi i4Mail contenuti nella libreria I4MAIL
iniziano per "JEM", "JOG", "JAZ"; verificare che non esistano
programmi utente con nome simile nelle librerie applicative
utilizzate, tramite il comando wrkobj
Nota sulla versione
La versione di i4Mail viene denominata nella forma JMxxyy
dove xx rappresenta l'anno e yy rappresenta il mese di rilascio
della versione (Es. JM0406 = versione rilasciata a Giugno/2004);
eventuali correzioni alla versione sono identificate aggiungendo
una o piu' lettere al nome della versione (Es. JM0406A =
correzione "A" della versione rilasciata a Giugno/2004)
Installazione aggiornamenti
Per installare una nuova versione o una correzione di i4Mail
su una versione precedente gia' installata, eseguire il programma
SETUP contenuto nella nuova libreria e seguire le istruzioni a
video, scegliendo l'opzione >Aggiornamento< alla richiesta del tipo
di installazione desiderata.
Ripristino dati iniziali
E' possibile ripristinare il contenuto degli archivi i4Mail al
valore iniziale inviato con il prodotto, rieseguendo la procedura di
SETUP e scegliendo l'opzione >Nuova installazione< alla richiesta
del tipo di installazione desiderata.
Versione dimostrativa
La versione dimostrativa di i4Mail consente l'utilizzo,
senza limiti di tempo, di tutte le funzioni del prodotto,
ma un messaggio informativo viene apposto nel corpo dei messaggi
e gli spool vengono troncati a 30 righe.
Tramite la versione dimostrativa e' possibile, quindi, definire
interamente e preventivamente il proprio ambiente applicativo, e
valutare le funzionalita' del prodotto in rapporto alle proprie
specifiche necessita'.
In qualsiasi momento sara' possibile, richiedendo il codice di
attivazione personale, abilitare l'utilizzo effettivo del prodotto,
conservando tutte le definizioni e gli oggetti creati.
Disinstallazione
Per disinstallare i4Mail e rimuovere tutti gli oggetti creati,
- scollegare gli utenti eventualmente attivi in i4Mail
- rimuovere la libreria I4MAIL dalla lista librerie di sistema
- cancellare la libreria JMxxyy e la libreria I4MAIL
- cancellare la cartella I4MAIL
Configurazione
Configurazione Automatica
Utilizzare il comando JEMCONFIG per immettere il codice di attivazione e impostare
i parametri base di i4Mail.
Se abilitata, utilizzare la configurazione automatica AS/400,
altrimenti proseguire con la configurazione manuale.
Configurazione Manuale
Per ridurre le fasi di digitazione, si consiglia di riportare i
comandi di configurazione tramite le funzioni copia-incolla e
modificare solo i parametri necessari.
Configurazione Tcp
i4Mail invia i messaggi di posta elettronica tramite l'applicazione
Smtp (Simple Mail Transfer Protocol) che fa parte del protocollo TCP
presente nel sistema operativo OS/400.
Tcp ed Smtp devono essere configurati e attivati per poter inviare
e-mail dall'AS/400.
La maggior parte delle opzioni Tcp possono essere impostate tramite
il menu' CFGTCP.
Per informazioni dettagliate sulla procedura di configurazione
Tcp AS/400 fare riferimento ai relativi manuali di sistema.
Per quanto riguarda il protocollo Tcp, e' necessario che siano
impostati almeno:
- un interfaccia Tcp
ADDTCPIFC INTNETADR('ip-address-AS/400')
LIND(ETHLINE)
SUBNETMASK('255.255.255.0')
AUTOSTART(*YES)
- un iter Tcp per l'instradamento al router o al server Smtp
ADDTCPRTE RTEDEST(*DFTROUTE)
SUBNETMASK(*NONE)
NEXTHOP('ip-address-gateway')
- le informazioni di dominio Tcp e del server Dns
ADDTCPHTE INTNETADR('ip-address-AS/400')
HOSTNAME((host))
ADDTCPHTE INTNETADR('ip-address-AS/400')
HOSTNAME((host.dominio))
CHGTCPDMN HOSTNAME('host')
DMNNAME('dominio')
INTNETADR('ip-address-server-DNS')
E' inoltre opportuno verificare che il Tcp venga avviato
automaticamente in fase di Ipl, aggiungendo eventualmente il
comando STRTCP nel QSTRUP.
Configurazione Smtp
- Verificare che esista nell'indirizzario di sistema la voce relativa
all'instradamento Smtp "INTERNET SMTPRTE" tramite il comando WRKDIRE,
ed eventualmente aggiungerla tramite il comando:
ADDDIRE USRID(INTERNET SMTPRTE) <se release 4 o superiore>
USRD('UserID to send to Internet')
USER(*NONE)
SYSNAME(INTERNET)
PREFADR(NETUSRID *IBM ATCONTXT)
ADDDIRE USRID(INTERNET GATEWAY) <se release 3.2 o 3.7>
USRD('Context switching entry')
SYSNAME(INTERNET)
MSFSRVLVL(*USRIDX)
PREFADR(NETUSRID *IBM ATCONTXT)
- Modificare gli attributi di distribuzione tramite il comando:
CHGDSTA SMTPRTE(INTERNET SMTPRTE) <se release 4 o superiore>
WRKREGINF QIBM_QZMFMSF_LST_EXP <se release 3.2 o 3.7>
e seguire le istruzioni
- Modificare la dimensione massima dei messaggi:
CHGPOPA MSGSPLIT(*NOMAX) <se release 4 o superiore>
CHGPOPA MSGSPLIT(2048) <se release 3.2 o 3.7>
- impostare l'opzione di avvio automatico e il nome del server Smtp
per la posta in uscita, tramite il comando CHGSMTPA.
CHGSMTPA AUTOSTART(*YES) MAILROUTER(nome_del_server_smtp)
Tramite l'opzione AUTOSTART(*YES), l'applicazione Smtp viene
avviata automaticamente con il Tcp.
Come server Smtp puo' essere impostato lo stesso server della
posta in uscita utilizzato nei programmi di posta elettronica Pc
(Outlook, Eudora, ...).
E' importante che il sistema riesca a "raggiungere" tale server
tramite le impostazioni di instradamento Tcp citate precedentemente.
E consigliabile verificare preventivamente l'instradamento al
server Smtp.
- Riavviare il Mail Server Framework tramite i comandi
ENDMSF
STRMSF
- Verificare che il lavoro QMSF sia attivo nel sottosistema QSYSWRK,
tramite il comando WRKACTJOB SBS(QSYSWRK)
- Verificare che l' applicazione Smtp sia attiva nel sottosistema
QSYSWRK, tramite il comando WRKACTJOB SBS(QSYSWRK), (lavori
QTSMTPBRCL QTSMTPBRSR QTSMTPCLTD QTSMTPSRVD) ed eventualmente
avviarla tramite il comando STRTCPSVR *SMTP
Configurazione Utenti
Per ogni utente abilitato ad inviare posta, effettuare le seguenti
operazioni:
- iscrivere l'utente nell'indirizzario di sistema tramite il comando
WRJDIRE
Immettere 1=Aggiunta e compilare la videata "Aggiunta Voce
Indirizzario" impostando i valori per utente e sistema con il
nome utente e il nome del sistema:
esempio: per inserire l'utente FMIC sul sistema S44A1234 immettere:
ID utente/Indirizzo . . FMIC S44A1234
Descrizione . . . . . . utente fmic
Nome sistema/Gruppo . . S44A1234
Profilo utente . . . . FMIC
ID utente rete . . . .
premere F19 e compilare la videata "Aggiunta nome Smtp" impostando
l'indirizzo e-mail da utilizzare come mittente per l'utente in
oggetto, avendo cura di inserire nel campo "user ID" la parte
prima della @ e nel campo "domain" la parte dopo la @ (chiocciola)
esempio: per inserire fmic@sysap.com immettere:
SMTP user ID . . . . . . fmic
SMTP domain . . . . . . . sysap.com
Premere INVIO per confermare le scelte.
Configurazione cartella I4MAIL
i4Mail crea automaticamente la cartella I4MAIL con una sottocartella
per ogni utente, in cui vengono memorizzati gli spool convertiti.
Verificare che gli utenti i4mail dispongano di autorizzazione al
comando CRTFLR, e, in caso contrario, effettuare manualmente la
creazione della cartella I4MAIL e delle sottocartelle utenti con
i comandi:
CRTFLR FLR(I4MAIL)
CRTFLR FLR(nome_utente) INFLR(I4MAIL)
Configurazione PDF (NATIVA)
Non e' necessaria alcuna impostazione:
Controllare che sia installata sul sistema
l'opzione 8 del sistema operativo:
5722SS1 8 OS/400 - AFP Compatibility Fonts
Configurazione PDF (versione PDFing)
Per utilizzare la conversione degli spool in formato Pdf tramite PDFing:
- Installare e configurare PDFing su un PcWin
(fare riferimento alla documentazione del sito www.pdfing.com)
- creare la coda di emissione PDF con il comando
CRTOUTQ OUTQ(PDF) RMTSYS(*INTNETADR) RMTPRTQ('Pdf') AUTOSTRWTR(1)
CNNTYPE(*IP) DESTTYPE(*OS400) TRANSFORM(*NO)
DESTOPT(*USRDFNTXT) INTNETADR('nnn.nnn.nnn.nnn')
impostando nnn.nnn.nnn.nnn con l'indirizzo ip del PcWin sul quale
e' stato installato PDFing.
Per eseguire la conversione di spool *AFPDS e' necessario impostare
i valori:
TRANSFORM(*YES) MFRTYPMDL(*HP4)
Impostazioni PDFing consigliate per utilizzo con i4Mail
Destination
- Send To Destination: immettere un indirizzo e-mail di default
Convert
- Convert to PDF: YES
- Title, Subject,Author,...: eventuali riferimenti personalizzati
Paper
- eventuali impostazioni personalizzate
Message
- Subject: Documento &N +eventuali diciture personalizzate
- Message: In allegato: &N +eventuali diciture personalizzate
&X
(nel campo &N verra' riportato il nome del file Pdf)
(nel campo &X verra' riportato il messaggio immesso a video)
System
- Server: immettere il server Smtp per la posta in uscita
- Auto-Start: YES
- Return Address: immettere un indirizzo e-mail di default
- *SCS Code-Page: 280
Advanced
- Auto-Start: YES
Log
- Eventuali impostazioni per il monitoraggio delle attivita'
Configurazione Spool-Mode
Per inviare gli spool esistenti tramite i comandi WRKSPLF o WRKOUTQ
e' necessario modificare il messaggio CPX3438 del message-file
QCPFMSG tramite il seguente comando:
CHGMSGD MSGID(CPX3438)
MSGF(QSYS/QCPFMSG)
MSG('call JEMSC parm(''&1'' ''&4'' ''&3'' ''&2'' ''&5'')')
NB: Per abilitare l'opzione 1=Invio sul pannello WRKSPLF impostare
il Livello di assistenza Intermedio tramite il tasto F21 dal
pannello WRKSPLF
Per ripristinare il valore di sistema, immettere:
CHGMSGD MSGID(CPX3438)
MSGF(QSYS/QCPFMSG)
MSG('?SNDNETSPLF ??TOUSRID() ?*FILE(&1) ?*JOB(&4/&3/&2)
?*SPLNBR(&5) ??DTAFMT() &6')
Pagina Test
Per verificare la configurazione e inviare una pagina di prova
e' possibile utilizzare il programma di test, immettendo:
ADDLIBLE I4MAIL
JEMTEST
Avviamento
Introduzione
Per l'utilizzo ottimale di i4Mail si raccomanda di aggiugere la
libreria I4MAIL nella lista librerie di sistema utilizzando
il comando WRKSYSVAL QSYSLIBL
In questo modo le funzioni i4Mail saranno sempre disponibili per
tutti gli utenti.
Call-Mode
La Call-Mode permette di attivare i4Mail su un programma di stampa
senza effettuare alcuna modifica al programma utente.
E' ideale per programmi utente senza parametri iniziali che
producono un unico output di stampa (prospetti, tabulati,...)
E' sufficiente richiamare il comando "JEMCALL" (o il pgm JEMCC)
impostando i 2 parametri:
- Parm1 = FILE char(10) = nome del file di stampa
- Parm2 = PGM char(10) = nome del programma di stampa
con la seguente sintassi:
JEMCALL FILE('nome_file_di_stampa') PGM('nome_programma')
oppure
CALL JEMCC PARM('nome_file_di_stampa' 'nome_programma')
iMail richiede le opzioni per l'invio del messaggio, esegue il
programma utente con le eventuali richieste a video, quindi invia lo
spool.
La Call-Mode puo' essere attivata anche in due fasi, permettendo il
richiamo indipendente del programma di stampa tramite un menu' o un
altra procedura; in questo caso utilizzare i comandi JEMCALL1 e
JEMCALL2 (o i pgm JEMCC1 e JEMCC2):
JEMCALL1 FILE('nome_file_di_stampa')
Esecuzione programma utente
JEMCALL2
Exit-Mode
Il Exit-Mode consente l'utilizzo avanzato delle funzioni i4Mail
tramite l'inserimento di alcune routines nei programmi utente.
Con il Exit-Mode si ottiene la massima integrazione di i4Mail con
gli applicativi, in quanto e' possibile personalizzarne l'attivazione
inserendola nella logica dei programmi utente.
E' possibile, per esempio, abilitare i4Mail in un programma
di Estratto Conto, condizionandone l'attivazione tramite un
tasto di funzione: si potra' quindi, agevolmente, inviare un
E-Mail ai Clienti con i dati contabili desiderati.
Le routines i4Mail da inserire nei programmi utente si trovano nel
membro JEM del file JEMSRC della libreria I4MAIL
Seguire le istruzioni ivi contenute.
Ricordarsi di aggiungere in lista la libreria i4Mail prima di
eseguire i programmi che richiamano i4Mail.
Batch-Mode
Il Batch-Mode estende l'utilizzo di i4Mail alle procedure batch
permettendo la totale automazione delle fasi di invio, senza
richiesta di parametri a video.
Le routines i4Mail da inserire nei programmi utente si trovano nel
membro JEM del file JEMSRC della libreria I4MAIL
Per attivare il Batch-Mode impostare ad "1" il campo JEMBCH e
pre-impostare tutti i campi necessari prima del richiamo della
Exit Jem1; i4Mail controllera' i dati inseriti e, se non ci sono
anomalie, completa l'invio dell messaggio senza richieste a video.
Spool-Mode
Tramite lo Spool-Mode e' possibile inviare uno spool esistente
prelevandolo dalla coda di stampa:
- individuare lo spool tramite i comandi WRKSPLF o WRKOUTQ
- immettere l'opzione "1" nel campo opzione
- premere INVIO sulla mappa "Richiamo programma",
senza modificare i parametri
- compilare la videata i4Mail
NB: Per abilitare l'opzione 1=Invio sul pannello WRKSPLF impostare
il Livello di assistenza Intermedio tramite il tasto F21 dal
pannello WRKSPLF
Consultare il capitolo "Configurazione Spool-Mode" per abilitare
il richiamo del programma JEMSC.
Credits
Copyright (c) 2003 Sysap
Sysap e i4Desk sono marchi registrati di Sysap in Italia
IBM, iSeries, AS/400 e Client Access sono marchi o marchi registrati
della IBM Corporation negli Stati Uniti e/o in altri Paesi
Microsoft e Windows sono marchi o marchi registrati
della Microsoft Corporation negli Stati Uniti e/o in altri Paesi
I marchi, i nomi commerciali, i nomi di prodotti e i logo di terze
parti sono marchi o marchi registrati dei rispettivi proprietari.