Quick Guide to SMTP Configuration

Use

The kernel of the SAP Web Application Server supports SMTP (Simple Mail Transfer Protocol). This

enables e-mail exchange between the SAP system and each SMTP mail server, without having to use

additional external components. The SAP system sends the outbound e-mails to a separate mail server,

whilst the e-mails in the inbound direction can be received by any number of mail servers.

Exchanging faxes and text messages (pager/SMS) using SMTP is also possible. For this, faxes and

messages are packed as e-mails. For the send process, the mail server analyzes the domain of the

recipient addresses and either forwards the e-mails to an internal fax-/text message server (for
example [email protected] ) or to an external provider

(for example [email protected] ). For receiving, the fax-/text

message server or provider sends e-mails to addresses that have the domain of the SAP system (for
example [email protected] ).

Prerequisites

The mail server in question must be SMTP-compatible.

If you want to send text messages in the SAP system, the names of the corresponding data transfer

services (such as SMS) have to be defined in transaction SA14 .

Process

Settings for the Profile Parameters (Transaction RZ10)

You have to adjust the profile of the SAP Web Application Server if you want to use the SMTP function.

The SAPconnect send job can only be scheduled for servers on which SMTP has been activated. For this

reason, you must activate SMTP for all of the SAP system's application servers.

The following profile parameters have to be configured. The placeholder <*> stands for the sequence
number (starting at zero) of frequently occurring parameters.

 icm/server_port_<*> = PROT=SMTP,PORT=<port>
Parameter icm/server_port_<*> opens a TCP/IP port for receiving mails through the SMTP plug-
in. <port> describes the number of the port that is to be used. The port cannot yet be used by
 another program on this host. If no mails are to be received in this SAP system (including
notifications about the status), set < port > to 0 .

Optionally, you can use TIMEOUT to define a maximum waiting time (in seconds) to be applied

until the mail server responds.

 is/SMTP/virt_host_<*> = <host>:<port>,<port>,...;
This parameter defines a Virtual Host for receiving mails. If all incoming mails (including status

notifications) are to be received and processed by one single client of the SAP system, this
parameter is not required. In this instance, is/SMTP/virt_host_0 = *:*; is used by
default. If multiple clients are to be used as recipients, a virtual host has to be created for each of
these clients. <host> describes the name of the host to which the incoming mails are

addressed. You can enter * here if the mails are to be sent independently of the host being
addressed. <port> describes the number of the port to which the incoming mails are

addressed.

Example

For UNIX, the profile parameters may look like this:

rdisp/start_icman = true

icm/server_port_0 = PROT=HTTP,PORT=1080

icm/server_port_1 = PROT=HTTPS,PORT=1443

icm/server_port_2 = PROT=SMTP,PORT=25000,TIMEOUT=180

icm/server_port_3 = PROT=SMTP,PORT=25001,TIMEOUT=180

is/SMTP/virt_host_0 = *:25000;

is/SMTP/virt_host_1 = *:25001;

For more information, see Profiles .

User Maintenance (transaction SU01)

 Service user
 You have to create a service user for processing incoming mails in every SAP system client in

which you want to receive mails (or status notifications). Call transaction SU01 to create a user
with type Service and assign the profile S_A.SCON to this user.

 User addresses

Every user that is to receive e-mails in an SAP system requires an Internet mail address. This is

also used as a sender address. Enter the Internet mail address for a user in transaction SU01,

under E-Mail on the tab page Address .

Assigning the Client (Transaction SICF)

Every SAP system client that is to receive and process incoming mails (or status notifications) must have

an SMTP server. One SMTP server ( SAPconnect ) has already been created in transaction SICF and is

delivered with every SAP system. Use this to create the first client and then create another SMTP server

for each additional client. Configure the following settings on the SMTP servers:

 Host data
Enter the sequence number of a parameter is/SMTP/virt_host_<*> from the profile. If

you have only created one client and therefore have not specified this parameter type, enter 0.
 Service data

Enter the client to which the mails received through the virtual mail host are to be forwarded, and

then enter the logon data of the system user that you created for the incoming mails.

 Handler list
Enter CL_SMTP_EXT_SAPCONNECT at position 1.

Note

As of SAP Web AS 6.20, each SMTP server has to be activated ( Service/Virt. Host

Activate ) after being created or changed. Inactive servers are grayed out.

SAPconnect Administration (Transaction SCOT)

You have to configure SAPconnect settings for every client that is used for send processes.

 Default domain

Under Settings Default Domain , define the domain of the SAP system client. This allows

for the following to take place:

· The SMTP plug-in logs on to the mail server using the domain as ID.
 · The message ID of the outbound e-mails is assembled with this domain.

· If an SAP user who does not have an Internet mail address sends an e-mail, a sender address

consisting of the SAP user name and this domain is generated.

 Node

You can create one or multiple SMTP nodes to contact different mail/fax/SMS servers, for

example.

The following steps need to be carried out to configure an SMTP node so that sending Internet

mail is possible:

1. Double-click the node name.

2. Choose Node in Use

3. In the Mail Host and Mail Port fields, specify the mail server to which the outbound mails are

to be sent.

4. Next to Internet , choose Settings .

5. Enter the address area of the recipient addresses that are to be reached using this node. In
general, * is used if all E-Mails are to be sent using SMTP.

6. Enter the output format for SAP documents. We recommend that you use the following

settings:

SAPscript/Smart Portable Document Format (PDF)

Forms

ABAP List HTM

Business Object / HTM
Link

RAW Text TXT

7. Confirm the selection.

If you also want to configure the node for sending faxes:

8. Next to Fax , choose Settings .

9. Enter the address area of the recipient addresses that are to be reached using this node. In
general, * is used if all faxes are to be sent using SMTP.

10. Enter the output format for SAP documents. We recommend that you use the following

settings:

SAPscript/Smart Portable Document Format (PDF)

Forms

ABAP List Portable Document Format (PDF)

Business Object / TXT
 Link

RAW Text TXT

11. Enter the domain of the fax server or fax provider under Conversion into Internet Address .

The system generates the local part of the Internet address automatically. The address then
has the format FAX=+RecipientNumber@Domain .

12. Confirm the selection.

If you also want to configure the node for sending text messages (pager/SMS):

13. Next to Pager (SMS) , choose Settings .

14. Enter the address area of the recipient addresses that are to be reached using this node. In
general, * is used if all text messages (pager/SMS) are to be sent using SMTP.

15. Enter the domain of the text message (pager/SMS) server or provider under Conversion into

Internet Address . The system generates the local part of the Internet address automatically.
The address therefore takes this format: SMS=+RecipientNumber@Domain .

16. Confirm the selection.

 Send Job

E-Mails sent from an SAP application are first stored in a queue. A periodical background process,

the SAPconnect send job, gets the E-Mails from this queue and sends them over the Internet. To

schedule this job in SAPconnect: Administration , proceed as follows:

1. If no other job has been scheduled, choose Settings Send Jobs .

2. Using the Create pushbutton, select the send type for which you want to create a job.

3. Enter a name for the job.

4. Select the required time period for the periodic repetition, for example, 10 minutes.
5. Choose Continue .

6. Choose Save .

 Inbound Channel

If you want incoming e-mails that have a particular address or particular content to automatically

start a program that processes these mails, you can configure this under Settings Inbound

Processing .

If you want incoming E-Mails that have a particular address or come from a particular sender to be

automatically forwarded to another recipient or another distribution list, you can configure this

under Settings Inbound Processing .