SAPconnect Configuration for E-Mail/Fax/SMS

Applies to:
As of SAP Web Application Server 6.10, the SAP system's kernel supports SMTP (Simple Mail Transfer Protocol) directly and as of SAP Web Application Server 6.20, faxes and text messages (pager/SMS) can also be exchanged via SMTP.

Summary
Useful to any customer to enable E-Mail/FAX/SMS exchange between the SAP system and each SMTP mail server, without having to use additional external components. Author(s): Kishore Kumar Tenkayala Company: SAP Global Delivery Created on: 18th November 2009

Author Bio
Kishore Kumar is an SAP® Certified NetWeaver Technology Consultant. He is having 2 years of experience in overseas customer upgrade consulting, Implementations, Unicode conversions (Complex MDMP to Unicode conversions), and OS/DB migrations.

SAP DEVELOPER NETWORK | KM.sap.com © 2008 SAP AG

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com 1

SAPconnect Configuration for

E-Mail/Fax/SMS

Table of Contents
1. SAPconnect Configuration: ………………………………………………………………………………………..…3 1.1 Introduction: .……………….……..………………………………………………………………………………3 1.2 Prerequisites for EMAIL/ Fax/SMS Setup: ……………...……………………………………………………….4 1.3 E-MAIL/FAX/SMS Configuration: ….……………………………………..……………………………………..4 i. ii. iii. iv. v. vi. vii. viii. ix. x. xi. Server Details (Incoming and Outgoing Mail): ……………………………………….………..4 User Maintenance(only for Incoming Mail): ………………………………………….……….4 Altering/Adding Parameters(Incoming and Outgoing Mail): ………….……………………..7 SMTP Activation(Incoming and Outgoing Mail): ………………….……………………..…..10 Client Assignment(only for Incoming Mail): ………………..…….......................................11 SCOT Configuration(Incoming and Outgoing Mail): …………………………………...……15 Scheduling Background Job(Incoming and Outgoing Mail): ……………………………..…22 Post Activities(Incoming and Outgoing Mail): ……………………………………………….24 Addressing Mail/Fax/SMS(Incoming and Outgoing Mail): ………………………………….25 Testing and Verification(Incoming and Outgoing Mail): …………………………...……….26 Troubleshooting and Error Analysis(Incoming and Outgoing Mail): …..…………………..28

2.Related Content………………………………………………………………………………………………………30 3.Copyright................................................................................................................................................. 31

SAPGD Knowledge Management | KM.sap.com © 2008 SAP AG

TECHNOLOGY – NetWeaver KM Assets| 2

SAPconnect Configuration for

E-Mail/Fax/SMS

SAPconnect Configuration
1.1 Introduction:
The SAP Internet Mail Gateway is a component that connects the R/3 mail system to the Internet. Internet Mail Gateway enables R/3 Users or R/3 applications to send electronic messages to Internet addresses or to receive them in the R/3 System. The connection is made using the standard protocol used in the Internet, SMTP (Simple Mail Transport Protocol).

The following diagram is an overview of how IMG integrates SAP mail to the Internet:

R/3 System SAPconnect
RFC

SAP Internet Mail Gateway

The connection is made by Remote Function Call (RFC) to the R/3 communication interface SAPconnect. As a result, the SAP Internet Mail Gateway enables message to be sent from the Business Workplace and directly from R/3 applications. SAP Connect configuration is Client Dependent. Therefore, it has to be configured in each client of the SAP system.

SAPGD Knowledge Management | KM.sap.com © 2008 SAP AG

TECHNOLOGY – NetWeaver KM Assets| 3

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). User addresses Every user that is to receive e-mails in an SAP system requires an Internet mail address. Verify that all the required SAP hostnames and Firewall hostname included in Mail Server and DNS server.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 4 . User Maintenance: Create a user (Eg: SMTPUSER) for processing incoming mails in every SAP system client. Enter the Internet mail address for a user in transaction SU01. 1. under E-Mail on the tab page Address. Server Details: SAP Host Name SAP System ID Clients E-Mail Host Name Mail Port Firewall IP for Saprouter ii.sap.SCON to this user. User contained in the roles SAP_BC_SRV_COM_ADMIN and SAP_BC_SRV_GBT_ADMIN. Step-1: Login into SAP System and use transaction SU01 as below in SAP Screen command bar: : <SAP Hostname> : <system ID> : <Client Numbers> : <Mail Server Hostname> : 25 : <Public IP> SAPGD Knowledge Management | KM. This is also used as a sender address.3 E-MAIL Configuration: i.2 Prerequisites for E-mail Setup: The mail servers involved must be SMTP-compliant. Call transaction SU01 to create a user with type Service and assign the profile S_A. SAP Connect needs to be authorized to use the SMTP server and Fax Server to send mails.SAPconnect Configuration for E-Mail/Fax/SMS 1.

SAPconnect Configuration for E-Mail/Fax/SMS Step-2: After entering the transaction code in command bar then choose enter and You can see a below screen: Step-3: Enter Username (SMTPUSER) and choose Create button Step-4: Enter at least one field in Address tab to move to another tab: SAPGD Knowledge Management | KM.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 5 .sap.

com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 6 .sap.SAPconnect Configuration for E-Mail/Fax/SMS Step-5: Choose User type as “Service” and enter the desired Password (I gave initial123 in all the clients) and confirm the password in Logon data tab: Step-6: Move directly to Roles tab and enter Role names to the user: SAPGD Knowledge Management | KM.

<port> specifies the number of the port that you should use. This defines a "virtual mail host" for receiving mails. To be able to use the SMTP functions. b) is/SMTP/virt_host_<*> = <host>:< port>.PORT=<port> This opens a TCP/IP port for receiving mails by the SMTP Plug-In. Sendmail usually uses port 25).com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 7 .. you must adjust the profile of the SAP Web Application Server. Altering/Adding Parameters: in the command bar. We recommend that you activate SMTP on all application servers of an SAP system. This must not be occupied by any other program on this host (for example. For SMTP.<port>. choose save button iii... The placeholder <*> stands for a number with which the parameters that can occur several times are numbered sequentially.sap. SAPGD Knowledge Management | KM. <port> can be set to 0. this parameter is not required (an entry is/SMTP/virt_host_0 = *:* is then assumed by default). starting with 0. If no mails (including status notifications) are to be received in this SAP system.. you must set the profile parameters listed below.SAPconnect Configuration for E-Mail/Fax/SMS Step-7: Choose profiles tab and enter the profile name to the user: Step-8: After adding the profile. Profile Parameters to be added: a) icm/server_port_<*> = PROT=SMTP. If all incoming mails (including status notifications) are to be received and processed in a single client of this SAP system. You can use the TIMEOUT option to define a maximum wait time for a response from the mail server (in seconds).

PORT=25000.TIMEOUT=180 is/SMTP/virt_host_0 = *:25000. Step-2: After selecting the Instance profile.SAPconnect Configuration for E-Mail/Fax/SMS If you want several clients to be able to receive. is/SMTP/virt_host_1 = *:25001. The "*" value can also be specified here if the mail distribution is to occur independently of the addressed host. you can see below screen: SAPGD Knowledge Management | KM. NOTE: The parameter line must always be ended with a semicolon (even if only one host is involved). choose Extended Maintenance and select Change button.sap. <host> specifies the name of the host to which incoming mails are addressed. Use F4 key always to select profile as it creates new version every time.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 8 .PORT=25001.TIMEOUT=180 icm/server_port_2 = PROT=SMTP. the profile parameters could read as follows: icm/server_port_1 = PROT=SMTP. Example: With two clients capable of receiving mail. you must create a virtual mail host for every client. Updating SAP Parameters: Step-1: Use Transaction Rz10 to update the parameters in the profiles.

After saving the entries do restarting SAP Application to effect the changes. If you want to add a parameter choose button and enter the parameter name and value as below: Then choose button to save the entries and then go back from the screen and choose save button.SAPconnect Configuration for E-Mail/Fax/SMS Step-3: To change the parameter which is already available.sap. you can change directly and press the save button. SAPGD Knowledge Management | KM.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 9 .

SMTP Activation: After restarting SAP system.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 10 .SAPconnect Configuration for E-Mail/Fax/SMS iv.sap. check whether SMTP service is activated or not using SMICM transaction: Step-1: Go to transaction SMICM Step-2: Choose Goto->services to check the services Step-3: If SMTP service is not active then choose service->Activate SAPGD Knowledge Management | KM.

com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 11 . You use this one for the first client then create an additional SMTP server for each additional client.SAPconnect Configuration for E-Mail/Fax/SMS v. Client Assignment: Each SAP system client in which inbound mails (or status notifications) are to be received and processed must have an SMTP server.sap. In transaction SICF. there should be one SMTP server (called SAPconnect) supplied in every SAP system. Step-1: Use transaction Sicf Step-2: Choose execute button in the above screen: SAPGD Knowledge Management | KM. If you have only one client in SAP System you do not need to perform any client assignment as there should be one SMTP server supplied in every SAP system. Just mention the client information in Logon data tab.

Step-4: Enter a Description and provide as below in ‘Host Data’ tab: Host data You enter the sequence number of a parameter is/SMTP/virt_host_<*> from the profile. SAPGD Knowledge Management | KM.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 12 .sap. If you only have one client and therefore did not enter a parameter of this kind. you enter 0. Choose to continue to another screen.SAPconnect Configuration for E-Mail/Fax/SMS Step-3: Choose button to create a Host for another client and enter the Name of the Virtual Host with selecting SMTP server as server type.

SAPGD Knowledge Management | KM.SAPconnect Configuration for E-Mail/Fax/SMS Step-5: Move to ‘Logon Data’ tab: Logon data You enter the client to which the mails received via this virtual mail host are to be forwarded. as well as the logon data of the system user created for inbound mails. Step-6: Move to ‘Handler list’ tab: Handler list You enter CL_SMTP_EXT_SAPCONNECT as item 1.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 13 .sap.

com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 14 .SAPconnect Configuration for E-Mail/Fax/SMS Step-7: Choose Save button and save it as Local object: Step-8: Go back to the main screen and choose Activate button as below: SAPGD Knowledge Management | KM.sap.

SAPGD Knowledge Management | KM. Vi. SCOT Configuration (SAP Connect Administration): You must make the SAPconnect settings in each client that is to be used to send communications. it will activate all sub-services if any. ii. iii.sap. Step-1: Use transaction SCOT to get the below screen: Step-2: Each client has an SMTP node.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 15 . The following steps need to be carried out to configure the node so that sending Internet mail is possible: i. Double-click the node name. Make sure you are in the Node view. Use transaction SCOT for doing this. This node is created by the SAP system and cannot be deleted.SAPconnect Configuration for E-Mail/Fax/SMS Step-8: Then select ‘Yes’ button as below. Choose Node in use.

Next to Internet. choose the button ‘Set’. In the Mail Host and Mail Port fields.sap.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 16 . specify the mail server to which the outbound mails are to be sent. v.SAPconnect Configuration for E-Mail/Fax/SMS iv. you can see below screen SAPGD Knowledge Management | KM.

com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 17 . ii. PDF HTM HTM TXT button. * is used if all e-mails are to be sent using SMTP.sap. Make sure you are in the Node view. choose the button ‘Set’. vii. For FAX: The following steps need to be carried out to configure the node so that sending FAX is possible: i. Confirm your selection with v. In general. Enter the output format for SAP documents. Enter the address area of the recipient addresses that are to be reached using this node. Double-click the node name. you can see below screen SAPGD Knowledge Management | KM. We recommend that you use the following settings: SAPscript/Smart Forms ABAP list Business Object / Link RAW Text viii.SAPconnect Configuration for E-Mail/Fax/SMS vi. Next to FAX.

SAPGD Knowledge Management | KM. In general.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 18 . * is used if all faxes are to be sent using SMTP.sap. Enter the address area of the recipient addresses that are to be reached using this node.SAPconnect Configuration for E-Mail/Fax/SMS vi.

PDF HTM HTM TXT button. Make sure you are in the Node view. ii. We recommend that you use the following settings: SAPscript/Smart Forms ABAP list Business Object / Link RAW Text ix. Confirm your selection with SAPGD Knowledge Management | KM. For SMS: The following steps need to be carried out to configure the node so that sending SMS is possible: i.sap.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 19 . Enter the output format for SAP documents. Double-click the node name.SAPconnect Configuration for E-Mail/Fax/SMS vii.

sap.SAPconnect Configuration for E-Mail/Fax/SMS iii. you can see below screen SAPGD Knowledge Management | KM. choose the button ‘Set’.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 20 . Next to Pager(SMS).

Enter the output format for SAP documents. names must be defined for the messaging services to be used (e. We recommend that you use the following settings: SAPscript/Smart Forms ABAP list Business Object / Link RAW Text x. Confirm your selection with PDF HTM HTM TXT button. The message ID of the outbound e-mails is assembled with this domain. NOTE: To be able to use paging or SMS in the SAP system.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 21 .g. a sender address consisting of the SAP user name and this domain is generated. SAPGD Knowledge Management | KM.SAPconnect Configuration for E-Mail/Fax/SMS v. v. If an SAP user who does not have an Internet mail address sends an e-mail. The local part of the Internet address is generated automatically by the system. For "Conversion into Internet Address". enter the domain of the paging or SMS server or paging or SMS provider. "SMS"). You can do this using transaction SA14.sap. Step-3: Define the domain of the SAP system client. The address then has the form "SMS=+recipientnumber@domain". This allows for the following to take place: The SMTP plug-in logs on to the mail server using the domain as ID. Enter address areas of recipient addresses that are to be reached using these nodes (usually "*" if all paging or SMS messages are to be sent using SMTP).

SAPconnect Configuration for E-Mail/Fax/SMS Use Settings->Default Domain option in the transaction SCOT to enter the domain name as below: vii. You can see below screen Step-2: Choose Job->create or create button and specify a job name and choose button. Step-3: Place the cursor on the "SAP&CONNECTALL" variant. Scheduling Background Job: E-mails that are sent from an SAP application are merely put into a queue. A periodically running background process. the SAPconnect send job. This job can be scheduled from SAPconnect administration as below: Step-1: Choose View-> Jobs in SCOT transaction.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 22 .sap. takes the e-mails from the queue and sends them by Internet. and choose "Schedule Job" as below: SAPGD Knowledge Management | KM.

com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 23 .sap.SAPconnect Configuration for E-Mail/Fax/SMS Step-4: Then Choose "Schedule periodically" in next window: Step-5: Select periodicity as 10 minutes or 5 minutes and choose button: SAPGD Knowledge Management | KM.

please change the below option in SCOT transaction as below: Choose Settings-> Confirmation of receipt and in the below screen select “SAP Connect does not expect receipt confirm for Internal mail.sap.SAPconnect Configuration for E-Mail/Fax/SMS Note: If you want. Post Activities: 1.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 24 . And then choose button. Step-6: After this you can see the below screen in SCOT view->job menu displayed as a calendar icon: Viii. SAPGD Knowledge Management | KM. If you do not want to receive any receipt confirmation from internal mail. you can go to Sm36 and select this job with option immediate as well to start the job immediately besides periodicity.

Addressing Mail: Internet addresses have the following technical form: <Username>@<computername> The <Username> is the local Users where the <computername> is the domain. you can configure this under Settings Inbound Processing in SCOT transaction. 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.SAPconnect Configuration for E-Mail/Fax/SMS 2.com SAPGD Knowledge Management | KM. This option is useful for Incoming Mail setup. Choose create button and enter as below with the help of F4 keys: ix.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 25 . For example: firstname.lastname@company.sap.

com as the mail exchange for the address company. SAPGD Knowledge Management | KM. To correspond with others you must specify the host systemname. For example SID: 000: kishore. Step-1: Use transaction and SBWP and choose New Message or outbox->Documents->create to send a mail to any address: {Or} Choose directly transaction So00 to create a message. For example. where <Country> is an abbreviation for the international dialing code. SAP user in another system <System name> :< Client> :< User name>. X.com in the Domain Name System (DNS). Testing and Verification: You can test the configuration using the SAP Business Workplace.SAPconnect Configuration for E-Mail/Fax/SMS Addressing FAX: Fax addresses have the following technical form: <Country><Number>.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 26 . DE 06227/34-1704 Addressing Pager (SMS): Pager addresses have the following technical form: Pager/SMS number <Pager service> :< Number> For example SMS: +491704456734 Addressing SAP system: Addressing from one SAP system to another SAP system in the same host.company. The SAP Transaction to access your mailbox is SBWP.sap.

com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 27 . And choose send button to send the mail. body and enter the e-mail address in the below. Specify the Subject.sap.SAPconnect Configuration for E-Mail/Fax/SMS Step-2: Create a message as below. SAPGD Knowledge Management | KM.

SAPGD Knowledge Management | KM.sap.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 28 . Use transaction SOST to check the error description and status of mails sent. Troubleshooting and Error Analysis: Before analyzing any email or fax problem please make sure the Users are addressing the email or fax correctly 1. Select button to get the description of the status.SAPconnect Configuration for E-Mail/Fax/SMS Verification: Choose Refresh button in SBWP transaction to verify whether mail has been sent or not: You can see below screen with status symbol: Xi.

that is. that is. Analyze in SCOT transaction. In transit Number of send orders that are currently in process outside of the R/3 System. Duration waiting) refer to the average processing times (in hours and minutes) for the respective send orders. ERROR Number of send orders that were not successfully completed. The processing time period is defined by the following events: SAPGD Knowledge Management | KM. the messages has been transferred to the external nodes by the SAPconnect send process but neither a positive nor a negative status message has been received.sap. check the below meanings: Completed Number of successfully completed send orders.SAPconnect Configuration for E-Mail/Fax/SMS 2.) The values in the last two columns (Duration in transit. that is. the messages were sent to the recipients. Waiting Number of send orders that are currently still within the R/3 System. that is. the messages could not be sent to the recipients. therefore only the values for the higher-level scheduled lines 'Address type' and 'System/Client' are displayed. the messages have not yet been registered by the SAPconnect send process.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 29 . (Waiting send orders are not yet assigned to a node.

pdf Note 607108 . Check that the background job is running correctly in SM37 The job should be called SAP_SEND_MAIL_<Client Number>. correct the problem and reschedule. Make sure it is periodically running successfully.sap. If not. 3.Configuration of e-mail.pdf SAPGD Knowledge Management | KM. usually every 10 or 5 minutes.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 30 . Duration waiting Time from the creation of the send order by an R/3 application to the transfer of the message to the external node by the SAPconnect send process. fax.SAPconnect Configuration for E-Mail/Fax/SMS Duration in transit Time from the transfer of the message to the external node to the receipt of the first status message reporting the delivery or non-delivery. Related Content Please find the below information for your reference Note 455140 .pdf 12753028-Scot-Configuration-Troubleshooting.Problem analysis when sending or receiving e-mails. paging or SMS using SMTP.

POWER5+. and Motif are registered trademarks of the Open Group. The Code is only intended better explain and visualize the syntax and phrasing rules of certain coding. Inc. Inc.sap. System z. Netfinity. WebSphere. HTML. links or other items contained within these materials. AS/400. OS/2. iSeries. and Reader are either trademarks or registered trademarks of Adobe Systems Incorporated in the United States and/or other countries. SAP does not warrant the correctness and completeness of the Code given herein. graphics. Oracle is a registered trademark of Oracle Corporation. OS/400. World Wide Web Consortium. UNIX. fitness for a particular purpose. OSF/1. All rights reserved. These materials are provided “as is” without a warranty of any kind. AFP.com © 2008 SAP AG TECHNOLOGY – NetWeaver KM Assets| 31 . Java is a registered trademark of Sun Microsystems. AIX. either express or implied. SAP shall not be liable for damages of any kind including without limitation direct. SAP does not warrant the accuracy or completeness of the information. SAP. Citrix.SAPconnect Configuration for E-Mail/Fax/SMS Copyright © 2008 SAP AG. Any software coding and/or code lines/strings (“Code”) included in this documentation are only examples and are not intended to be used in a productive system environment. WinFrame. OpenPower and PowerPC are trademarks or registered trademarks of IBM Corporation. Program Neighborhood. used under license for technology invented and implemented by Netscape. System z9. mySAP. or consequential damages that may result from the use of these materials. Parallel Sysplex. without representation or warranty of any kind. and PowerPoint are registered trademarks of Microsoft Corporation. and MultiWin are trademarks or registered trademarks of Citrix Systems. Adobe. Tivoli. MaxDB is a trademark of MySQL AB. All other product and service names mentioned are the trademarks of their respective companies. including but not limited to. and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. special. No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. These materials are provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only. System i. XHTML and W3C are trademarks or registered trademarks of W3C®. SAPGD Knowledge Management | KM. the implied warranties of merchantability. System x. System i5. if any. zSeries. and SAP shall not be liable for errors or damages caused by the usage of the Code. MVS/ESA. the Adobe logo. Microsoft. except if such damages were caused by SAP intentionally or grossly negligent. xSeries. PostScript. or non-infringement. mySAP. SAP has no control over the information that you may access through the use of hot links contained in these materials and does not endorse your use of third party web pages nor provide any warranty whatsoever relating to third party web pages. Sweden. Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors. and SAP Group shall not be liable for errors or omissions with respect to the materials. S/390. Windows. POWER5. pSeries. xApps. SAP NetWeaver. z/OS. System p. Inc. Acrobat. OS/390. The information contained herein may be changed without prior notice. IBM. National product specifications may vary. DB2 Universal Database. VideoFrame. i5/OS. xApp. Massachusetts Institute of Technology. POWER. DB2. indirect. Intelligent Miner. Outlook. System p5. XML. R/3. These materials are subject to change without notice. The only warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying such products and services. Data contained in this document serves informational purposes only.. Informix. JavaScript is a registered trademark of Sun Microsystems. ICA. text. Nothing herein should be construed as constituting an additional warranty. X/Open.com. MetaFrame.

Sign up to vote on this title
UsefulNot useful