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 - Mail receiving and delivering system
Appendix C - Processing incoming mail your own way
Appendix D - Tools
Appendix E - AMailer commands
Index
 
Download
 
 

 
Search   
  AMailer - Work as user

   


1. Log in
Figure 1
Figure 1 - Logging in (on Safari)
To log in, you should use the following URL
  http://.../mailer
You will be asked to enter the user_name and password you have been assigned.
You cannot change your user_name, but you can change your password any time you like (see section User properties, later in this page).

Your identification will stay in place for the whole session.

To log out, you must end the navigator session (close the window).

Once logged in, you would receive a screen as the one in Figure 2

Important note. The login validation procedure requires system value QRETSVRSEC be set to 1. Continued failures to login may depend from the fact that system value QRETSVRSEC is still set to 0.

Figure 2
Figure 2 - Initial screen

The screen is made up of three frames:

  • a thin top frame, dark cyan
  • a left frame
  • a right frame
Let us go through them.
  1. Top frame
    This frame contains four items, left to right:
    1. The name of the mail directory (folder) being displayed in the right frame (in this case, MailReceived)
    2. The full name of this user.
      If you click on this name, you open a popup window showing the properties of your profile. You may also change properties, for instance your password
      (for details, see section User properties at the end of this page.
    3. A link to the Tools window (see Appendix D).
    4. Current date and time, updated on a one minute cycle.
  2. Left frame
    This frame contains a list of the available mail directories (folders) for this user.
    The directory currently displayed in the right frame is in bold characters.
    Each directory may display a number within parethesis: that is the number of mail messages not yet opened.

    Click on a directory name to display its contents.

    Three default mail directories are provided:

    • MailReceived contains the incoming mail
    • MailSent contains the outgone mail
    • MailRemoved contains the mail that you have temporarily removed from other mail directories and is waiting for final deletion.
    Of course you may create new mail directories and move or copy mail messages from a directory to another directory. This is discussed in section Organize mail.

    Two small icons are available at the end of this frame.

    • The one labeled refresh just refreshes the list of the directories in this frame
    • The one labeled manage allows you to create, rename, delete mail directories.
      For detailson this, please refer to section Organize mail.
  3. Right frame
    This is the heart of mail processing. Mainly in this frame you have:
    • a stack of control buttons
    • a list of the mail messages available in the current directory
      (you may change mail directory by clicking another directory on the left frame)
    • some check all   uncheck all   links
    1. list of mail messages
      • one message per row
      • message columns for sender, receiver, subject, send date & time
      • messages not yet opened are in bold characters
      • to open a message, either click on any field of its row, or double click on its check button
    2. control buttons ..
      receive mail This is for receiving new mail. For details about receiving mail, see section Receive mail
      write new message This is for creating a new message to be sent. For details about sending mail, see section Create and send a message
      remove all checked-in messages Click this icon to remove all checked-in messages.
      This icon shows up only when at least one message is checked in.
      For details about removing messages, see section Remove mail.
      reply to checked-in message This is for replying to the sender of a message. It requires that you select first - through its check box - the message to be replied. For details about replying to messages, see section section Reply-to message.
      reply-all to checked-in message This is for replying to the sender of a message and copying all the people on the origina distribution. It requires that you select first - through its check box - the message to be replied. For details about replying to messages, see section section Reply-to message.
      forward checked-in message This is for forwarding a message. It requires that you select first - through its check box - the message to be forwarded. For details about forwardinging to messages, see section section Forward message.
      search
      This allows to display the messages in the list that match a given search string.
      When you press this button, the following is displayed:
      Figure 3
      You should enter the search string (over the Search for ... saying) and press the green magnifier icon.
      All the messages in the page are searched for such a string in the fields From, To, and Subject and only the ones matching are listed.
      To return from the subsetted list, just press the next icon, the "refresh" one (see next).
      refresh Press this icon to refresh the message list.
      Enable self-mail receive every x minutes Click this icon to enable a self-mail receive. A time interval of "n" minutes is set. As soon the the time interval expires, a request to check for new mail is issued and a new time interval is started.
      The number of minutes for the time interval can be set from the "Tools" window, see Appendix D.
      While this never-ending self-mail receive cycle is active, the icon is replaced by a flashing light icon (see next).
      Disable self-mail receive This flashing light icon warns that the self-mail receive is active. Just press this icon to stop the self-mail receive function.
      Figure 3- Control buttons


2. Create and send a message
write new message Click the icon "write new message" to create and send a new mail message.
When you press this icon, the screen in Figure 4 appears:
Figure 4
Figure 4 - Creating a mail message

Focus areas in this screen:

  • control buttons
  • address buttons and text areas
  • subject
  • message properties
  • message preferences
  • message text area
  1. Control icons
    Just three control icons are available:
    back Press this icon to give up creating a new message and to go back to the previous screen.
    attach a file Press this icon to add attachments to this message.
    Providing attachments is discussed later in this section.
    send this message Press this icon to send the message.
    Outgone messages are stored in the MailSent directory.

  2. Address buttons and text areas
    Three text areas are available for entering distribution addresses: one for the To-distribution, one for the Cc(Carbon copy)-distribution, one for the CCn(Blank copy)-distribution.
    You may enter addresses manually, if you like, for instance by copying and pasting them.
    The name of a recipient is not mandatory, while the e-mail address is.
    The mail address must always be within acute brackets ( <...> ).
    Multiple destinations must be separated by commas.

    Some examples:
      John Brown <brownj@starmail.com>
    <dianaht@starlett.net>
    John Brown <brownj@starmail.com>, <dianaht@starlett.net>, Tom Dooley <tomd@iseries.com>

    The address buttons provide a convenient way to maintain an address book and to pick destination addresses from there.
    Pushing one or the other of the three address buttons makes no difference.
    The following popup is displayed:
    Figure 5
    Figure 5 - Address book

    1. Picking contacts
      In order to pick contacts and have them added to the address areas of the new message, operate as follow:
      • Select the contacts to be in the TO-destination and press the "To" button
      • Select the contacts to be in the CC-destination and press the "Cc" button
      • Select the contacts to be in the CCN-destination and press the "Ccn" button
      • Press the OK button
    2. Finding contacts
      The "Find" button helps in finding contacts from a huge address book.
      Operate as follow:
      • enter a search string and press the "Find" button
      • only the names containing the search string are listed
      • blank out the search string and press the "Find" button to display the full list
    3. Adding contacts
      To add a new contact, press the button "New contact"
    4. Updating contacts
      Select the contact to be updated and press the button "Update contact"
    5. Removing contacts
      Select the contacts to be removed and press the button "Remove contact(s)"
  3. Message properties
    The following message properties:
    • Notify receipt (request to the receiving mailer to send a return receipt when the message is opened)
    • Importance
    • Priority
    • Sensitivity
    can be set through the appropriate radio buttons.
    Such message properties may be handled differently from one receiving mailer and another.

  4. Message preferences
    A subset of the user properties ("Options for sending e-mail", see for instance Defining an Internet User)
    • character set
    • reply-to e-mail
    • return path
    may be changed just for this message, or permanently by pressing button "Save preferences".

  5. Message text area
    Write the text of your message in this area.
    The message is sent as TEXT/PLAIN.
    TEXT/HTML is not supported.


Providing attachments

You may attach files to your e-mail message, by pressing the Attach button.
The following popup is opened:
Figure 6
Figure 6 - Attaching a file
- Press the "Browse..."/"Choose File" button to select the file to be attached
- Press the "go" button to transfer the file from the client to the HTTP server.

Figure 6
Figure 7 shows the excerpt of an outgoing message, with two attachments.
  • to display an attachment, click on its name
  • to remove an attachment, click on the related remove attachment button
Figure 7 - Outgoing message with attachments


3. Receive mail
receive mail Icon "receivemail" in Figure 2 is the one to be pressed for checking and receiving the incoming mail.
This icon, when pressed, posts a receive-mail request for the appropriate username to the AMailer "Mail receiving and delivering system", see Appendix B for more information.
That not only returns the received mail, but also some feedback messages.

  1. Examples of feedback messages
    There are three cases:
    1. The feedback message has the format
      user-name's mail-receive locked by another task
      Another task has beed assigned the exclusive responsibility of receiving mail messages for this user-name.
      Refer to Appendix B to know more about this case.
    2. The feedback message has the format
         no new messages (out of yy in the POP server)
      Its meaning is as follow:
      • no new messages were received
      • If the user profiles specifies that messages should be retained on the POP server until they are locally deleted,
        • the POP server is currently storing yy mail messages, because they are not yet locally deleted.
    3. The feedback message has the format
         xx new messages (out of yy in the POP server)
      Its meaning is as follow:
      • xx new messages were received; they are listed (bold characters) at the end of the message list
      • If the user profiles specifies that messages should be retained on the POP server until they are locally deleted,
        • the POP server is currently storing yy mail messages.
        • xx are the new messages just delivered (and kept on the POP server)
        • yy-xx are messages kept on the POP server because not yet locally deleted.
    4. no feedback message displayed.
      If this happens, it means that the POP Client failed logging in at the POP server.
      This may be due to one of the following:
      • the POP server could not be contacted (either port 110 of the iSeries is not active, or the IP address of the POP server is not correct)
      • the username or the password used to login at the POP server are wrong


4. Display message

To display a message, click on any column of the message row (Figure 2) or double click on its check-box.
You are displayed something like this:
Figure 8
Figure 8 - Displaying a message

AMailer supports two types of Content-type for message body:

  • text/plain
  • text/html
Within Content-type: text/plain, Content-Transfer-Encoding: quoted-printable is also supported.

     

  1. Attachments
    Attachments are listed in the message header.
    Click on the name of an attachment to display it in a new window.

    Attachments are extracted from the MIME message file and converted at message-receive time.
    Conversion is supported for Content-Transfer-Encoding's:
    • base64
    • quoted-printable
    To display an attachment, click over its file name.

     

  2. Message Properties and Message Source icons
    In the right part of the message header (Figure 8) there are two small icons.
    1. Button message properties, named message properties, opens a popup to display the properties of the message.
    2. Button message source, named message source, opens a popup to display the MIME file, as it was received.

     

  3. The Copy/Move icon
    copy or move this message to another directory Press this icon to copy or to move the message to another mail-message directory.
    The following popup is opened:
    Figure 9
    Figure 9 - Moving or copying a message

    Select the target directory and press the "move" or the "copy" button.

    Should you need to create a new mail-message directory, press the button "new directory" to create it, then perform the copy or the move operation.



5. Reply-to message
reply to this message Click this icon, either in the screen of Figure 2 or in the screen of Figure 8 to reply to a message.

You will receive a screen similar to the one used to create a new message (Figure 4) except that

  • the "To" address is already filled in
  • the "Subject" is already set
  • the message text includes the text of the original message. If the original message had attachments, they are attached again to the reply-to message, but you may optionally remove them one at a time.

     
    reply-all to this message Click this icon, either in the screen of Figure 2 or in the screen of Figure 8 to reply-all to a message.

    You will receive a screen similar to the one used to create a new message (Figure 4) except that

  • the "To" address is already filled in
  • the "Cc" address is filled in with all the other addresses existing on the original message
  • the "Subject" is already set
  • the message text includes the text of the original message. If the original message had attachments, they are attached again to the reply-to message, but you may optionally remove them one at a time.

    6. Forward message
    forward this message Click this icon, either in the screen of Figure 2 or in the screen of Figure 8 to forward a message.

    You will receive a screen similar to the one used to create a new message (Figure 4) except that

  • the "Subject" is already set
  • the message text includes the text of the original message. If the original message had attachments, they are attached again to the forwarded message, but you may optionally remove them one at a time.

    7. Organize mail

    By "Organize mail" we mean the ability to create, rename, remove mail directories (folders) and to move and copy mail messages from one directory to another directory.

    Three directories are given as default:
    MailReceived, MailSent, MailRemoved.
    You may move and copy mail messages from / to these directories, but you cannot rename nor remove them.

    To move and copy a message from one directory to another directory, you must first display the message, then to use the "Copy/Move" icon.

    In addition, you may create your own user directories, that you can also rename and / or delete.

    The facility that allows to maintain user directories is activated from the button at the bottom of the left frame (Figure2).
    Some images of this facility:
    Figure 10
    Figure 10- The default directories
    Figure 10
    Figure 11- Adding an user directory
    Figure 10
    Figure 12- User directory added
    Figure 10
    Figure 13- Renaming an user directory
    Figure 6 - Attaching a file

    8. Remove mail

    You may remove mail

    • From the list of messages of a given directory (Figure 2), by checking the check-boxes of the messages to be removed, and pressing the "Remove" icon remove this message
    • When displaying a single mail message (Figure 8), by pressing the "Remove" icon.
    At this stage, a message is not deleted yet. It is moved into the "MailRemoved" directory.
    To delete a message then, you must remove it from the "MailRemoved" directory.
    What however happens at this point, dependes from some options in your profile (see section User properties).
    • if your profile tells "not to retain messages at the POP server once they have been received", your message is deleted as soon as it is removed from the "MailRemoved" directory
    • if your profile tells "to retain messages at the POP server after they have been received, your message - when it is removed from the "MailRemoved" directory - is not deleted, but "marked for deletion". It will no longer show up in the "MailRemoved" directory, and will be deleted only during the next login of this user at his POP Server. In fact, the local message record contains the ID assigned to this message by the POP server, and this ID id needed by the POP client to tell the POP server that it can remove its message for good.
    The exact timimg of message deletion makes no difference from a user perspective, inasmuch the user has no control on it.

    9. User properties

    You may access your profile properties by clicking on your name on the top frame of an AMailer screen (see Figure 2).

    You may then change, for instance, your password, your options for sending mail.
    You should however be very careful not to change by mistake your username at the POP server and the IP address of your PPOP server. Errors would impair the ability of the AMailer POP client to login at the POP server and to receive your mail.

    For more information on this topic, please refer to chapter Define users and section Define an Internet user or Define an Internal user.

    10. Data privacy

    It must be understood that all the mail messages and their attachments are stored on the iSeries, within its Integrated File System structure. Messages and attachments are not ciphered, nor are the Amailer application records (except two record fields, POP server user names and passwords).

    However, accessing from the outside and from the internal site the AMailer data is not easy for a number of reasons:

    • Message stream files stored on the IFS can be accessed only via CGI programs (user profile QTMHHTP1)
    • Attachments stream files stored on the IFS can also be accessed via an HTTP URL (user profile QTMHHTTP), however, it is not so easy to find what their URLs are
    • The way stream files are named and organized through directories, though rather simple in concepts, is hard to be understood by anyone not familiar with the internalities of Amailer

    Potential users should therefore be made aware of some potential risk on their data privacy.





  •     Contact