|
Configuring iSeries E-mail |
 |
|
Use these instructions to
configure your iSeries (or AS/400) system to send e-mail messages to the Internet. Your iSeries
does not have to be the mail server; you will be able to specify the mail
servers IP address during setup. The iSeries 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 like Notes, Eudora, GroupWise,
or Outlook. |
 |
|
Prior to performing the instructions below you should
gather the following information about your system, network typology,
and messaging device(s): |
 |
|
1. The current
password to the ACO user profile.
The default value is ACO. |
 |
|
2. The instructions
below concern only the configuration of SMTP services. You should
have previously configured TCP/IP on your iSeries (or AS/400) system.
If you have not done so, follow the instructions documented in the IBM
reference materials (listed on the last page of this document) to
configure your iSeries (or AS/400) to use TCP/IP services. |
 |
|
3.
The internal IP address of your companys mail server.
The instructions below require adding your companys mail server name
and IP address to your iSeries (or AS/400) TCP/IP host table. You will
need to enter the mail servers internal IP address. Ask your
system administrator for this information. |
 |
|
4. Your service
provider must support text messaging. Some service providers also
require that you enroll your phone, pda, or pager in their text
messaging service; even though this service is provided as part of your
basic rate plan. Please verify that your device is properly configured
with your service providers text messaging service. Please contact your
service provider for details. |
 |
|
If you have questions
regarding the above prerequisites (or the instructions below) please
call our SupportLine at
(866) 559-0800 option 2 or send e-mail to
support@ddlsystems.com. We will be glad to help you! |
 |
 |
| Please perform the following steps
to configure your system to use SMTP: |
 |
| 1.
Sign-on the iSeries (or
AS/400) with the ACO user profile. |
 |
| 2. Enter the command below and press
F4 to prompt. |
 |
| CHGDSTA then press <F4> |
 |
|
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. |
 |
| 3. Enter the command below to view the TCP/IP host
table entries. |
 |
| CFGTCP then <Enter> |
 |
|
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 its 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 iSeries (or AS/400s)
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 servers internal IP address. Ask your system administrator for
this information if you are not sure of the internal IP address of your
mail server. |
 |
| 4. Select option 12 (Change TCP/IP domain
information) and verify that the "Host name search priority" parameter is set to
*LOCAL. If not, change it to *LOCAL. |
 |
|
5. Enter the command below to verify that the
connection to your mail server is working properly. |
 |
| PING RMTSYS(MAILSERVER)
then press <Enter> |
 |
|
The system should respond with the following
message: Connection verification statistics: 5 of 5 successful (100%). |
 |
| 6. Enter the command below to set the SMTP
attributes of your iSeries. |
 |
| CHGSMTPA AUTOSTART(*YES) MAILROUTER(MAILSERVER)
FIREWALL(*YES) |
 |
|
To enable an iSeries 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 iSeries
mail services will use to route mail (within this system and/or the SNADS network to the
SMTP/MIME gateway) that have an internet address as recipients: |
 |
ADDDIRE USRID(INTERNET
GATEWAY) |
|
USRD('Gateway to the Internet') |
|
SYSNAME(INTERNET) MSFSRVLVL(*USRIDX) |
|
PREFADR(NETUSRID *IBM ATCONTXT) |
 |
|
8. Enter the command below to set the system
distribution services attributes of your iSeries. |
 |
| CHGDSTA SMTPRTE(INTERNET GATEWAY), then
press <Enter> |
 |
|
If you are running
Domino R5/R6 on your iSeries (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 iSeries 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. |
 |
| ENDTCPSVR SERVER(*SMTP), then press
<Enter> |
 |
| ENDMSF, then press <Enter> |
 |
|
10.Enter the command below to start
the OS/400 SMTP server and the mail server framework jobs. |
 |
| STRTCPSVR SERVER(*SMTP), then press
<Enter> |
 |
| STRMSF, then press <Enter> |
 |
| 11.Enter the command below to display the QSYSWRK
subsystem. |
 |
| WRKACTJOB SBS(QSYSWRK), then press
<Enter> |
 |
| In the display that results from the above
command, verify that there are: |
 |
| 3 jobs named QMSF running |
| A job named QTSMTPBRCL running |
| A job named QTSMTPBRSR running |
| A job named QTSMTPCLTD running |
| A job named QTSMTPSRVD running |
 |
|
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 |
 |
|
12.Verify that a
system distribution directory entry exists for the ACO user
profile by entering the following command: |
 |
| WRKDIRE,
then press <Enter> |
 |
|
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. |
 |
| ADDDIRE
USRID(ACO system name) USRD('ACO PAGER Message Alert
System SMTP User') USER(ACO) |
 |
|
13.Add a valid SMTP
name to the ACO user profile by entering the following command: |
 |
| WRKNAMSMTP
TBLTYPE(*SYSTEM), then press <Enter> |
 |
|
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 iSeries system name in the
address
field and press <Enter>. |
 |
 |
 |
|
Enter your system name in the "Address"
parameter on the prompt line above. |
 |
|
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: |
 |
| SNDDST TYPE(*LMSG) TOINTNET((your
e-mail address)) |
|
DSTD('SMTP test message') |
|
LONGMSG('Test message from the iSeries') |
 |
|
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 iSeries is
communicating with your mail router; continue with step 16. |
 |
|
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. |
 |
 |
| Testing the
Installation (Approximately 5 minutes) |
 |
| Verify your software and hardware installation
by proceeding with the steps below. |
 |
| A. Send an Impromptu Message |
 |
|
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. |
 |
| 20.Press <F3> twice to
return to the main menu. |
 |
|
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
iSeries SMTP client to send all e-mail to your local mail router. There
is an alternate way of configuring your iSeries 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 iSeries) to an external
domain after you complete the configuration (on this page) try using this simple SMTP
configuration change to allow the iSeries to perform the name resolution.
"Click here to "Configure your iSeries 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. |
 |
| If your paging
service supports e-mail paging: |
 |
|
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). |
 |
| If you are
sending the message to a MIME compatible e-mail client: |
 |
|
The Internet
e-mail address parameter should contain your local Internet e-mail
address (e.g yourname@yourcompany.com). |
 |
 |
|
Service Provider Information |
 |
|
Service |
E-mail address |
| Air Touch Paging |
10digitpagernumber@airtouch.net |
| Arch Paging |
10digitpagernumber@archwireless.net |
| AT&T |
10digitphonenumber@mobile.att.net |
|
Cellular One |
10digitphonenumber@mobile.celloneusa.com |
|
Cingular Wireless |
10digitphonenumber@mobile.mycingular.net |
|
GTE |
10digitphonenumber@messagealert.com |
|
MCI |
yourphonenumber@mci.com |
|
MetroCalI |
10digitpagernumber@page.metrocall.com |
| Nextel |
10digitphonenumber@messaging.nextel.com |
|
PageMart |
10digitpagernumber@airmessage.net |
|
Skytel |
7digitpinnumber@skytel.com |
| Sprint PCS |
10digitphonenumber@messaging.sprintpcs.com |
|
T-Mobile |
10digitphonenumber@tmomail.net |
|
US Cellular |
10digitphonenumber@uscc.textmsg.com |
| Verizon Wireless |
yourphonenumber@vtext.com |
|
Weblink Wireless |
pagernumber@airmessage.net |
 |
 |
|
Return to *DFT pager definition |
 |
 |
| IBM Technical Reference
Publications |
 |
| Use the reference information below
if you have problems or need to configure other TCP/IP services. |
 |
"TCP/IP FastPath Setup" (Softcopy
Book QB3A0K00, Document Number SC41-5430 for Version 4, and SC41-3430 for Version 3). |
 |
"OS/400 TCP/IP Configuration and
Reference" (Softcopy Book QB3ANL01, Document Number SC41-5420 for Version 4, and
SC41-3420 for Version 3). |
 |
IBM Redbook "iSeries Electronic-Mail
Capabilities" (Document Number SG24-4703-00) |
 |
IBM Redbook "Lotus
Domino for AS/400 Internet Mail and More" Chapter 5 (Document Number
SG24-5990-00). |
 |
Configuring
iSeries Dual Stack Support for SMTP |
 |
Configure
your iSeries SMTP client to use your DNS server |
 |
| These IBM books can be read from the
Softcopy CD-ROM or read directly from the web at http://as400bks.rochester.ibm.com |
 |
 |
|
Hardware Requirements |
Requires one standard iSeries V.24 SDLC communications line and one ECS (or
Hayes® compatible) modem (or a properly configured SMTP e-mail connection to the
Internet). Works with all alphanumeric and two-way pagers, properly equipped
cellular phones, smartphones, pda's, palmtops, and all numeric pagers. |
 |
|
Software Requirements |
|
ACO PAGER, ACO NET, ACO ESI,
and ACO CLIENT execute on iSeries® systems (all models) running OS/400 Version 5 Release
2 (or higher). ACO Client™ requires WebSphere® Application Server v5.0 (or higher), WebSphere® Application Server - Express,
or any Java 1.3 compliant web application server like Apache. ACO ESI™
requires an enterprise system application like IBM Tivoli® or BMC Patrol Enterprise
Manager®. Your Enterprise System may require the use of WebSphere®
MQ middleware (V5.1 or higher). This software is available from IBM at an additional fee and is
not
included in the purchase of the ACO ESI software product. ACO ESI™
optionally monitors your network connected Windows servers using a Windows
compliant software agent. This software is available (at a nominal fee) from
one of our business partners. |
|
 |
 |
 |
Contact a sales representative at
(866) 559-0800 option 1 or send
e-mail to
sales@ddlsystems.com for more information. |
|
 |
 |
|
 |
 |