"MIME & Mail" provides a pretty large
number of commands. The following is a quick summary.
Important note on commands
In order to be properly executed, all the following commands need
the MMAIL library (or its clone library) be in the job library list.
Most of "setup" commands are used during the installation phase of MIME & Mail.
However, you may use them also after installation to change some
of the settings.
- ALWMDTBC
This command, with command WRKMDTBC
allows to automatically send blank copies of any message to some
"blind" recipients. This allows to maintain a full log out outgoing messages.
See this page.
- CCSID
Some functions of MIME & Mail cannot be properly executed
if the job CCSID is 65535. During these functions, MIME & Mail
needs to temporarily change the job CCSID to a value
different from 65535.
If the system value of the system is 65535, this command allows
to specify what is the value to be assigned for this temporary
CCSID.
- CHARSET
Use this command to select from a list the default character set to be used by MMAIL.
- COMPILE
Recompiles and recreates the two service programs and all
the other programs.
- CRTCMDS
Re-creates all commands.
- CRTMSRVPGM
Re-creates service program MMAIL/SENDMAIL and optionally re-binds all programs in library MMAIL.
- CRTPNLS
Re-creates all panel groups.
- CVTTOPDF
Allows to select the favorite tool for converting spool files to PDF's. See
Main utilities.
-
DFTSICON
Defines a default subject icon to be used in all the outbound e-mail messages when a subject icon is not explicitly requested.
- DUPMMAIL
Duplicates library MMAIL to separate production and test environments. See How to handle multiple MMAIL libraries
- DUPSRVPGM
Updates copies of service program SENDMAIL and rebinds related programs.
See MMAIL update dependencies.
- EMLDFTBODY
Defines a default message body for commands EMLSAV, EMLSTMF, EMLSPL, EMLSPL2, STREMLSPLF, STREMLSPL2.
Main utilities.
- HTTPCFG
MIME & Mail documentation (the pages you are reading now)
are written in HTML. This command adds the related (Original or Apache)
HTTP directives to an HTTP instance of your choice.
- INFOPRINT
This command creates the environment needed by IBM Infoprint Server for iSeries, 5722-IP1
to convert spool files to PDFs through the SENDMAIL service program.
For information about Infoprint Server, see this page.
- INSTALLZIP
Installs command zip and unzip for QPASE and QSHELL. This command is used during MMAIL installation, but can also been run aside.
- NORLSINFO
If your IBM System i is connected to the Internet and library HTTPAPI is installed,
at given points a check is made to find out whether a more recent MMAIL release is available.
If so, a message is sent to the user profile running MMAIL. This check is performed every 15 days for each given MMAIL user.
You may run command MMAIL/NORLSINFO to suppress these warning messages.
- NOSUBJECT
This command provides a text to be used for all the e-mail messages with no subject.
E-mail messages with no subject are usually assigned a higher SPAM score and therefore undergo a higher risk of not been delivered.
- QTMHHTP1
This command must be run from a *SECADM user profile.
It provides user profiles QTMHHTTP and QTMHHTP1 with authorities over each other.
It is needed whenever CGI's want to use the spool file conversion provided
by INFOPRINT.
- REBIND
Re-binds MMAIL programs in a given library or through MMAIL library and cloned libraries.
See MMAIL update dependencies.
- SETCONFID
E-mail messages with sensitivity "confidential" display
a special warning in their titles.
Use this command to customize this warning.
- SETCGILIB
This command sets the library environment needed by CGI
to run SENDMAIL subprocedures. See this page.
- SETEMDELAY
Specifies the number of milliseconds (100 to 9000) to wait between to consecutive outgoing messages.
- SETMAILLIB
Populates a user development library with the objects needed to create and run MMAIL-based programs:
- duplicates of MMAIL service programs
- duplicates of MMAIL binding directories
- duplicates of MMAIL/QRPGLESRC members used for /COPY:
- HSPECS - H specifications
- HSPECSBND - H specification for binding directories
- PROTOTYPEB - CGIDEV2 procedure prototypes
- MAILPROTO - MMAIL procedure prototypes
- VARIABLES3 - CGI programs common variables
- USEC - Common Structure for API Error Code Parameter
The following is an example of the beginning of an MMAIL-based ILE-RPG program in library mylib:
/copy MYLIB/qrpglesrc,hspecs
/copy MYLIB/qrpglesrc,hspecsbnd
Ffilespec if e disk
/copy MYLIB/qrpglesrc,prototypeb
/copy MYLIB/qrpglesrc,mailproto
/copy MYLIB/qrpglesrc,variables3
/copy MYLIB/qrpglesrc,usec
By using SETMAILLIB command, your new MMAIL-based programs are not linked to MMAIL service programs,
and you have no impact when installing a new MMAIL release. See also
Development libraries in the Introduction.
Should you, by any chance, experience that - after installing a new version of library MMAIL - programs in library mylib
display a "service program signature" error, just run the following:
addlible mmail
mmail/rebind mylib
-
SETMSGLVL
Use this command to set the level of joblog MMAIL messages and optionally log these messages on file MMAILDATA/MMAILDEBUG.
See this page.
-
SETSAVOPT
Use this command to specify some features for logging the MMAIL outgoing messages. See this page.
-
TESTEMAILA
Use this command to test whether an e-mail address is validated as OK from subprocedure VLDEMAIL() of service program MMAIL/SENDMAIL.
-
TIMEZFMT
Use this command to select the format of the time zone in the
DATE headers generated for the MIME messages.
The following time zone formats are supported:
UT | Coordinated Universal Time |
GMT | Greenwich Meridian time (alias of UT) |
-/+hhmm | offset from Coordinated Universal Time (see system value QUTCOFFSET) |
local time zone | as computed from system value QUTCOFFSET |
- VLDEMLADDR
Use this command to tell whether all the e-mail addresses in a mail
message should be validated before the message is sent.
See this page.
- WRKADDR
Allows to maintain the "address book" used by the
5250 utility and by command
STREMLSPLF.
- WRKGRP
Allows to maintain the "groups" (distribution lists) used by the
5250 utility and by command
STREMLSPLF.
- WRKMDTBC
This command, with command ALWMDTBC
allows to automatically send blank copies of any message to some
"blind" recipients. This allows to maintain a full log out outgoing messages.
See this page.
"MIME file" commands are commands used for creating, managing,
and e-mailing MIME files. In several cases (see for instance all
the EML... commands), the end user does not even need to know what
a MIME file is.
-
CRTMIME.
Creates a MIME file without the "send" (sender, addressees) data.
Command WRKMIME allows to work
with these files.
These MIME files can then be e-mailed with command
SNDMIME.
It is part of the
5250 utility.
- CUSTEMAIL
Runs a sample case where customized letters are e-mailed.
See the the program source.
- EDBG
This is a widely used command that simplifies the debug setup by automatically
- issuing a ENDSRVJOB command and a ENDDBG command
- issuing, if needed, a simplified STRSRVJOB command for the desired job
- issuing a STRDBG command for the desired program
This command relieves you from the stress you would have to go through with starting debug.
- EMBEDSPLF
This command embeds a message text and a SCS spooled file into a single stream file
that can be used as a message body in e-mail commands EMLHTML, EMLNOTE or POSTANOTE.
This command implements a way to embed a spooled file in the body of an e-mail message.
It is part of the
Main utilities.
- EMLHTML
E-mails an HTML stream file as message body.
It is part of the
Main utilities.
- EMLHTML2
E-mails an HTML stream file as message body and attachs up to 30 stream files.
It is part of the
Main utilities.
- EMLMSG
E-mails a simple message taking it from a source member.
It is part of the
Main utilities.
- EMLNOTE
Creates a "multiform" (TEXT/HTML/XML) body MIME file with up to 50 attachments and sends it to up 300 receivers.
See Main utilities.
- EMLPTUMSG
E-mails an impromptu message.
It is part of the
Main utilities.
- EMLQPMSG
E-mails a Quoted-Printable impromptu message.
It is part of the
Main utilities.
- EMLSAVF
E-mails a save file.
It is part of the
Main utilities.
- EMLSMTPEMM
E-mails an impromptu char string with attachments.
It is part of the
Main utilities.
- EMLSPL
E-mails up to 30 spool files. Optionally, the spool files can be
converted to PDFs (single PDF name supported).
It is part of the
Main utilities.
- EMLSPL2
Similar to comand EMLSPL, but each PDF can be given a different name.
It is part of the
Main utilities.
- EMLSPL3
Similar to comand EMLSPL2, but the body is mandatory and is built from a stream file.
It is part of the
Main utilities.
- EMLSPLX
Similar to EMLSPL, but also allows to select the desired PDF conversion utility.
It is part of the
Main utilities.
- EMLSRCM
E-mails a source member.
It is part of the
Main utilities.
- EMLSTMF
Use this command to e-mail up to 30 stream files.
It is part of the
Main utilities.
- EMLTXTSTMF
E-mails a text stream file as body and attaches up to 30 stream files.
It is part of the
Main utilities
- ENDEMLSPLF
Ends the automated e-mailing of spool files
started with command STREMLSPLF.
-
ENDMONIFS.
Ends the automated e-mailing of PDFs initiated by command STRMONIFS.
- MIMEMENU
Is the entry point to the
5250 utility.
- MRGJOBSPLF
Merges the job *SCS spool files to a single spool file named JOBSPLFS.
It is part of the
Main utilities.
- POSTANOTE
Takes advantage from a local service to have a given e-mail address sending messages requested by different user profiles.
Each message is a "multiform" (TEXT/HTML/XML) body MIME file with up to 50 attachments and to up 300 receivers.
See Main utilities.
- RESEND
Resends e-mail messages that have failed to be sent.
It is part of the
Main utilities.
- RTVSTMF
It provides - in file QTEMP/FNDRESX - a list of all the stream files residing in an IFS directory
(and optionally in its subdirectories) and with names matching a given name pattern.
Morte information available in the command prompt help text.
-
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.
The MIME message can be sent up to 100 receivers.
It is part of the
Main utilities.
-
SNDMIME.
E-mails a MIME file created with command
CRTMIME.
It is part of the
5250 utility.
- SNDSMTPEMM
Send SMTP E-mail Message.
It is a
system command.
-
STREMLSPLF.
Starts the automated e-mailing of spool files.
User-specified spool files from one or several output queues
- as soon as they become ready - are e-mailed
to different distribution lists according to their
spool file names. Spool files can optionally be converted
to PDF's. Execution is submitted to batch.
A log of the spool files sent is maintained on file
qgpl/spllog
This command belongs to the
Main utilities.
-
STREMLSPL2.
A slightly different version of command STREMLSPLF.
See
Main utilities.
-
STRMONIFS.
Starts the automated e-mailing of PDFs.
You can define special IFS directories and associate distribution lists to them.
When a PDF is created in one of these directories, it is e-mailed to the appropriate distribution list(s).
This command belongs to the
Main utilities.
-
WRKMIME
Allows to work with the MIME files created by command
CRTMIME.
It is part of the
5250 utility.
- ADDHYPERL
Adds hyperlinks to the texts of a stream file.
Hyperlinks are generated for texts containing URLs (http://...)
and for texts containing e-mail addresses.
This command should be used only for HTML stream files.
- AFPTOOL/AFPTOOL
Converts an *SCS or an *AFPDS spool file to a PDF stream file. See
Main utilities.
- CHGJBCCSID
Allows to change the CCSID to all jobs with a given
(generic) name and a given status.
- CLRDTAQ
Clears a data queue.
- CMPSTMF
Compares two stream files, stops on the first mismatch, provide a detail report on mismatch.
- CPYSPLFPDF
Converts an *SCS or *AFPDS spool file to a stream file PDF.
It requires at least V7R1.
It is part of the
Main utilities.
- CRTSPLFACT
Creates the V6R1 programs needed to support the Spooled File Actions.
- CVTFRMB64 Decodes a BASE64 stream file.
- CVTSPLSTMF
Converts an *SCS, *IPDS, *LINE, or *AFPDSLINE spool file to a stream file.
Text, HTML, and PDF conversions supported.
It is part of the
Main utilities.
- CVTSPLFPDF
Converts an *SCS or an *AFPDS spool file to a PDF stream file. See
Main utilities.
- CVTTOB64 Encodes a stream file to BASE64.
- DSPPROP
Provides detail information for each section (body and attachments) of a message stream file.
- ENBSPLFACT
Enables the Spooled File Actions.
- F_TO_STMF
Copies a database file member to a stream file, see this page.
- FAILMSGRCV
Lists the database file MMAILDATA/MSGRCVFAIL containing the log of POP3 e-mail messages that failed to be retrieved by AMailer procedures.
See Errors in retrieving POP3 e-mail messages.
- GETDNSIP
This command issues a screen where you can ask for the IP address of a given DNS host name.
Note: Program MMAIL/GETDSNIP -called from this command- in order to find the IP address of a given DNS name,
calls procedure CvtDnsToIP() of service program MMAIL/SOCKETMAIL.
This procedure receives a DNS name and returns an IP address.
The prototype of this procedure is documented in member YYYPROTO of MMAIL/QRPGLESRC file.
- MMAILWTR
Use this command to submit a batch job that cares for maintaining writer MMAIL always active.
- MNGSPLF
It's a more granular utility than system command WRKSPLF.
See this page.
- READDIR
Reads a given IFS directory and its subdirectories.
A database file output (QTEMP/LISTDIR)
is provided.
- RELEASED
Displays information about the release of MIME & Mail.
- SETAFPTOOL
Creates parameter templates for command AFPTOOL/AFPTOOL, see this page.
- SETSPLFPDF
Creates parameter templates for command CVTSPLFPDF, see this page.
- SETSPLSTMF
Creates parameter templates for command CVTSPLSTMF, see this page.
- SETSPLTOOL
Creates parameter templates for command SPLTOOL/SPL2STMF, see this page.
- SPLFTOPDF
Converts a spool file to PDF, using the conversion tool
previously selected with command CVTTOPDF.
- SPLPDFCVT
Creates parameter templates for commands CVTSPLSTMF and CVTSPLFPDF, see this page.
- STMFCVT
Converts a stream file to a different CCSID stream file.
- UNZIP
Allows to unzip zipped (compressed) stream files.
-
WRKEMLPDF.
Allows to associate distribution lists and IFS directories for e-mailing PDFs through command STRMONIFS.
- WRKSPLFACT
Allows to check out the Spooled File Actions
and to remove the ones not needed.
-
WRKUSREML.
Allows to associate e-mail addresses to system user profiles.
Very convenient when command MNGSPLF is used
or when Spooled File Actions are installed.
- ZIP
Allows to compress stream files into a .zip stream file.
|