Call us at 1-866-559-0800

 IBM® Systems Management Specialists...

Click here

The IBM logo and the Business Partner emblem are trademarks of International Business Machines Corporation in the United States, other countries, or both.

Quick Start

Configuring System i E-mail

Use these instructions to configure your System i (or AS/400) system to send e-mail messages to the Internet. Your System i does not have to be the mail server; you will be able to specify the mail server’s IP address during setup. The System i will automatically route the message to your mail server and the mail server will subsequently deliver the message; routing it internally or sending it to the Internet. The message can then be received by most paging devices and any MIME compatible e-mail client (e.g. Notes, Outlook etc.).

If Route to SMTP gateway is *NONE or *SAME, continue with the next step. Otherwise, your system should already be configured to send e-mail messages and you can continue with step 10. If you are not sure of your systems current SMTP configuration status, proceed with the next step.

Select option 10 (Work with TCP/IP host table entries) and verify that your mail server name and internal IP address are in the list. If it’s already defined, add the MAILSERVER host name to the list of possible host names for the IP address. If not, add it to the TCP/IP host table. Type 1 in the option field and enter your System i (or AS/400’s) internal IP address and press <Enter>. Type MAILSERVER in the HOST NAME field and press <Enter>.

When adding the mail server to the TCP/IP host table you will need to enter the mail server’s internal IP address. Ask your system administrator for this information if you are not sure of the internal IP address of your mail server.

5.  Enter the command below to verify that the connection to your mail server is working properly.

The system should respond with the following message: Connection verification statistics: 5 of 5 successful (100%).

To enable an System i system to send mail to the Internet when a firewall is present (and this is the case for almost all Internet scenarios), set the FIREWALL parameter to *YES on the CHGSMTPA command above.

7.  Enter the command below to define the system distribution directory services user id and address that the System i mail services will use to route mail (within this system to the SMTP/MIME gateway) that have an internet address as recipients:

ADDDIRE USRID(INTERNET GATEWAY)

8.  Enter the command below to set the system distribution services attributes of your System i.

If you are running Domino R5/R6 on your System i (or AS/400) on the same system (or partition) as this systems’ OS/400 SMTP server you will need to perform a special SMTP bind operation so both servers can run concurrently. Click here to "Configure System i Dual Stack Support for SMTP”. Once you complete these instructions return here and continue with step 12 (below).

IF DOMINO IS RUNNING ON ANOTHER SYSTEM (OR PARTITION) THAN THE SYSTEM (OR PARTITION) THAT YOU ARE CONFIGURING YOU DO NOT NEED TO BIND THE SMTP SERVERS.

9.  Enter the commands below to end the OS/400 SMTP server and the mail server framework jobs.

10.Enter the command below to start the OS/400 SMTP server and the mail server framework jobs.

If the mail server jobs do not start after following the instructions above, you can do some preliminary troubleshooting by looking at the job logs for the QMSF, QTSMTPBRCL, QTSMTPBRSR, QTSMTPCLTD, and QTSMTPSRVD batch jobs. Most error messages that are found in those logs have a workable recovery procedure or lead to a PTF. Optionally, contact the IBM SupportLine EZ-Mail group for assistance.

Many times subsequent to applying an operating system release (or cumulative PTF package) the QMSF jobs will not start (or will periodically terminate). Run the following commands on your System i to correct the changes performed by the operating system upgrade:

CHGATR OBJ('/TMP') ATR(*RSTDRNMUNL) VALUE(*NO)

For more information on the above command see IBM Info APAR II13869

CHGJOBD JOBD(QSYS/QZMFEJBD) RQSDTA('QSYS/STRMSF MSGOPT(*RESUME) NBRMSFJOB(3)')

Now, restart the QMSF servers via the following command:

STRMSF, then press <Enter>

Use the WRKACTJOB command to check the QSYSWRK subsystem. Verify if the QMSF and QTSMTP* server jobs are running correctly. If all of the mail server jobs are running, continue with the next step.

12.Verify that a system distribution directory entry exists for the ACO user profile by entering the following command:

If you see the ACO user profile in the list, press <F3>, and continue with step 13. Otherwise, enter the command below to add the directory entry to your system.

13.Add a valid SMTP name to the ACO user profile by entering the following command:

As a result, the Work with Names for SMTP panel 1 will be shown. Enter a 1 in the options field, ACO in the user id field, and your System i system name in the address field and press <Enter>.

14.On panel 2 (below) enter ACO in the SMTP user id and your company's domain name in the SMTP domain field (e.g.aco@yourcompany.com). This should be a valid e-mail address known to your mail router. You do not need to enter the @ sign. Once you have completed your entries press <Enter> twice, then press <F3> to exit the Work with Names for SMTP command.

15.Enter the command below to send a test message to your local (e.g. Outlook) Internet e-mail address:

If your system is configured properly, you will receive the above test message in your e-mail client usually within a few seconds. If you successfully received the test message your System i is communicating with your mail  router; continue with step 16.

To validate the installation, you will change the default pager id (*DFT) to match your paging service contact information and then send a test message to this pager by performing the following steps:

As a service to you, our SupportLine will test your pager (or cellular phone) and send you the correct set up of the Work with Pagers information. E-mail the following information to support@ddlsystems.com or fax it to 866-559-0800:

• The name and phone number of your paging service provider.
• The modem access number that is used to dial the paging service computers directly (if known).
• The personal identification number of your pager (or cellular phone).

16.Select the Work with Pagers option from the configuration menu by entering a 3 in the selection field, then press <Enter>. You will be shown the Work with Pagers panel 1 (below).

Note:  The software is shipped with the pre-defined *DFT pager id which you will change to match your paging service contact information.

17.Enter a 2 in the option field next to the *DFT pager id on the list panel and press <Enter>. A second panel will appear like the one shown below. Enter a user-defined description, ACOPAGER in the line description name, 6 in the pager type field, and a 5 in the job queue priority. All other fields should be left blank.

Click here to review the service provider information table and enter the appropriate e-mail address for your device in the Internet e-mail address parameter.

If the Work with Pagers setup was provided to you by our SupportLine enter this information in the panel above. If you need assistance call our SupportLine at 866-559-0800 option 2 or send e-mail to support@ddlsystems.com.

18.Once you have completed entering your service contact information press <Enter> to return to list panel 1.

19.On list panel 1, enter a 10 (Send page) in the option field next to the ‘*DFT’ pager id and press <Enter>. The ACO Page Command panel appears (not shown). Enter the text you want to appear in the body of the e-mail message in the message text field. Once you have entered the information, press <Enter>.

As a result, the impromptu page request is automatically routed to your mail server. Your mail server will then deliver the message as it normally would; either routing internally or sending it to the Internet.

If you are not receiving messages sent to an external (non-local) Internet address your mail router may not be configured to relay mail. Ask your  network administrator to verify that your mail router can relay mail to an external Internet e-mail address (e.g.  yourphonenumber@yourpagingservice.com).

The instructions in step 6 configure your System i SMTP client to send all e-mail to your local mail router. There is an alternate way of configuring your System i SMTP server to perform name resolution (using a DNS server) in place of using your local mail router. If you experience trouble sending e-mail (from the System i) to an external domain after you complete the configuration (on this page) try using this simple SMTP configuration change to allow the System i to perform the name resolution. "Click here to "Configure your System i SMTP client to use your DNS server”. Once you complete these instructions return here and continue with step 19 to send another test message.

If you have trouble receiving pager messages and you feel you have completed the steps above successfully, call our SupportLine at 866-559-0800 option 2 or send e-mail to support@ddlsystems.com.

21.You have completed the setup and testing of your modem hardware. Now, continue with step B. Monitoring the QSYSOPR Message Queue.

The Internet e-mail address parameter should contain the Internet paging address of your service provider (e.g your 10 digit phone number@yourserviceprovider.com).

The Internet e-mail address parameter should contain your local Internet e-mail address (e.g yourname@yourcompany.com).