Skip to main content  
        IBM System i home   |   Easy400     |   MMail  
Public-Source
 
Introduction
Installation
Define users
Work as user
Appendix A - Setting the environment for local mail users
Appendix B - Processing incoming mail your own way
Appendix C - Tools
Appendix D - AMailer commands
Index
 
Download
 
 

 
Search   
AMailer - Define user accounts


User accounts can be created, changed, and removed.

It takes a user profile CLASS(*SECADM) user profile to accomplish this job.

 

1. Starting
Figure 01
Figure 1 - No user accounts so far
Use the following URL to work with user accounts:
  http://.../mailusers
You will be asked to logon with user_profile/password.
You must logon with a user profile CLASS(*SECADM).
This is needed
  • for security reasons
  • because creating an user requires special authorities
Initially, as no user account is defined yet, you would receive the screen in Figure 1.
Once some user accounts have been created, you would also receive a list of the existing users (see Figure 10).

To create a new user account, press the button "new user". You will receive the screen in Figure 2.
Figure 02
Figure 2 - Select the type of user account
Note - The restriction for a Local User to receive mail only from local SMTP clients can be removed in the way illustrated at this topic.

 

2. Define an Internet user account

Internet users are users already defined at an ISP (Internet Service provider).
They usually get their mail on a PC mailer (e.g. Outlook) connected to the ISP POP3 server via an appropriate account definition.

In this case, AMailer will generate an account definition able to connect to the ISP POP3 server in order to receive the mail addressed to this Internet user.

Worth be noted that this AMailer account will not connect to the ISP SMTP server to send mail. Mail will be sent from the IBM i SMTP server.

  • Important note- You must make sure that the ISP POP3 server is a supported POP3 server.
    The supported POP servers are:
    1. The traditional basic POP3 server
    2. Microsoft Exchange POP3 server
    AMailer would not be able to receive incoming mail from other POP3 servers.
    Use the following procedure to check out the pop server you care for:
    • Find out the IP address of the ISP POP3 server.
      If you do not know its IP address, just ping the DNS name of the ISP POP3 server to find it.
      The DNS name of the POP3 server can be found from the pc-mailer (e.g. Outlook) account.
    • From your IBM i Command Entry screen run command
      TELNET RMTSYS('IP address_of_the_ISP_POP_server') PORT(Port_of_the_ISP_POP3_server)
      • usually the Port_of_the_ISP_POP3_server, is port 110
      • example: TELNET RMTSYS('195.110.124.132') PORT(110)
    • As a result of this TELNET command, the local POP3 server should respond in one of these ways:
      Figure A03 - Traditional basic POP3 server
      Figure A04 - Microsoft Exchange POP3 server
      If you get no response, or you get a response different from one of the above,
      then the ISP POP3 server is NOT a supported one and AMailer cannot correctly receive mail from it.

On the screen in Figure 2

  • select the "Internet" radio button
  • (press the "go" button)
You will receive a screen in Figure 3.
Figure 03
Figure 3 - Creating an Internet mail user account

  • Local account data
    The following is needed for defining the account on the IBM i:
    • Local account ID
      This is a unique name (usually the last name or an acronym, example Frank) identifying this user.
      This Local account ID is requested by validation list QGPL/AMAILER when willing to log on through Amailer as this user.
      It is case sensitive.
    • Full name
      Full name of the user. This piece of information is used to create the sender's name on the outgoing mail.
    • Validation list password for local logon / verify
      This is the password associated to the Local account ID, that is requested by validation list QGPL/AMAILER when willing to log on through Amailer as this user.
      It is case sensitive.
    • Internet e-mail address when sending messages
      This is the e-mail address to be used as sender's address in the outgoing mail.
      This must be the same as the e-mail known for this user at her/his ISP.

  • Options for sending mail
    The following information is used to generate outgoing mail:
    • Character set
      See this page for a list of registered character sets.
      Please note that, in this case, the character set is taken from the value set by command MMAIL/CHARSET and cannot be changed.
    • Reply-to e-mail
      The e-mail address where reply-to messages should be addressed.
      This is usually the sender's e-mail address (as the default value "*sender" suggests), but could be different.
    • Return-path
      The e-mail address where non-delivery messages ("bounce" messages) should be addressed
      (non-delivery messages are messages stating that the recipient could not be reached).
      This is usually the sender's e-mail address (as the default value "*sender" suggests), but could be different.
      However, it must be noted that usually end-receving SMTP servers do ignore this type of information.

  • Parameters for receiving mail
    The following information is need to receive mail from the IPS POP3 server:
    • ISP POP3 server
      You may choose between the DNS name of the POP3 server (host name of the POP3server) or the IP address of the POP3 server.
      • DNS name of the POP3 server - This is the safest way. The IP address of the POP3 server - used to perform the connection - will be automatically retrieved whenever needed and you do not need to be concerned about its possible changes.
        The DNS name of the POP3 server can be found from the pc-mailer (e.g. Outlook) account.
      • IP address of the POP3 server - If you select this option, you will have to check now and then if the IP address has been changed by its ISP.
        If you do not know the IP address, just ping the DNS name of the ISP POP3 server to find it.
    • Is it a SSL POP3 server?
      When the communication to the POP3 server is through Secured Socket Layer (SSL),
      you must use DCM (Digital Certificate Manager) and create a Certificate Store needed by SSL, see However, if the remote account (example: a GMail account) allows its mail be forwarded to another account, you can use this option to forward the mail to local-Internet account defined on your IBM i, thus saving all the problems of defining and testing a SSL POP3 connection, see this topic.
    • Port number of the ISP POP3 server
      When a non-SSL POP3 is used, usually the port number is 110.
      When a SSL POP3 is used, usually the port number is 995.
    • User name at the ISP POP3 server
      The user name this user is registered at the ISP site.
      It can be found from the pc-mailer (e.g. Outlook) account.
    • Password at the ISP POP3 server / verify
      This must be reported by the user. It is case sensitive.

  • Options for receiving mail
  • Retain mail at the ISP POP3 server after receiving it
    This option tells whether the POP3 server should retain the mail messages after they have been received by AMailer.
    If this is done ("yes"), the user could retrieve again the same mail messages also from the pc-mailer (e.g. Outlook).
  • Remove mail at the ISP POP3 server after local deletion
    This option tells whether the POP3 server should be instructed to remove mail messages after they have been locally deleted in AMailer.
    A "yes" here makes sense only if the answer to the previous question was also "yes".
  • Log all communications with the ISP POP3 server
    This is a debugging tool to be very careful with, as it could generate tons of record on file QGPL/POP3LOG.

Note on Privacy - The following pieces of information are recorded in ciphered mode:

  • Validation list password for local logon
  • User name at the ISP POP3 server
  • Password at the ISP POP3 server

Note on account properties - Users can change their accounts properties after loggin to AMailer.

 

3. Define a Local user account

Local users can

  • exchange mail among themselves
  • exchange mail with Internet users defined to AMailer on the same IBM i they are connected to
  • send mail to external Internet mail addresses
but cannot receive mail from external Internet mail users, as their POP3 server, the IBM i POP3 server, cannot be reached from the outside.
Note - The restriction for a Local User to receive mail only from local SMTP clients can be removed in the way illustrated at this topic.

A Local user receives mail from the IBM i POP3 server, while outbound mail is sent from the IBM i SMTP server.

In order to work, a Local user account needs the following be defined:

  • An user profile
  • A system directory entry for the user profile
  • A SMTP alias entry for the directory entry
The system directory entry must specify in parameter SYSNAME the system name as it appears from command dspneta.
Besides, the system name shouuld be an entry in the TCP/IP Host Table.
The IP address specified in this entry is the address to be used as IP address of the local POP3 server.
For more information on this subject, see Appendix A.

AMailer allows to create a Local user

  • Either on an existing user user profile: in this case, the related system directory entry and SMTP alias table entry are created only if they do not exist already, otherwise they are kept as they are.
    Creating Local users over existing user profiles is the correct approach when a user profile is already active in local mail exchange.
  • OR by creating a new user profile, a related system directory entry and a SMTP alias table entry from scratch.
    This is the correct approach to be used when a Local user profile is not yet available for local mail exchange.

Important note - Before creating, changing or removing Local user accounts, make sure to run the following commands:

  • ENDTCPSVR *SMTP
  • ENDTCPSVR *POP
and to restart these TCP servers after performing this job.

 

3A. Define a Local user account from scratch

On the screen in Figure 2

  • select the "Local" radio button (and press the "go" button)

    You will receive the following screen:
    Figure 03A1
    Figure 3A1 - Whether to use an existing user profile

  • Select the "no" radio button (and press the "go" button) to receive the next screen:
    Figure 03A2
    Figure 3A2 - Creating a Local user from scratch

    The creation of a Local user from scratch results into the creation of an user profile, a system directory entry and the related SMTP alias table entry.

    • Local account data
      The following is needed for defining the account on the IBM i:
      • Local account ID
        This is a unique name (usually the last name or an acronym, example "jsmith"), case sensitive, identifying this user.
        This Local account ID is requested by validation list QGPL/AMAILER when willing to log on through Amailer as this user.
      • Full name
        Full name of the user. This piece of information is used to create the sender's name on the outgoing mail.
      • New password for user profile and validation list logon / verify
        This is the password associated to the user profile and the validation list entry which will be created. It is case sensitive.
      • E-mail address when sending or receiving messages
        The local e-mail address has the format
           user_name@domain_name
        The user name must be unique within the domain name.
        The domain_name must be the same as the system name and must be associated to an active IBM i interface (see this page).

    • Options for sending mail
      The following information is used to generate outgoing mail:
      • Character set
        See this page for a list of registered character sets.
        Please note that, in this case, the character set is taken from the value set by command MMAIL/CHARSET and cannot be changed.
      • Reply-to e-mail
        The e-mail address where reply-to messages should be addressed.
        This is usually the sender's e-mail address (as the default value "*sender" suggests), but could be different.
      • Return-path
        The e-mail address where non-delivery messages ("bounce" messages) should be addressed
        (non-delivery messages are messages stating that the recipient could not be reached).
        This is usually the sender's e-mail address (as the default value "*sender" suggests), but could be different.
        However, it must be noted that usually end-receving SMTP servers do ignore this type of information.

    • Parameters for receiving mail
      The following information is need to receive mail from the local POP3 server:
      • IBM i POP3 server IP address
        The IP address of the local POP3 server (see this page).
      • Is it a SSL POP3 server?
        When the communication to the POP3 server is through Secured Socket Layer (SSL),
        you must use DCM (Digital Certificate Manager) and create a Certificate Store needed by SSL, see this page.
      • IBM i POP3 server port number
        The port where the local POP3 server is listening.
        If the local POP3 server is not SSL based, this is usually port 110, however see this page.
        If the local POP3 server is SSL based, usually itb listens on port number 995.

    • Options for receiving mail
    • Retain mail at the IBM i POP3 server after receiving it
      This option tells whether the POP3 server should retain the mail messages after they have been received by AMailer.
      If this is done ("yes"), the user could retrieve again the same mail messages also from the pc-mailer (e.g. Outlook).
    • Remove mail at the IBM i POP3 server after local deletion
      This option tells whether the POP3 server should be instructed to remove mail messages after they have been locally deleted in AMailer.
      A "yes" here makes sense only if the answer to the previous question was also "yes".
    • Log all communications with the ISP POP3 server
      This is a debugging tool to be very careful with, as it could generate tons of record on file QGPL/POP3LOG.

    Note on Privacy - The following pieces of information are recorded in ciphered mode:

    • Password for user profile and validation list logon
    Note that the validation list password and the user password must be kept identical.

    Note on account properties - Users can change their accounts properties after logging to AMailer.

     

    3B. Define a Local user account based on an existing user profile

    On the screen in Figure 3A1

  • select the "yes" radio button (and press the "go" button).
    You will receive the following screen:

    Figure 03B1
    Figure 3B1 - Specifing an existing user profile for a new Local account
    Type the name of an existing user profile and press the "go" button. You will receive the following screen:

    Figure 03B2
    Figure 3B2 - Status of the existing user profile
    This screen is for information only.
    In this case, the user profile has a related system directory entry, but no SMTP alias table entry.
    When the SMTP alias table entry and/or the system directory entry are not available, they are automatically created during the account generation process.
    Just press the "go" button to continue with the next screen.:

    Figure 03B3
    Figure 3B3 - Define a nerw Local account based on an existing user profile

    The creation of a Local account from an existing user profile results into the creation of a system directory entry and a related SMTP alias table entry if they were missing.

    • Local account data
      The following is needed for defining the account on the IBM i:
      • Local account ID
        This is a unique name (usually the last name or an acronym, example "jsmith"), case sensitive, identifying this user.
        This Local account ID is requested by validation list QGPL/AMAILER when willing to log on through Amailer as this user.
      • Full name
        Full name of the user. This piece of information is used to create the sender's name on the outgoing mail.
      • New password for validation list logon / verify
        This is the password associated to the the validation list entry which will be created. It is case sensitive.
        Please note that this password must match the user profile password. In case of a mismatch, the local POP3 server will reject any attempt to logon as this user.
      • E-mail address when sending or receiving messages
        The local e-mail address has the format
           user_name@domain_name
        The user name must be unique within the domain name.
        The domain_name must be the same as the system name and must be associated to an active IBM i interface (see this page).

    • Options for sending mail
      The following information is used to generate outgoing mail:
      • Character set
        See this page for a list of registered character sets.
        Please note that, in this case, the character set is taken from the value set by command MMAIL/CHARSET and cannot be changed.
      • Reply-to e-mail
        The e-mail address where reply-to messages should be addressed.
        This is usually the sender's e-mail address (as the default value "*sender" suggests), but could be different.
      • Return-path
        The e-mail address where non-delivery messages ("bounce" messages) should be addressed
        (non-delivery messages are messages stating that the recipient could not be reached).
        This is usually the sender's e-mail address (as the default value "*sender" suggests), but could be different.
        However, it must be noted that usually end-receving SMTP servers do ignore this type of information.

    • Parameters for receiving mail
      The following information is need to receive mail from the local POP3 server:
      • IBM i POP3 server IP address
        The IP address of the local POP3 server (see this page).
      • Is it a SSL POP3 server?
        When the communication to the POP3 server is through Secured Socket Layer (SSL),
        you must use DCM (Digital Certificate Manager) and create a Certificate Store needed by SSL, see this page.
      • IBM i POP3 server port number
        The port where the local POP3 server is listening.
        If the local POP3 server is not SSL based, this is usually port 110, however see this page.
        If the local POP3 server is SSL based, usually itb listens on port number 995.

    • Options for receiving mail
    • Retain mail at the IBM i POP3 server after receiving it
      This option tells whether the POP3 server should retain the mail messages after they have been received by AMailer.
      If this is done ("yes"), the user could retrieve again the same mail messages also from the pc-mailer (e.g. Outlook).
    • Remove mail at the IBM i POP3 server after local deletion
      This option tells whether the POP3 server should be instructed to remove mail messages after they have been locally deleted in AMailer.
      A "yes" here makes sense only if the answer to the previous question was also "yes".
    • Log all communications with the ISP POP3 server
      This is a debugging tool to be very careful with, as it could generate tons of record on file QGPL/POP3LOG.

    Note on Privacy - The following piece of information is recorded in ciphered mode:

    • Password for validation list logon
    Note that the validation list password and the user password must be identical.

    Note on account properties - Users can change their accounts properties after logging to AMailer.

     

    4. Extend a Local user account to exist in the outside Internet world

    This topic illustrates how you can make IBM i mail local accounts exist in the Internet, so that they can also receive mail messages from the outside world.
    In other words, this topic tells how you can have your IBM i supporting mail boxes as if it were just another ISP mail server.

    4a. Add a MX record to your IBM i DNS configuration
    First of all, your IBM i must be defined through a domain name.
    As an example, the IBM i supporting this site can be reached through domain name easy400.net at IP address 178.249.3.55. This is defined at ISP www.register.it.
    What I did was to logon at my ISP, ask for my domain name www.easy400.net DNS configuration and

    1. add an A record named mail.easy400.net with the same IP address 178.249.3.55
    2. add a MX record related to the previous A record mail.easy400.net.

    4b. Update the e-mail addresses of your local mail accounts
    In this way, my local IBM i accounts could now be reached from the Internet by adding @mail.easy400.net to their account names.
    For instance, I used to have a local mail account previously defined (see Figure 3A2) as jsmith@easy400.
    I used the mailusers Change option to redefine it as jsmith@mmail.easy400.net
    and when I sent a message from Internet to this e-mail address, it was immediately available at its IBM i mail box, so that I could receive it through AMailer from the IBM i POP3.

    4c. Update your SMTP attributes
    If you are on OS/400 release V7R2 or subsequent, make sure to run command
    CHGSMTPA VFYID(*NO) .
    This is required to force the local POP3 to accept the username of the addressee when receiving mail from the outside.

    4d. Define the IBM i "ex-local" account to your mailer
    Though AMailer and command PRCUSRMAIL can of course be used to receive the incoming mail, this can also be done through a conventional PC mailer, such as Microsoft Outlook.
    The following tells how you can define the appropriate account to, say, Outlook.

    • User information
      • Name: any name is OK
      • E-mail address: the e-mail address specified for this local mail account in Figure 3A2, example: jsmith@mmail.easy400.net .
    • Server information
      • Account type: must be POP3 .
      • Incoming mail Server: the domain name of the IBM i box, example: mail.easy400.net .
      • Outgoing mail Server (SMTP): select one of the following
        1. The SMTP server provided by your ISP
        2. Domain name of the IBM i box (example: mail.easy400.net) to use the IBM i box SMTP.
          This however requires command CHGSMTPA specify parameter "Allow relayed mail ALWRLY(*YES)" and the IP address of your PC be added through command
          ADDSMTPLE TYPE(*ACCEPT) INTNETADR('nnn.nnn.nnn.nnn').
          Do not use this option if your PC has a dynamic address!
    • Access information
      • User name: the name of the local user profile (see Figure 4, column "local user profile").
      • Password: the password of this local user profile.



    5. Change or remove an user account

    Once one or more user accounts are defined, the URL

      http://.../mailusers
    provides a list of the existing user accounts:

    Figure 04
    Figure 4 - Table of the existing user accounts

    From this screen you may update or remove user accounts.
    The update screens are similar to the ones used for creating user accounts, with the restriction that the Account ID cannot be changed.

    Also note that, after logging to AMailer, an existing user may update his own account.


    6. A way to bypass remote POP3 connection problems

    If the remote EMail account supports the forwarding of the incoming mail to another "external" EMail account, you may use an alternate way of receiving EMail message on your IBM i.

    1. On your IBM i create a "local-Internet" account. See
      1. Define a Local user account from scratch and
      2. Extend a Local user account to exist in the outside Internet world.
    2. On your remote EMail account select the option to forward the incoming mail to your IBM i "local-Internet" account.
    You may then receive and process mail messages from your local IBM i POP3, without using SSL at all!

    At least two EMail servers support mail forwarding to an "external" mail account:

    1. GMail
      1. Logon to your GMail account.
      2. Click on the top right corner Gear-icon and click on "Settings".
      3. Click "Forwarding and POP/IMAP" tab.
      4. Click button "Add a forwarding address and follow instructions.
    2. Yahoo
      1. Open your Yahoo account mail.
      2. Click on the top right corner Gear-icon and choose "Settings" option.
      3. Select "Account" tab and click on edit button of default yahoo account.
      4. After clicking on this a window pop-up here, now check the forward Yahoo mail to another Email address.
      5. After specifying the Email address where mail should be forwarded, at that Email address you will receive a confirmation letter, and you must click the confirmation link.
      6. Upon clicking the confirmationlink, you receive a new WEB page:
        • Roll down until you see Manage your email addresses and in column "Set As Primary" check the radio button corresponding to the e-mail account where the incoming mail should be forwarded.




  •     Contact