|
Freeware
|
| |
|
Introduction |
|
5250 utility |
|
Windows utility |
| Other utilities |
|
Infoprint Server |
|
Service program |
|
Sample code |
|
Commands |
|
CGI support |
|
FAQ |
|
WEBMail |
|
Self maintenance |
| |
| Download |
| |
|
|
|
|
|  |
|
|
iSeries MIME & Mail
Other utilities
|
|
Command MMAIL/EMLMSG
allows to e-mail the text from a source file member as a plain message
to a maximum of 50 receivers.
Command MMAIL/EMLMSG
E-mail simple message (EMLMSG)
Type choices, press Enter.
'Subject' . . . . . . . . . . . ___________________________________________
____________________________________
______________________________
'Sender's name' . . . . . . . . ______________________________
'Sender's e-mail address' . . . ______________________________
Recipients . . . . . . . . . . . ____ *TO, *CC, *BCC
'name' . . . . . . . . . . . . _____________________________________
'e-mail address' . . . . . . . _____________________________________
+ for more values ____
Text source file . . . . . . . . *DFT____ Name, *DFT
Library . . . . . . . . . . . *LIBL____ Name, *LIBL, *CURLIB
Text source member . . . . . . . ________ Name
Importance . . . . . . . . . . . *MED *LOW, *MED, *HIG
Priority . . . . . . . . . . . . *NRM *NUR, *NRM, *URG
Sensitivity . . . . . . . . . . *NRM *NRM, *PRS, *PRV, *CNF
'Reply-to e-mail address' . . . *FROMADDR______________________________
Return receipt . . . . . . . . . *NO_ *NO, *YES
Save directory . . . . . . . . . /mmail/history__________________________
Preformatted message body . . . N N, Y
|
|
|
Subject: Subject of the message
Sender's name: Name of the person sending the message (see Note 3 below)
Sender's address: E-mail address of the person sending the message (see Note 3 below)
Recipients: up to 50 recipients can be specified; for each recipient the following
must be given:
- destination type: *TO, *CC, or *BCC
- recipient name, within quotes
- e-mail address, within quotes
Text source file: qualified name of the source file with
the member containing the text to be e-mailed. If '*DFT' specified, library name and
text source member name need not be specified: a QTEMP source file
is generated and a default member name is assigned.
*DFT is not supported in batch execution.
Text source member: name of the source member containing
the text to be sent with the message.
Importance:
*LOW=low, *MED=medium, *HIG=high
Priority:
*NUR=non-urgent, *NRM=normal, *URG=urgent
Sensitivity:
*NRM=normal, *PRS=personal, *PRV=private, *CNF=confidential
(use command mmail/setconfid
to set the confidentiality statement).
Reply-to e-mail address: E-mail address of the person to receive reply messages, if different from the sender
Return receipt: whether a receipt should be returned to the
sender when the recipient opens the message.
Save directory: IFS directory to contain a copy of the
e-mailed MIME file, or *NONE .
Preformatted message body: Whether the message body should be presented as preformatted text.
A preformatted text is a text where all characters (including spaces) have the same width.
Examples are texts including text tables (not html tables, of course).
Example:
MMAIL/EMLMSG SUBJECT('Announcement of a new software') FROMNAME('John Evans')
FROMADDR('jevans@mail.com') TO('dooley@superstar.com'/'Tom Dooley'/*TO)
TXTF(QGPL/MESSAGES) TXTMBR(MSG705) RECEIPT(*YES)
Note 1. This command can run both in the interactive and in the
batch environment.
Note 2. When running interactive, the source member is edited
prior to sending the message.
Note 3- Fetching sender's name and e-mail from the system
distribution directory
If the current user profile is enrolled in the system
distribution directory (you may use command WRKDIRE to check it out)
and
its directory entry specifies a full name and an e-mail address
(use F19 and check fields titled "SMTP user ID" and "SMTP domain"),
then the sender's name and e-mail address are automatically fetched
into command parameters FROMNAME and FROMEMAIL when the command
is prompted.
(Command WRKNAMSTP, alias table type = system, provides
another way to display / maintain e-mail addresses)
If the command is executed without prompting, to obtain the same
you must specify FROMNAME(*DIRENT) FROMEMAIL(*DIRENT).
In this case, if the required information cannot be retrieved
from the system distribution directory entry for the current
user profile, an escape message is issued.
Example:
MMAIL/EMLMSG SUBJECT('Announcement of a new software') FROMNAME(*DIRENT)
FROMADDR(*DIRENT) TO('dooley@superstar.com'/'Tom Dooley'/*TO)
TXTF(QGPL/MESSAGES) TXTMBR(MSG705) RECEIPT(*YES)
2. E-mail source members
Command MMAIL/EMLSRCM
allows to e-mail a message attaching up to 30 source members.
Optionally, a message body may be built from another text source
member.
The message can be e-mailed up to 50 receivers.
|
|
Command MMAIL/EMLSRCM
E-mail source members (EMLSRCM)
Type choices, press Enter.
'Subject' . . . . . . . . . . . ____________________________________________
____________________________________
______________________________
'Sender's name' . . . . . . . . ______________________________
'Sender's e-mail address' . . . ______________________________
Recipients . . . . . . . . . . . ____ *TO, *CC, *BCC
'name' . . . . . . . . . . . . _____________________________________
'e-mail address' . . . . . . . _____________________________________
+ for more values ____
Source member to be attached . . __________ Name
source file . . . . . . . . . __________ Name
library . . . . . . . . . . . *LIBL_____ Name, *LIBL, *CURLIB
+ for more values __________
Source mbr for message body . . *NONE_____ Name, *DFT, *NONE
source file . . . . . . . . . __________ Name
library . . . . . . . . . . . *LIBL_____ Name, *LIBL, *CURLIB
Edit message body src mbr . . . *NO_ *NO, *YES
Importance . . . . . . . . . . . *MED *LOW, *MED, *HIG
Priority . . . . . . . . . . . . *NRM *NUR, *NRM, *URG
Sensitivity . . . . . . . . . . *NRM *NRM, *PRS, *PRV, *CNF
'Reply-to e-mail address' . . . *FROMADDR______________________________
Return receipt . . . . . . . . . *NO_ *NO, *YES
Save directory . . . . . . . . . /mmail/history__________________________
Preformatted message body . . . N N, Y
|
|
|
Subject: Subject of the message
Sender's name: Name of the person sending the message
Sender's address: E-mail address of the person sending the message
Recipients: up to 50 recipients can be specified; for each recipient the following
must be given:
- destination type: *TO, *CC, or *BCC
- recipient name, within quotes
- e-mail address, within quotes
Source member to be attached: up to 30 attachments can be specified; for each attachment the following
must be given:
- source member name
- source file name
- source library name
Source mbr for message body: member, file, and library name for
the text to become the body of the message.
If *NONE specified, the message will have no body,
just the attachment will be there.
If '*DFT' specified, library name and
text source member name need not be specified: a QTEMP source file
is generated and a default member name is assigned.
*DFT is not supported in batch execution.
Edit message body src mbr: whether the source member for the message body should be edited
(interactive job only). Editing is performed via STRSEU (if available), otherwise via EDTF.
Importance:
*LOW=low, *MED=medium, *HIG=high
Priority:
*NUR=non-urgent, *NRM=normal, *URG=urgent
Sensitivity:
*NRM=normal, *PRS=personal, *PRV=private, *CNF=confidential
(use command mmail/setconfid
to set the confidentiality statement).
Reply-to e-mail address: E-mail address of the person to receive reply messages, if different from the sender
Return receipt: whether a receipt should be returned to the
sender when the recipient opens the message.
Save directory: IFS directory to contain a copy of the
e-mailed MIME file, or *NONE .
Preformatted message body: Whether the message body should be presented as preformatted text.
A preformatted text is a text where all characters (including spaces) have the same width.
Examples are texts including text tables (not html tables, of course).
Note 1. This command can run both in the interactive and in the
batch environment.
Note 2- Fetching sender's name and e-mail from the system
distribution directory
See Note 3 for command EMLMSG.
Example:
MMAIL/EMLSRCM SUBJECT('Source of command MMAIL/EMLSRCM')
FROMNAME('John Evans') FROMADDR('jevans@mail.com')
TO('dooley@superstar.com'/'Tom Dooley'/*TO)
SRCM(MMAIL/QCMDSRC/EMLSRM)
3. E-mail spool files
Two similar commands are available.
They differ in the way the PDF conversion utility is selected.
- MMAIL/EMLSPL
This command selects the PDF conversion utility defined by command MMAIL/CVTTOPDF
- MMAIL/EMLSPLX
This command, though defaulting to the PDF conversion utility selected by command MMAIL/CVTTOPDF,
leaves you the freedom to select a different conversion utility.
Besides, when the PDF conversion utility CVTSPLSTMF is selected, it provides all the needed PDF formatting parameters.
 
A-Command MMAIL/EMLSPL
allows to e-mail a message attaching up to 30 spool files.
A conversion to PDF option is available at single spool file level.
Optionally, a message body may be built from a text source
member.
The message can be e-mailed up to 50 receivers.
|
|
Command MMAIL/EMLSPL
E-mail spool files (EMLSPL)
Type choices, press Enter.
'Subject' . . . . . . . . . . . ____________________________________________
____________________________________
______________________________
'Sender's name' . . . . . . . . ______________________________
'Sender's e-mail address' . . . ______________________________
Recipients . . . . . . . . . . . ____ *TO, *CC, *BCC
'name' . . . . . . . . . . . . _____________________________________
'e-mail address' . . . . . . . _____________________________________
+ for more values ____
Spooled file . . . . . . . . . . __________ Name
Job name . . . . . . . . . . . *CURRENT__ Name, *CURRENT
job user . . . . . . . . . . __________ Name
job number . . . . . . . . . ______ 000000-999999
Spooled file number . . . . . *LAST 1-9999, *ONLY, *LAST
Convert spool file to PDF . . *NO_ *NO, *YES
+ for more values __________
Source mbr for message body . . *NONE_____ Name, *DFT, *NONE
source file . . . . . . . . . __________ Name
library . . . . . . . . . . . *LIBL_____ Name, *LIBL, *CURLIB
Edit message body src mbr . . . *NO_ *NO, *YES
Importance . . . . . . . . . . . *MED *LOW, *MED, *HIG
Priority . . . . . . . . . . . . *NRM *NUR, *NRM, *URG
Sensitivity . . . . . . . . . . *NRM *NRM, *PRS, *PRV, *CNF
'Reply-to e-mail address' . . . *FROMADDR______________________________
Return receipt . . . . . . . . . *NO_ *NO, *YES
Save directory . . . . . . . . . '/mmail/history'________________________
PDF save directory . . . . . . . '/mmail/temp'___________________________
PDF name . . . . . . . . . . . . 'sample.pdf'____________________________
Preformatted message body . . . N N, Y
|
|
|
Subject: Subject of the message
Sender's name: Name of the person sending the message
Sender's address: E-mail address of the person sending the message
Recipients: up to 50 recipients can be specified; for each recipient the following
must be given:
- destination type: *TO, *CC, or *BCC
- recipient name, within quotes
- e-mail address, within quotes
Spooled file: up to 30 attachments can be specified; for each attachment the following
must be given:
- spool file name
- qualified job name
- spool file number
- whether the spool file should be converted to PDF before being attached to the message.
Information about conversion of spool files to PDF's is provided later in this page.
The spool_file_to_PDF conversion program used in this process
is the utility selected through command MMAIL/CVTTOPDF.
Note 1- For additional parameters of command CVTSPLSTMF when spool file conversion to PDF is requested,
see Note on CVTSPLSTMF spool file conversion to PDF.
Note 2- If the selected utility is CVTSPLSTMF (which handles only SCS spool files) and the spool file
type is AFP, then utility CVTSPLFPDF (which handles both SCS and AFP spool files) is used instead.
Source mbr for message body: member, file, and library name for
the text to become the body of the message.
If *NONE specified, the message will have no body,
just the attachment will be there.
If '*DFT' specified, library name and
text source member name need not be specified: a QTEMP source file
is generated and a default member name is assigned.
*DFT is not supported in batch execution.
Edit message body src mbr: whether the source member for the message body should be edited
(interactive job only). Editing is performed via STRSEU (if available), otherwise via EDTF.
Importance:
*LOW=low, *MED=medium, *HIG=high
Priority:
*NUR=non-urgent, *NRM=normal, *URG=urgent
Sensitivity:
*NRM=normal, *PRS=personal, *PRV=private, *CNF=confidential
(use command mmail/setconfid
to set the confidentiality statement).
Reply-to e-mail address: E-mail address of the person to receive reply messages, if different from the sender
Return receipt: whether a receipt should be returned to the
sender when the recipient opens the message.
Save directory: IFS directory to contain a copy of the
e-mailed MIME file, or *NONE .
PDF save directory: The PDF is deleted after been attached to the MIME file.
However, you may specify an IFS directory where it should be saved before been deleted.
PDF name:
- if you leave the default value *AUTO, the PDF is assigned a computed name
- you may specify a pdf name of your choice ending with the extension .pdf .
Preformatted message body: Whether the message body should be presented as preformatted text.
A preformatted text is a text where all characters (including spaces) have the same width.
Examples are texts including text tables (not html tables, of course).
Note 1. This command can run both in the interactive and in the
batch environment.
Note 2- Fetching sender's name and e-mail from the system
distribution directory
See Note 3 for command EMLMSG.
Example:
MMAIL/EMLSPL SUBJECT('Daily sales report')
FROMNAME('John Evans') FROMADDR('jevans@mail.com')
TO('dooley@superstar.com'/'Tom Dooley'/*TO)
SPLF(*YES/*LAST/*N/*N/*CURRENT/QSYSPRT)
 
B-Command MMAIL/EMLSPLX
allows to e-mail a message attaching up to 50 spool files
and can be e-mailed up to 50 receivers.
Optionally, a message body may be built from a text source
member.
It includes the same parameters as command EMLSPL. However:
-An overall conversion to PDF option is available.
-A parameter (PDFUTILITY) is available for selecting among the available conversion utilities.
-If conversion utility CVTSPLSTMF is selected,
parameters for assessing the PDF layout are also prompted.
Example:
MMAIL/EMLSPLX SUBJECT('Daily sales report')
FROMNAME('John Evans') FROMADDR('jevans@mail.com')
TO('dooley@superstar.com'/'Tom Dooley'/*TO)
SPLF(*LAST/*N/*N/*CURRENT/QSYSPRT)
CVTPDF(*YES) MSGM(*DFT)
PDFUTILITY(*CVTSPLSTMF)
PAGESIZE(*CUSTOM) CUSTOMPAGE(200 300) FONT(*COURIER 8)
4. E-mail save files
Command MMAIL/EMLSAVF
allows to e-mail a message attaching up to 30 save files.
Optionally, a message body may be built from a text source
member.
The message can be e-mailed up to 50 receivers.
|
|
Command MMAIL/EMLSAVF
E-mail save files (EMLSAVF)
Type choices, press Enter.
'Subject' . . . . . . . . . . . ____________________________________________
____________________________________
______________________________
'Sender's name' . . . . . . . . ______________________________
'Sender's e-mail address' . . . ______________________________
Recipients . . . . . . . . . . . ____ *TO, *CC, *BCC
'name' . . . . . . . . . . . . _____________________________________
'e-mail address' . . . . . . . _____________________________________
+ for more values ____
Save file . . . . . . . . . . . __________ Name
Library . . . . . . . . . . . *LIBL_____ Name, *LIBL, *CURLIB
+ for more values __________
Source mbr for message body . . *NONE_____ Name, *DFT, *NONE
source file . . . . . . . . . __________ Name
library . . . . . . . . . . . *LIBL_____ Name, *LIBL, *CURLIB
Edit message body src mbr . . . *NO_ *NO, *YES
Importance . . . . . . . . . . . *MED *LOW, *MED, *HIG
Priority . . . . . . . . . . . . *NRM *NUR, *NRM, *URG
Sensitivity . . . . . . . . . . *NRM *NRM, *PRS, *PRV, *CNF
'Reply-to e-mail address' . . . *FROMADDR______________________________
Return receipt . . . . . . . . . *NO_ *NO, *YES
Save directory . . . . . . . . . /mmail/history__________________________
Preformatted message body . . . N N, Y
|
|
|
Subject: Subject of the message
Sender's name: Name of the person sending the message
Sender's address: E-mail address of the person sending the message
Recipients: up to 50 recipients can be specified; for each recipient the following
must be given:
- destination type: *TO, *CC, or *BCC
- recipient name, within quotes
- e-mail address, within quotes
Save file: up to 30 attachments can be specified; for each attachment the following
must be given:
- save file name
- library name
Source mbr for message body: member, file, and library name for
the text to become the body of the message.
If *NONE specified, the message will have no body,
just the attachment will be there.
If '*DFT' specified, library name and
text source member name need not be specified: a QTEMP source file
is generated and a default member name is assigned.
*DFT is not supported in batch execution.
Edit message body src mbr: whether the source member for the message body should be edited
(interactive job only). Editing is performed via STRSEU (if available), otherwise via EDTF.
Importance:
*LOW=low, *MED=medium, *HIG=high
Priority:
*NUR=non-urgent, *NRM=normal, *URG=urgent
Sensitivity:
*NRM=normal, *PRS=personal, *PRV=private, *CNF=confidential
(use command mmail/setconfid
to set the confidentiality statement).
Reply-to e-mail address: E-mail address of the person to receive reply messages, if different from the sender
Return receipt: whether a receipt should be returned to the
sender when the recipient opens the message.
Save directory: IFS directory to contain a copy of the
e-mailed MIME file, or *NONE .
Preformatted message body: Whether the message body should be presented as preformatted text.
A preformatted text is a text where all characters (including spaces) have the same width.
Examples are texts including text tables (not html tables, of course).
Note 1. This command can run both in the interactive and in the
batch environment.
Note 2- Fetching sender's name and e-mail from the system
distribution directory
See Note 3 for command EMLMSG.
Example:
MMAIL/EMLSAVF SUBJECT('Save file QGPL/MYLIB')
FROMNAME('John Evans') FROMADDR('jevans@mail.com')
TO('dooley@superstar.com'/'Tom Dooley'/*TO)
FILE(QGPL/MMAIL)
5a. E-mail stream files
|
|
Command MMAIL/EMLSTMF
allows to e-mail a message attaching up to 30 stream files.
Optionally, a message body may be built from a text source
member.
The message can be e-mailed up to 50 receivers.
Command MMAIL/EMLSTMF
E-mail stream files (EMLSTMF)
Type choices, press Enter.
'Subject' . . . . . . . . . . . ____________________________________________
____________________________________
______________________________
'Sender's name' . . . . . . . . ______________________________
'Sender's e-mail address' . . . ______________________________
Recipients . . . . . . . . . . . ____ *TO, *CC, *BCC
'name' . . . . . . . . . . . . _____________________________________
'e-mail address' . . . . . . . _____________________________________
+ for more values ____
'Stream file' . . . . . . . . . ________________________________________
+ for more values ________________________________________
Source mbr for message body . . *NONE_____ Name, *DFT, *NONE
source file . . . . . . . . . __________ Name
library . . . . . . . . . . . *LIBL_____ Name, *LIBL, *CURLIB
Edit message body src mbr . . . *NO_ *NO, *YES
Importance . . . . . . . . . . . *MED *LOW, *MED, *HIG
Priority . . . . . . . . . . . . *NRM *NUR, *NRM, *URG
Sensitivity . . . . . . . . . . *NRM *NRM, *PRS, *PRV, *CNF
'Reply-to e-mail address' . . . *FROMADDR______________________________
Return receipt . . . . . . . . . *NO_ *NO, *YES
Save directory . . . . . . . . . /mmail/history__________________________
|
|
|
Subject: Subject of the message
Sender's name: Name of the person sending the message
Sender's address: E-mail address of the person sending the message
Recipients: up to 50 recipients can be specified; for each recipient the following
must be given:
- destination type: *TO, *CC, or *BCC
- recipient name, within quotes
- e-mail address, within quotes
Stream file: up to 30 stream files can be attached to the message
Source mbr for message body: member, file, and library name for
the text to become the body of the message.
If *NONE specified, the message will have no body,
just the attachment will be there.
If '*DFT' specified, library name and
text source member name need not be specified: a QTEMP source file
is generated and a default member name is assigned.
*DFT is not supported in batch execution.
Edit message body src mbr: whether the source member for the message body should be edited
(interactive job only). Editing is performed via STRSEU (if available), otherwise via EDTF.
Importance:
*LOW=low, *MED=medium, *HIG=high
Priority:
*NUR=non-urgent, *NRM=normal, *URG=urgent
Sensitivity:
*NRM=normal, *PRS=personal, *PRV=private, *CNF=confidential
(use command mmail/setconfid
to set the confidentiality statement).
Reply-to e-mail address: E-mail address of the person to receive reply messages, if different from the sender
Return receipt: whether a receipt should be returned to the
sender when the recipient opens the message.
Save directory: IFS directory to contain a copy of the
e-mailed MIME file, or *NONE .
Note 1. This command can run both in the interactive and in the
batch environment.
Note 2. When running interactive, if *NONE not specified, the text source member for the body is edited
prior to sending the message.
Note 3- Fetching sender's name and e-mail from the system
distribution directory
See Note 3 for command EMLMSG.
Example:
MMAIL/EMLSTMF SUBJECT('My IFS file')
FROMNAME('John Evans') FROMADDR('jevans@mail.com')
TO('dooley@superstar.com'/'Tom Dooley'/*TO)
STMF('/mydir/myphoto.gif')
5b. E-mail a HTML stream file
|
|
Command MMAIL/EMLHTML
allows to e-mail a HTML stream file (a HTML page).
The HTML page is embedded in the body of the MIME message, thus resulting in a high quality message.
The message can be e-mailed up to 50 receivers.
Command MMAIL/EMLHTML
E-mail HTML stream file (EMLHTML)
Type choices, press Enter.
'Subject' . . . . . . . . . . . ____________________________________________
____________________________________
______________________________
'Sender's name' . . . . . . . . ______________________________
'Sender's e-mail address' . . . ______________________________
Recipients . . . . . . . . . . . ____ *TO, *CC, *BCC
'name' . . . . . . . . . . . . _____________________________________
'e-mail address' . . . . . . . _____________________________________
+ for more values ____
'HTML stream file' . . . . . . . ____________________________________________
Importance . . . . . . . . . . . *MED *LOW, *MED, *HIG
Priority . . . . . . . . . . . . *NRM *NUR, *NRM, *URG
Sensitivity . . . . . . . . . . *NRM *NRM, *PRS, *PRV, *CNF
'Reply-to e-mail address' . . . *FROMADDR______________________________
Return receipt . . . . . . . . . *NO_ *NO, *YES
Save directory . . . . . . . . . /mmail/history__________________________
|
|
|
Subject: Subject of the message
Sender's name: Name of the person sending the message
Sender's address: E-mail address of the person sending the message
Recipients: up to 50 recipients can be specified; for each recipient the following
must be given:
- destination type: *TO, *CC, or *BCC
- recipient name, within quotes
- e-mail address, within quotes
HTML stream file: HTML stream file to be embedded in the body of the message
Importance:
*LOW=low, *MED=medium, *HIG=high
Priority:
*NUR=non-urgent, *NRM=normal, *URG=urgent
Sensitivity:
*NRM=normal, *PRS=personal, *PRV=private, *CNF=confidential
(use command mmail/setconfid
to set the confidentiality statement).
Reply-to e-mail address: E-mail address of the person to receive reply messages, if different from the sender
Return receipt: whether a receipt should be returned to the
sender when the recipient opens the message.
Save directory: IFS directory to contain a copy of the
e-mailed MIME file, or *NONE .
Note 1. This command can run both in the interactive and in the
batch environment.
Note 2- Fetching sender's name and e-mail from the system
distribution directory
See Note 3 for command EMLMSG.
Example:
MMAIL/EMLHTML SUBJECT('My HTML page')
FROMNAME('John Evans') FROMADDR('jevans@mail.com')
TO('dooley@superstar.com'/'Tom Dooley'/*TO)
STMF('/mydir/mypage.html')
6. Send a MIME file
Command SENDMIME allows to mail -through a single MIME message- a combination of different types of objects:
- IFS stream files
- Database files
- Source file members
- Spool files
- Spool files converted to PDF
Up to 100 different pieces (objects) can be sent for each type of object.
Command MMAIL/SENDMIME
Send a MIME file (SENDMIME)
Type choices, press Enter.
Subject . . . . . . . . . . . . _______________________________________
From:
Sender Name . . . . . . . . . _______________________________________
Sender Address . . . . . . . . _______________________________________
To:
Send TO, CC or BCC . . . . . . ____ *TO, *CC, *BCC
Receiver Name . . . . . . . . _______________________________________
Receiver Address . . . . . . . _______________________________________
+ for more values _
IFS file to attach:
Send as Text or Binary . . . . *TEXT *BIN, *TEXT
Content Type . . . . . . . . . *ATTACHED_ *ATTACHED, *BODY
Mime type . . . . . . . . . . _______________________________________
IFS File Name . . . . . . . . _______________________________________
Character Set . . . . . . . . *SAME__________________________________
New Extension . . . . . . . . ___ Character value
Content ID . . . . . . . . . . _____ 0-999
+ for more values _
Database file to attach:
Content Type . . . . . . . . . *ATTACHED_ *ATTACHED, *BODY
File Name . . . . . . . . . . __________ Character value
File Library . . . . . . . . . __________ Character value
File Member . . . . . . . . . __________ Character value
Content ID . . . . . . . . . . ____ 0-999
+ for more values _
Source file to attach:
Content Type . . . . . . . . . *ATTACHED_ *ATTACHED, *BODY
Source File Name . . . . . . . __________ Character value
Source Library . . . . . . . . __________ Character value
Source Member . . . . . . . . __________ Character value
Character Set . . . . . . . . *SAME__________________________________
Content ID . . . . . . . . . . _____ 0-999
+ for more values _
Spool file to attach:
Content Type . . . . . . . . . *ATTACHED_ *ATTACHED, *BODY
Spool File Name . . . . . . . __________ Character value
Spool Number . . . . . . . . . ______ Character value
Spool Job Name . . . . . . . . __________ Character value
Spool Job User . . . . . . . . __________ Character value
Spool Job Number . . . . . . . ______ Character value
Content ID . . . . . . . . . . _____ 0-999
+ for more values _
Convert spool to PDF:
Spool File Name . . . . . . . __________ Character value
Spool Number . . . . . . . . . ______ Character value
Spool Job Name . . . . . . . . __________ Character value
Spool Job User . . . . . . . . __________ Character value
Spool Job Number . . . . . . . ______ Character value
Content ID . . . . . . . . . . _____ 0-999
PDF Name . . . . . . . . . . . _______________________________________
Save Directory . . . . . . . . _______________________________________
+ for more values _
Importance . . . . . . . . . . . MEDIUM____ LOW, MEDIUM, HIGH
Priority . . . . . . . . . . . . NORMAL____ NONURGENT, NORMAL, URGENT
Disposition notify to:
Notify Name . . . . . . . . . *NONE__________________________________
Notify Address . . . . . . . . *NONE__________________________________
Reply to:
Reply to Email . . . . . . . . *NOREPLY_______________________________
Invalid Emails . . . . . . . . . SEND__ SEND, REMOVE
Work Directory . . . . . . . . . _______________________________________
Save Directory . . . . . . . . . *NOSAVE________________________________
|
|
|
7. Automated e-mailing of spool files
Suppose that your iSeries produces regularly some reports
that you need to distribute to some people in your organization.
Why not to have an utility that automatically sends such reports
to them by e-mail, as soon as they become available?
MMAIL has an utility for that.
This is how you use it.
- Use command MMAIL/WRKADDR
to define the e-mail addresses of your users
- Use command MMAIL/WRKGRP
to define Groups of addresses (distribution lists)
- The pivot of spool files distribution is a data queue.
You may create a data queue and associate it to one
or more output queues. Every time a spool file is made
ready in one of these output queues, an entry is generated
in the output queue. Our utility receives the data queue
entries and (selectively) e-mail the spool files
to their destinations.
- To create an data queue,
crtdtaq libxxx/dtaqyyy maxlen(500) aut(*change)
- To associate a data queue to an output queue,
chgoutq libaaa/outqbbb dtaq(libxxx/dtaqyyy)
- Command MMAIL/STREMLSPLF DTAQ(libxxx/dtaqyyy)
(see later) starts e-mailing spool files
- Command MMAIL/ENDEMLSPLF DTAQ(libxxx/dtaqyyy)
ends e-mailing spool files
| |
Command MMAIL/STREMLSPLF
Start E-Mailing Spool Files (STREMLSPLF)
Type choices, press Enter.
'Sender's name' . . . . . . . . ______________________________
'Sender's e-mail address' . . . ______________________________
Data queue . . . . . . . . . . . Name
Library . . . . . . . . . . . *LIBL Name, *LIBL, *CURLIB
Convert all spool files to PDF . *NO *NO, *YES
Remove e-mailed spool files . . *YES *YES, *NO
MIME message disposition . . . . *IMBED *IMBED, *ATTACH
Importance . . . . . . . . . . . *MED *LOW, *MED, *HIG
Priority . . . . . . . . . . . . *NRM *NUR, *NRM, *URG
Sensitivity . . . . . . . . . . *NRM *NRM, *PRS, *PRV, *CNF
Spool files and groups:
Name, generic*
+ for more values
Select from User Data . . . . . > *NO *NO, *YES
Subject type . . . . . . . . . > A A, B
|
|
|
Sender's name: Name of the person sending these messages
Sender's address: E-mail address of the person sending these messages
Data queue: name and library of the data queue associated
to one or more output queues
Convert all spool files to PDF:
type *YES if you want all the spool files be converted to PDFs prior to be e-mailed.
Remove e-mailed spool files: enter *YES to delete a spool
file once it has been e-mailed, enter *NO to retain it
MIME message disposition: enter *IMBED to embed the spool file
in the mail message body, or enter *ATTACH to attach the spool file to the
mail message
Importance:
*LOW=low, *MED=medium, *HIG=high
Priority:
*NUR=non-urgent, *NRM=normal, *URG=urgent
Sensitivity:
*NRM=normal, *PRS=personal, *PRV=private, *CNF=confidential
(use command mmail/setconfid
to set the confidentiality statement).
Spool files and groups: this is a list of up to 50 entries.
Each entry is made of two elements, spool file name and group name:
- spool file name:
a string for selecting spool file names eligible for being e-mailed.
It may contain a full file name (e.g. QSYSPRT),
a generic name (e.g. QSYS*, or
*ALL (all spool files will be e-mailed).
- group name:
name of the address group to which the selected spool files
should be e-mailed
Select from User Data.
In some cases, the user of this command would rather select the spool file to be e-mailed from the contents of
the spool file user data rather than from the spool file name. This can be done by specifying *YES in this last parameter.
In such a case, spool file user data (instead of spool file names) are checked vs the selection strings of the previous parameter.
Subject type.
Subject type (SBJTYPE) - This parameter establishes the way the subject of the e-mail is captured from the spool file.
- If type A (default value) specified, the subject is taken from the
first line of the first page of the spool file. If this line is
empty, then type B subject is used.
- If type B, the subject is made up from date and time, the system
name, the qualified output queue name and the spool file name.
Note 1.
Command MMAIL/STREMLSPLF submits a batch job.
Note 2.
Only one MMAIL/STREMLSPLF command can be issued
for a given data queue. If the job submitted for a given data queue
is still active, no more MMAIL/STREMLSPLF commands
for the same data queue are accepted.
Use command MMAIL/ENDEMLSPLF DTAQ(...) to end the submitted
job.
Note 3.The following log files are maintained in library MMAILDATA:
- EMLSPLFLOG - A record for each spool file processed. Record layout:
- timestamp
- qualified name of the data queue
- qualified name of the batch job processing spool files
- qualified name of the job that produced the spool file
- spool file name
- spool file number
- action performed by the program in charge for processing spool files
This file contains records for the last 7 days.
Old records are removed when command STREMLSTMF is entered.
- SPLLOG - A record for each mail destination of messages sent. Record layout:
- date
- time
- data queue library name
- data queue name
- output queue library name
- output queue name
- spool file name
- sent flag: Y=successful, N=failed
- address group (distribution list)
- addressee name
- addressee e-mail address
This file should be cleared now and then.
8. Text header and footer for EML... commands
You may define a text header and / or text footer to be automatically added to the
TEXT/PLAIN body of messages sent from the following commands:
- EMLMSG
- EMLSAVF
- EMLSPL
- STREMLSPLF (in this case, only when DISP(*ATTACH))
The text of the header and the text of the footer must be in IFS stream files.
- Command MMAIL/EMLHEADER allows to define the path and the name of the
header stream file, to create, update, and display it.
- Command MMAIL/EMLFOOTER allows to define the path and the name of the
footer stream file, to create, update, and display it.
9. Resend failed MIME messages
If for any reason a MIME file fails to be sent, it remains
in directory /mmail/temp and
cannot be re-sent unless you are able to call the QTMMSENDMAIL
API passing all the requested parameters.
Command MMAIL/RESEND provides a way to
invoke the QTMMSENDMAIL API for resending failed messages.
Of course, in the problem is with the Mail Server Framework (MSF)
or with the Simple Mail Transfer Protocol (SMTP),
the resend of messages may very well fail also.
|
|
Command MMAIL/RESEND
Re-send failed messages (RESEND)
Type choices, press Enter.
Stream file . . . . . . . . . . *ALL
|
|
Enter path and name of a MIME stream file
to be resent. If you specify *ALL, all MIME stream files in
directory "/mmail/temp" are resent.
10. Converting spool files
Five ways are available for converting spool files
to a number of stream file types:
- Command mmail/cvtsplstmf allows to convert an SCS spool file
to a stream file, type text, html, or pdf.
This is a piece of freeware.
- Command mmail/cvtsplfpdf allows to convert both an SCS and an AFP
spool file to a stream file, type pdf.
This command is available only from OS/400 release V5R1 on.
This freeware is made of two libraries: TIFFLIB and HPT which are delivered with MMAIL and installed during
MMAIL installation process. These libraries can also be downloaded from
UZAEMON's Homepage.
- Command afptool/afptool allows to convert both an SCS and an AFP
spool file to a PDF stream file.
This is a charge product you can order from
BVSTools.
- IBM INFOPRINT SERVER for iSERIES (5722-IP1) is a professional product
for printing on iSeries. Among several other features, it includes the ability
to convert spool files to PDF under user specified controls.
Minimum requirement is V5R1.
Though it is a charge product, it is by far the one we recommend for
high quality results.
For information about Infoprint Server, see this page.
- Command mmail/SPLFTOPDF converts a spool file to PDF using your favorite
conversion tool, one of the four above, selected with command
mmail/cvttopdf.
Note 1
In the service program mmail/sendmail, subprocedure
MimeSplPdf selects one of these
ways to convert a spool file to PDF. You must use command
mmail/cvttopdf to let this procedure know
which of the four PDF conversion utilities should be used.
Note 2
Instead of the above conversion tools, you may decide to
use your favorite "spool to pdf converter".
To do so, you must
- update program mmail/cvttopdf
- rework subprocedure MimeSplPdf
in mmail/qrpglesrc member
xxxmime
- recreate the service program and all programs through command
mmail/compile
|
- mmail/cvtsplstmf
This command allows to convert an SCS spool file to a stream file.
The stream file type can be
MMAIL/CVTSPLSTMF
Copy Spool File to Stream File (CVTSPLSTMF)
Type choices, press Enter.
From spooled file name . . . . . __________ Name
To stream file name . . . . . . _____________________________________________
To directory . . . . . . . . . . _____________________________________________
Job name . . . . . . . . . . . . *_________ Name, *
User . . . . . . . . . . . . . __________ Name
Number . . . . . . . . . . . . ______ 000000-999999
Spooled file number . . . . . . ______ 1-9999, *ONLY, *LAST
Stream file format . . . . . . . *TEXT_ *TEXT, *HTML, *PDF
Stream file option . . . . . . . *NONE___ *NONE, *ADD, *REPLACE
|
|
Additional parameters for stream file format *TEXT:
Stream file code page . . . . . *PCASCII_ 1-32767, *PCASCII, *STMF |
|
Additional parameters for stream file format *HTML:
Title for HTML or PDF . . . . . *NONE_______________________________________
Stream file code page . . . . . *PCASCII_ 1-32767, *PCASCII, *STMF |
|
Additional parameters for stream file format *PDF:
Title for HTML or PDF . . . . . *NONE_______________________________________
Page size:
Paper size . . . . . . . . . . *SPLF__ *SPLF, *CUSTOM, *A4, *A5...
Orientation . . . . . . . . . __________ *LANDSCAPE, *PORTRAIT
Font:
Face . . . . . . . . . . . . . *CONVERT_ *CONVERT, *COURIER...
Size . . . . . . . . . . . . . _____ 4-36, *CALC
Type of PDF bookmarks . . . . . *PAGNBR_ *PAGNBR, *POS, *KEY, *NONE
Stream file code page . . . . . *PCASCII_ 1-32767, *PCASCII, *STMF |
|
Note on CVTSPLSTMF spool file conversion to PDF
| |
Command CvtSplStmf is implicitly executed when one of the following commands asks for spool file conversion to PDF:
- EMLSPL
- STREMLSPL
- SENDMIME
- SPLFTOPDF
or when one of the following subprocedures is executed
and option 1 (CvtSplStmf) was specified in command CvtToPdf.
The above commands, however, do not allow to specify any of the PDF conversion parameters available in command CVTSPLSTMF.
The way to overcome this, is to issue command MMAIL/SETSPLSTMF before using one of the above commands.
Command MMAIL/SETSPLSTMF allows to specify the CVTSPLSTMF PDF conversion parameters. These parameters are made available to all
the subsequent CVTSPLSTMF commands issued in that same job.
|
- mmail/cvtsplfpdf
This command allows to convert a spool file to a PDF stream file.
The spool file can be SCS or AFP.
Spool files must not be greater than 16 Mb.
MMAIL/CVTSPLFPDF
Convert spool file to pdf (CVTSPLFPDF)
Type choices, press Enter.
Spooled file name . . . . . . . Name
PDF path and name . . . . . . .
Job name . . . . . . . . . . . . * Name, *
User . . . . . . . . . . . . . Name
Number . . . . . . . . . . . . 000000-999999
Spooled file number . . . . . . 1-9999, *ONLY, *LAST
Replace PDF stream file . . . . *YES *YES, *NO
|
|
Other parameters are available to specify paper size, orientation, and margin.
Note 1
This command is based on a free software
(libraries HPT and TIFFLIB) originated from
Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
Anyone using this software must know that it is available at no charge.
To know more about copyrights, please read members
COPYING and LICENSE in HPT/LICENSE.
Note 2
The conversion process is performed in two steps:
- conversion of the spool file to a .tif stream file (command
hpt/spl2stmf
- conversion of the .tif stream file to a .pdf stream file (command
tifflib/tiff2pdf
Note on CVTSPLFPDF spool file conversion to PDF
| |
Command CvtSplfPdf is implicitly executed when one of the following commands asks for spool file conversion to PDF:
- EMLSPL
- STREMLSPL
- SENDMIME
- SPLFTOPDF
or when one of the following subprocedures is executed
and option 2 (CvtSplfPdf) was specified in command CvtToPdf.
The above commands, however, do not allow to specify any of the PDF conversion parameters available in command CVTSPLFSTMF.
The way to overcome this, is to issue command MMAIL/SETSPLSTMF before using one of the above commands.
Command MMAIL/SETSPLFPDF allows to specify the CVTSPLFPDF PDF conversion parameters. These parameters are made available to all
the subsequent CVTSPLFPDF commands issued in that same job.
|
- afptool/afptool
This command allows to convert a spool file to a PDF stream file.
The spool file can be SCS or AFP.
AFPTOOL/AFPTOOL
Convert AFP to PDF (AFPTOOL)
Type choices, press Enter.
Spooled file name . . . . . . . Name
Job name . . . . . . . . . . . . * Name, *
User . . . . . . . . . . . . . Name
Number . . . . . . . . . . . . 000000-999999
Spooled file number . . . . . . 1-9999, *ONLY, *LAST
Output stream file . . . . . . .
Additional Parameters
Replace object . . . . . . . . . *NO *YES, *NO
Manufacturer type and model . . *WSCST
WSCST Name . . . . . . . . . . . QWPTIFFG4 Character value, *NONE
WSCST Library . . . . . . . . . QSYS Character value, *LIBL
Temp path . . . . . . . . . . . '/tmp'
Page rotation . . . . . . . . . 0 0, 90, 180, 270
Margin offset . . . . . . . . . 20 Number
Left margin offset . . . . . . . 0 Number
Top margin offset . . . . . . . 0 Number |
|
Note 1
This command requires library QFNTCPL
(AFP Compatibility Fonts, product 5722SS1, option 8, feature 5050).
Note 2
Both libraries AFPTOOL and QFNTPCL must be added to the job library
list.
- IBM Infoprint Server for iSeries (5722-IP1)
This product needs no commands. It would convert to PDF any spool file
created or moved to a given output queue.
To use this product within MMAIL:
- set up the environment needed by Infoprint Server by using command
MMAIL/INFOPRINT
- use command MMAIL/CVTTOPDF to select it as the preferred conversion tool
- any time you ask the MMAIL/SENDMAIL service program to e-mail a spool file
after converting it to PDF, the spool file will be moved to the
INFOPRINT output queue, get converted to PDF, attached to your MIME message
and e-mailed.
For information about Infoprint Server, see this page.
11. Manage spool files
Some MMAIL users have raised the requirement to have a command similar to WRKSPLF,
but also able to:
- e-mail a selected spool file
- convert a spool file to a stream file, either as a TEXT file (.TXT),
or an HTML file (.HTML) or a PDF file (.PDF).
That has been implemented in January 2006 through command mmail/mngsplf (Manage spool files).
This command (when prompted) allows more granular selection of spool files than the OS/400 WRKSPLF command,
and fulfills the requested conversion types.
This command takes advantage of these other following commands:
- mmail/emlspl,
to e-mail a spool file (after optionally converting it to a PDF)
- mmail/cvtsplstmf,
to convert a spool file to a text or to an html stream file
- mmail/spltopdf,
to convert a spool file to a pdf stream file,
using the preferred conversion tool selected through command
cvttopdf.
 |
| Figure 1 - Command MNGSPLF |
12. WEB utilities
In February 2006, some interesting utilities have been made available for the WEB user.
They allow to control spool files and spool writers from a remote browser via HTTP.
Functions like spool file e-mailing, conversion to stream file or to PDF are also supported.
In order to work, these utilities require some directives be added to the HTTP configuration (see later).
Two utilities are currently available:
- WRKSPLF (Work with spool files)
- WRKWTR (Work with printer writers)
10a. WRKSPLF
This utility is invoked through the URL
http://.../mmailp/wrksplf.pgm
It is very similar to the 5250 MNGSPLF utility, though more flexible.
An initial screen (see Figure 2) allows to specify selection criteria for the spool files:
 |
| Figure 2 - Starting WRKSPLF |
Multiple selection criteria are handled in an "AND" condition.
Please note the ability to specify even the number of lines per page.
When *ALL output queues selected, the WEB page looks like that in Figure 3:
 |
| Figure 3 - Working with all spool files |
On the other side, when in Figure 2 a given output queue is specified, the WEB page also carries controls for that output queue:
 |
| Figure 4 - Working with an output queue |
About the spool file controls (buttons).
- The Hold, Release, and Delete buttons can process multiple spool files (for instance, you may delete five spool files in a single shot).
- The other buttons (Change (change spool file attributes), Display (display a spool file),
Attributes (display spool file attributes), E-mail (e-mail a spool file), Cvt to Stmf (convert a spool file to a stream file),
and Cvt to Pdf (convert a spool file to a PDF stream file)) process a single spool file at a time and provide separate prompts in a new window for each function.
About spool writers.
Button Work with all printers switches to the WRKWTR WEB utility (see next).
10b. WRKWTR
This utility is invoked through the URL
http://.../mmailp/wrkwtr.pgm
or it may get control from the WRKSPLF utility.
This utility is the WEB version of the WRKWTR 5250 command.
It provides the status of all writers in a single page (see Figure 6).
 |
| Figure 6 - Working with writers |
About the writers controls (buttons).
- The Hold, End, and Release buttons may operate on multiple writers (for instance, you may end several writers in one shot).
- Other buttons (Start (start a writer), Change (change the properties of a writer),
and Messages (work with unanswered writer messages)), process a writer at a time by providing control pages in separate windows.
See the example of the Messages button in Figure 6.
 |
| Figure 6 - Working with writer unanswered messages |
Switching to spool files control.
There are two ways you may switch from the page in Figure 5 to the WRKSPLF utility.
- By selecting a writer and pushing the button wrkoutq, you will go to a page like that in Figure 4.
- By clicking button work with all spool files, you will go to the page in Figure 2.
10c. HTTP directives
When you install MMAIL, the installation procedure would suggest the installation of some HTTP directives for MMAIL.
Such directives allow to display the WEB manual (THIS manual) and to run the WEB utilities.
However, ih this is not your first MMAIL installation, and you already installed the MMAIL HTTP directives, you may not want to do that again.
In such a case, you may want to check your MMAIL existing HTTP directives in your system, and the ones documented here, and add the missing ones.
By doing do, you will enable the MMAIL WEB utilities for appropriate execution.
The are two cases.
- If you are running an OS/400 release before V5R2, you must run the Original HTTP server (V5R1 Apache HTTP server is not recommended).
In this case, please check the "MMAIL Original HTTP Directives".
That may also be true if you are running OS/400 V5R2 still with the Original HTTP server.
- If you are running the Apache HTTP server (optional on V5R2, mandatory from V5R3 on), please check the "MMAIL Apache HTTP Directives".
| 1 - MMAIL Original HTTP Directives |
#==== MMAIL, MIME & MAIL ==============================
Protection MMAILPR {
ACLOverride Off
PostMask All
GetMask All
AuthType Basic
ServerID "MIME & MAIL"
PasswdFile %%SYSTEM%%
UserID %%CLIENT%%
}
Protect /mmailp/* MMAILPR
Map /mmail/start /mmail/html/intro.htm
Map /mmailh/* /mmail/html/*
Map /mmailp/*.cgi /mmailp/*.pgm
Pass /mmail/*
Exec /mmailp/* /QSYS.LIB/MMAIL.LIB/* %%EBCDIC%% |
|
|
|
To change / add directives
- enter command WRKHTTPCFG CFG(xxx), where xxx is the name of the appropriate HTTP instance
(usually "CONFIG" for HTTP instance DEFAULT)
- restart that HTTP instance
|
|
| 2 - MMAIL Apache HTTP Directives |
#---- MMAIL directives
AliasMatch /mmailh/(.*) /mmail/html/$1
AliasMatch ^/mmail/start$ /mmail/html/intro.htm
Alias /mmail/ /mmail/
ScriptAliasMatch /mmailp/(.*).pgm /qsys.lib/mmail.lib/$1.pgm
ScriptAliasMatch /mmailp/(.*).cgi /qsys.lib/mmail.lib/$1.pgm
<Directory /mmail>
AllowOverride None
Options None
order allow,deny
allow from all
</Directory>
<Directory /QSYS.LIB/MMAIL.LIB>
Options +ExecCGI
CgiConvMode %%EBCDIC/EBCDIC%%
AllowOverride None
Options None
order allow,deny
allow from all
</Directory>
<LocationMatch /mmailp/(.*)>
AuthType Basic
AuthName "MIME & MAIL"
PasswdFile %%SYSTEM%%
UserID %%CLIENT%%
Require valid-user
</LocationMatch> |
|
|
|
To change / add directives
- enter command STRPDM option 3 over file QUSRSYS/QATMHINSTC
- display the member with the same name as the HTTP instance you want to update
- there is a single record there; make up the name of the IFS stream file containing the
configuration directives
- use command EDTF on that stream file to perform HTTP directives maintenance
- restart that HTTP instance
|
|
|
|