You are on page 1of 5

SAP Note

Header Data
Symptom
How do you conf i gur e e- mai l , f ax, pagi ng or SMS i n t he SAP Web Appl i cat i on Ser ver usi ng SMTP?
Whi ch pr er equi si t es and set t i ngs ar e r equi r ed out si de t he SAP syst em?

Other Terms
I NT, FAX, PAG, SAPconnect , SMTP

Reason and Prerequisites
Some i nf or mat i on i s mi ssi ng.

Solution

Gener al i nf or mat i on, ar chi t ect ur e, pr er equi si t es, syst em envi r onment

When e- mai l s ar e t r ansf er r ed usi ng SMTP, t he SAP Web Appl i cat i on Ser ver communi cat es di r ect l y wi t h a
mai l ser ver . No gat eway or connect or i s necessar y.
You can use any SMTP- compat i bl e pr oduct as a mai l ser ver .
The SAP syst emal ways t r ansf er s t he out bound mai l s t o a si ngl e mai l ser ver . You can set i t s host
addr ess and por t number .
The SAP syst emcan r ecei ve i nbound mai l s f r omany number of mai l ser ver s. You can r each each cl i ent
usi ng separ at e, conf i gur abl e por t number s. You can addr ess t he SAP syst emor i t s cl i ent most
ef f ect i vel y by usi ng an i ndi vi dual subdomai n f or each cl i ent ( f or exampl e, " cr m- pr od. company. com" ) .
The assi gnment of t hese subdomai ns t o host name and por t number s of t he SAP syst emi s def i ned by t he
r out i ng r ul es on t he mai l ser ver s.
As of Rel ease 6. 20, you can al so send and r ecei ve f ax and SMS or pagi ng messages usi ng SMTP. These
ar e packed i n e- mai l s f or t hi s pur pose. When sendi ng, t he mai l ser ver uses t he domai n of t he
r eci pi ent addr esses t o send t he e- mai l s t o an i nt er nal company f ax or SMS ser ver ( f or exampl e
" SMS=+491759628717@sms- ser ver . company. com" ) , or t o an ext er nal pr ovi der ( f or exampl e,
" FAX=+16105954900@f ax- pr ovi der . com" ) . When r ecei vi ng, t he f ax/ SMS ser ver or t he pr ovi der sends e-
mai l s t o addr esses usi ng t he domai n of t he SAP syst em( f or exampl e " FAX=+496227751624@cr m-
pr od. company. com" ) .
Secur i t y not es

Make sur e t hat al l of t he mai l ser ver s t hat t he SAP syst emcommuni cat es wi t h when r ecei vi ng and
sendi ng messages have r el evant vi r us scanner s and spamf i l t er s. We expl i ci t l y r ecommend pr ot ect i ng
t he r ecei vi ng socket f r omt he out si de by usi ng t he f i r ewal l t o pr event di r ect del i ver y at t empt s by
t hi r d par t i es.
I n addi t i on, we r ecommend t hat t he SAP syst emdoes not di r ect l y communi cat e wi t h a mai l ser ver
out si de t he f i r ewal l .
Conf i gur at i on
1. Pr of i l e par amet er
To be abl e t o use t he SMTP f unct i ons, you must adj ust t he pr of i l e of t he SAP Web Appl i cat i on
Ser ver . We r ecommend t hat you act i vat e SMTP on al l appl i cat i on ser ver s of an SAP syst em. I f t hi s
i s not t he case, t he SAPconnect send j ob may onl y be schedul ed f or ser ver s on whi ch SMTP i s
act i ve. The schedul i ng i s t hen done by t he st andar d j ob def i ni t i on ( t r ansact i on SM36) r at her
t han by t he SAPconnect admi ni st r at i on ( t r ansact i on SCOT, f or a descr i pt i on, see 4. c) .
For SMTP, you must set t he pr of i l e par amet er s l i st ed bel ow. The pl acehol der <*> st ands f or a
number wi t h whi ch t he par amet er s t hat can occur sever al t i mes ar e number ed sequent i al l y,
st ar t i ng wi t h 0.
a) i cm/ ser ver _por t _<*> = PROT=SMTP, PORT=<por t >
Thi s opens a TCP/ I P por t f or r ecei vi ng mai l s by t he SMTP Pl ug- I n. <por t > speci f i es t he
number of the port that you should use.  This must not be occupied by any other program on
t hi s host ( f or exampl e, Sendmai l usual l y uses por t 25) . I f no mai l s ( i ncl udi ng st at us
not i f i cat i ons) ar e t o be r ecei ved i n t hi s SAP syst em, <por t > can be set t o 0.
You can use t he TI MEOUT opt i on t o def i ne a maxi mumwai t t i me f or a r esponse f r omt he mai l
ser ver ( i n seconds) .
    455140 - Configuration of e-mail, fax, paging or SMS using SMTP  
Version   18     Validity: 25.10.2010 - active   Language   English
Released On 25.10.2010 08:38:06
Release Status Released for Customer
Component BC-SRV-COM Communication Services: Mail, Fax, SMS, Telephony


BC-CST-IC Internet Communication Manager
Priority Recommendations / Additional Info
Category Installation information
Other Components
b) i s/ SMTP/ vi r t _host _<*> = <host >: <por t >, <por t >, . . . ;
Thi s def i nes a " vi r t ual mai l host " f or r ecei vi ng mai l s. I f al l i ncomi ng mai l s ( i ncl udi ng
st at us not i f i cat i ons) ar e t o be r ecei ved and pr ocessed i n a si ngl e cl i ent of t hi s SAP
syst em, t hi s par amet er i s not r equi r ed ( an ent r y i s/ SMTP/ vi r t _host _0 = *: * i s t hen assumed
by def aul t ) . I f you want sever al cl i ent s t o be abl e t o r ecei ve, you must cr eat e a vi r t ual
mai l host f or ever y cl i ent . <host > speci f i es t he name of t he host t o whi ch i ncomi ng mai l s
ar e addr essed. The " *" val ue can al so be speci f i ed her e i f t he mai l di st r i but i on i s t o occur
i ndependent l y of t he addr essed host . I mpor t ant : I f t he mai l i s t o be di st r i but ed accor di ng
t o host names, you must assi gn di f f er ent I P addr esses t o t hese host names. <por t > speci f i es
t he number of a por t t o whi ch i ncomi ng mai l s ar e addr essed. Sever al por t s may be speci f i ed
f or each host , and sever al host s ( wi t h sever al por t s i f necessar y) may be speci f i ed f or each
vi r t ual mai l host . I mpor t ant : The par amet er l i ne must al ways be compl et ed wi t h a semi col on
( even i f onl y one host i s i nvol ved) . I n addi t i on, i t i s onl y possi bl e t o def i ne a maxi mumof
10 virtual hosts:   virt_host_0 ... virt_host_9.
The assi gnment of vi r t ual mai l host s t o cl i ent s i s car r i ed out i n t he SAP syst em( see 3) .
              Example:
Wi t h t wo cl i ent s capabl e of r ecei vi ng mai l , t he pr of i l e par amet er s coul d r ead as f ol l ows ( as of
Rel ease 6. 20) :
   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;
2. User admi ni st r at i on ( t r ansact i on SU01)
a) Syst emuser
I n each cl i ent of an SAP syst emi n whi ch i ncomi ng mai l s ( or st at us not i f i cat i ons f or sent
mai l s) ar e t o be r ecei ved, a syst emuser must be cr eat ed t o pr ocess t he i ncomi ng messages.
To do t hi s, use t r ansact i on SU01 t o cr eat e a user of t he t ype " syst em" , and assi gn t he
" S_A. SCON" pr of i l e t o t hi s user .
I mpor t ant : I n Rel ease 6. 20 or l ower , r ef er t o Not e 622464 r egar di ng t he passwor d change
behavi or of t he syst emuser .
b) User addr esses
Each i ndi vi dual user who want s t o r ecei ve e- mai l s i n an SAP syst emneeds an I nt er net mai l
addr ess. Thi s i s al so used as a sender addr ess f or sendi ng e- mai l s. I n t r ansact i on SU01,
ent er t he I nt er net mai l addr ess of a user i n t he f i el d " E- Mai l " under " Addr ess" . As a
domai n, use t he domai n of t he SAP syst emcl i ent i f possi bl e ( see " Gener al i nf or mat i on" above
and 4. a) , f or exampl e " f i r st name. l ast name@cr m- pr od. company. com" .
3. Cl i ent assi gnment ( t r ansact i on SI CF)
For each cl i ent of an SAP syst emi n whi ch i ncomi ng mai l s ( or st at us not i f i cat i ons f or sent
mai l s) ar e t o be r ecei ved, and pr ocessed i f necessar y, you must cr eat e an SMTP ser ver i n whi ch
t he assi gnment t o a vi r t ual mai l host as wel l as t he l ogon dat a i s def i ned. I n t r ansact i on SI CF,
an SMTP ser ver ( envel ope i con) shoul d al r eady be avai l abl e i n ever y SAP syst em. Thi s i s
del i ver ed by SAP. Use t hi s f or t he f i r st cl i ent t hat you want t o be abl e t o r ecei ve mai l s, and
cr eat e a new SMTP ser ver f or ever y ot her cl i ent . You must make t he f ol l owi ng set t i ngs on t he
SMTP ser ver s:
a) Host dat a
For " Pr of i l e Par amet er Number " , ent er t he sequence number of a par amet er
i s/ SMTP/ vi r t _host _<*> f r omt he pr of i l e. I f you have onl y one cl i ent and di d not cr eat e such
a par amet er i n t he pr of i l e, ent er 0.
b) Ser vi ce dat a
Ent er t he cl i ent i nt o whi ch t he mai l s r ecei ved usi ng t hi s vi r t ual mai l host ar e t o be
di r ect ed, as wel l as t he l ogon dat a ( user , passwor d, l anguage) of t he ser vi ce user t hat was
cr eat ed f or i nbound mai l s ( see 2. a) .
c) Handl er l i st
Ent er CL_SMTP_EXT_SAPCONNECT i n t he f i r st posi t i on.
              As of Release 6. 20, you must activate the SMTP server after you create or change it
( Ser vi ce/ Vi r t . Host - - > Act i vat e, or r i ght - cl i ck) .
4. SAPconnect admi ni st r at i on ( t r ansact i on SCOT)
You have t o make t he SAPconnect set t i ngs separ at el y i n each cl i ent f r omwhi ch e- mai l s ar e t o be
sent or i n whi ch e- mai l s ar e t o be r ecei ved.
a) Def aul t domai n
The domai n of t hi s SAP syst emcl i ent i s def i ned her e, f or exampl e, cr m- pr od. company. com. I t
i s used f or t he f ol l owi ng pur poses:
¡ The SMTP Pl ug- I n l ogs on t o t he mai l ser ver wi t h t he domai n as I D.
¡ The message I D of out goi ng mai l s i s cr eat ed wi t h t hi s domai n.
¡ I f an SAP user who has not ent er ed an I nt er net mai l addr ess i n t hei r user mast er r ecor d
sends an e- mai l , a sender addr ess i s gener at ed f r omt he SAP user name and t hi s domai n, f or
exampl e SMI THJ @cr m- pr od. company. com.
b) Nodes
Ther e ar e di f f er ent t ypes of node i n SAPconnect :
¡ SMTP nodes ( f or t he SMTP f unct i on of t he SAP appl i cat i on ser ver )
¡ HTTP nodes ( f or pagi ng or SMS pr ovi der s usi ng Web ser vi ces, as of 6. 20)
¡ RFC nodes ( f or ol d RFC- compat i bl e e- mai l / f ax/ pagi ng gat eways)
                       There is always a single SMTP node in each client. It is created
aut omat i cal l y by t he syst emand cannot be del et ed. I t i s conf i gur ed as f ol l ows ( doubl e- cl i ck on t he
node name) :
¡ Sel ect " Node i n use" .
¡ Under " Mai l Host " and " Mai l Por t " , speci f y t he mai l ser ver t o whi ch out bound mai l s ar e t o be
t r ansf er r ed.
¡ Sel ect " Set " f or " I nt er net " .
¡ Speci f y addr ess ar eas of r eci pi ent addr esses t hat ar e t o be r eached usi ng t hese nodes
( usual l y " *" i f al l e- mai l s ar e t o be sent usi ng SMTP) .
¡ For " Out put For mat s f or SAP Document s" , t he f ol l owi ng i s r ecommended:
   SAPscript / Smart Forms      PDF
   ABAP List                    HTM
   Business Object / Link        HTM
   RAW Text                      TXT
                       If fax messages are also to be sent using SMTP:
¡ Sel ect " Set " f or " Fax" .
¡ Speci f y addr ess ar eas of r eci pi ent addr esses t hat ar e t o be r eached usi ng t hese nodes
( usual l y " *" i f al l f axes ar e t o be sent usi ng SMTP) .
¡ For " Out put For mat s f or SAP Document s" , t he f ol l owi ng i s r ecommended:
   SAPscript / Smart Forms      PDF
   ABAP List                    PDF
   Business Object / Link        TXT
   RAW Text                      TXT
¡ For " Conver si on i nt o I nt er net Addr ess" , ent er t he domai n of t he f ax ser ver or f ax pr ovi der .
The l ocal par t of t he I nt er net addr ess i s gener at ed aut omat i cal l y by t he syst em. The addr ess
t hen has t he f or m" FAX=+r eci pi ent number @domai n" .
                       If paging or SMS messages are also to be sent using SMTP:
¡ Sel ect " Set " f or " Pager ( SMS) " .
¡ Speci f y addr ess ar eas of r eci pi ent addr esses t hat ar e t o be r eached usi ng t hese nodes
( usual l y " *" i f al l pagi ng or SMS messages ar e t o be sent usi ng SMTP) .
¡ For " Conver si on i nt o I nt er net Addr ess" , ent er t he domai n of t he pagi ng or SMS ser ver or
pagi ng or SMS pr ovi der . The l ocal par t of t he I nt er net addr ess i s gener at ed aut omat i cal l y by
t he syst em. The addr ess t hen has t he f or m" SMS=+r eci pi ent number @domai n" .
                       Important: To be able to use paging or SMS in the SAP system, names must be
def i ned f or t he messagi ng ser vi ces t o be used ( e. g. " SMS" ) . You can do t hi s usi ng t r ansact i on SA14.
c) Send j ob
E- mai l s t hat ar e sent f r oman SAP appl i cat i on ar e mer el y put i nt o a queue. A per i odi cal l y
r unni ng backgr ound pr ocess, t he SAPconnect send j ob, t akes t he e- mai l s f r omt he queue and
sends t hemby I nt er net . Thi s j ob can be schedul ed f r omSAPconnect admi ni st r at i on as f ol l ows:
¡ Choose " Vi ew" - - > " J obs" . Check whet her a j ob i s al r eady schedul ed ( di spl ayed as a cal endar
i con) .
¡ Choose " J ob" - - > " Cr eat e" , and speci f y a j ob name.
¡ Pl ace t he cur sor on t he " SAP&CONNECTALL" var i ant , and choose " Schedul e J ob" .
¡ Choose " Schedul e per i odi cal l y" .
¡ Speci f y a t i me i nt er val ( f or exampl e, 10 mi nut es) , and choose " Cr eat e" .
d) Recei vi ng
Wi t h t he set t i ngs made so f ar , SAP user s can al r eady r ecei ve e- mai l s i n t hei r i nbox i n t he
Busi ness Wor kpl ace ( t r ansact i on SBWP) at t he addr ess ent er ed i n t he user mast er r ecor d.
I f , on r ecei pt of e- mai l s t o a speci f i c addr ess or wi t h speci f i c cont ent s ( f or exampl e XML
document s) , you want a pr ogr amt hat pr ocesses t hese e- mai l s t o st ar t aut omat i cal l y, you can
conf i gur e t hi s under " Set t i ngs" - - > " I nbound Pr ocessi ng" .
I f , on r ecei pt of e- mai l s t o a speci f i c addr ess or f r oma speci f i c sender , you want t hese t o
be di r ect ed aut omat i cal l y t o anot her r eci pi ent or a di st r i but i on l i st , you can conf i gur e
t hi s under " Set t i ngs" - - > " I nbound Di st r i but i on" .
5. Set t i ngs on t he mai l ser ver ( SAP- ext er nal conf i gur at i on)
To be abl e t o r ecei ve mai l s i n t he SAP syst em, you need t o set your mai l ser ver so t hat cer t ai n
mai l addr esses ar e f or war ded t o one or sever al SAP syst ems or cl i ent s. For t hi s pur pose, you
need t o def i ne r out i ng r ul es t hat assi gn a mai l host and/ or por t t o addr ess ar eas ( gener i c
addr ess par t s, usual l y t he domai n) , f or exampl e:
      *@crm- prod.company.com  - - >  SAPWASHost:25000
      *@crm- test.company.com  - - >  SAPWASHost:25001
For mor e i nf or mat i on about t he exact set t i ng pr ocedur e, see t he mai l ser ver document at i on. Not e
546147 descr i bes wher e t he document at i on can be f ound f or t he Mi cr osof t Exchange 2000 Ser ver ,
and what t o do i f your mai l ser ver does not al l ow r out i ng t o por t s ot her t han por t 25.

Other Attributes
Validity
This document is not restricted to a software component or software component version
References
This document refers to:
SAP Notes
This document is referenced by:
SAP Notes (22)


EMAIL

HIER

SA14

SBWP

SCOT

SICF

SM36

SU01
1522754   SAP TM 8.0 - collection of notes, pro-active implementation
1455934   Notification emails not sent for CUP requests
1405426   FAQ: SI data exchange with HI funds (SHI comm server/E-Mail)
1236270   Support for SAPconnect RFC interface
1155948   SI: Configuring incoming e-mails(paying offices,DEUEV conf.)
1114661   SAPscript und Smart Forms als E-Mail versenden
960088   FAQ: Sending SD messages externally
833396   Notification of tester with status changes of message
779972   SURVEY: Configuration required to receive emails
627144   Conducting Web Surveys
622464   Change: Password change req. entry for "SYSTEM" user type
607108   Problem analysis when sending or receiving e-mails
594428   SXC: Exchange 2003 Server is not supported
557377   E-mail connection for internal SAP systems
546147   SMTP plug-in: MS Exchange sends only to port 25
519664   Installation of SAP SEM Release 3.1B GA
519658   Upgrade to SAP SEM Release 3.1B GA
511025   Bid invitation: No confirmation of receipt
455142   SAPconnect: Configuration paging/SMS via HTTP
455129   Paging/SMS in different SAP releases
455127   E-mail (SMTP) in different SAP releases
101573   Internet Mail Gateway: Versions
17194   Telefax in various SAP Releases
511025   Bid invitation: No confirmation of receipt
594428   SXC: Exchange 2003 Server is not supported
519664   Installation of SAP SEM Release 3.1B GA
519658   Upgrade to SAP SEM Release 3.1B GA
607108   Problem analysis when sending or receiving e-mails
960088   FAQ: Sending SD messages externally
1236270   Support for SAPconnect RFC interface
622464   Change: Password change req. entry for "SYSTEM" user type
1982341   E-mails are sent immediately instead of being processed in transaction SOST
1008835   CRM 1Order XIF: Sending a mail if a document has errors
779972   SURVEY: Configuration required to receive emails
546147   SMTP plug-in: MS Exchange sends only to port 25
17194   Telefax in various SAP Releases
101573   Internet Mail Gateway: Versions
455142   SAPconnect: Configuration paging/SMS via HTTP
Transaction codes


455127   E-mail (SMTP) in different SAP releases
455129   Paging/SMS in different SAP releases
1455934   Notification emails not sent for CUP requests
1522754   SAP TM 8.0 - collection of notes, pro-active implementation
1405426   FAQ: SI data exchange with HI funds (SHI comm server/E-Mail)
833396   Notification of tester with status changes of message
1155948   SI: Configuring incoming e-mails(paying offices,DEUEV conf.)