Skip to main content  
  Easy400   |       IBM System i home   |   RSS feed
Public Source
 
Introduction
Main utilities
5250 utility
Windows utility
Commands
Service program
Sample code
CGI support
FAQ
Bibliography
Index
 
Download
 
 

 
Search   
Commands

"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.

1. "Setup" commands
2. "MIME file" commands
3. Miscellaneous commands


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.



    Contact