SAP Note

Header Data
Symptom
The RFC f or an ext er nal RFC ser ver pr ogr amf ai l s.

The sysl og and t he wor k pr ocess t r ace, cont ai n t he f ol l owi ng er r or messages i n shor t successi on,
wher eby t he f ol l owi ng val ues appl y speci f i cal l y t o t he concr et e scenar i o:

<CONVI D> = Conver sat i on I D
<HOST> = Host name of t he gat eway
<PI D> = Pr ogr amI D
<SERVI CE> = Por t number of t he gat eway ( sapgwXY)
<RELEASE> = ABAP r el ease name ( f or exampl e, 720)

Sysl og:
R49 K Communication error
R49 K Communication error, CPIC- RC=002, SAP- RC=679
R5A K > Conversation ID: <CONVID>
R64 K > CPIC Function: CMALLC

Wor k pr ocess t r ace:
*****************************************************
* LOCATI ON SAP- Gat eway on host <HOST>
*ERROR program <PID> not registered
*
* TI ME Mon Oct 30 09: 10: 27 2000 * RELEASE <RELEASE>
* COMPONENT SAP- Gat eway
* VERSION 2
* RC 679
* MODULE gwr 3cpi c. c
* LINE 1361
*DETAILTP <PID> not registered
* COUNTER 2
*****************************************************

Anot her sympt omi s, t hat t he connect i on t est f or t he RFC dest i nat i on used ( t r ansact i on SM59,
connect i on t ype ' T' = TCP/ I P connect i on) f ai l s:

Connect i on er r or
Er r or openi ng RFC connect i on ( CPI C- CALL: ' ThSAPOCMI NI T' : cmRc=2 t hRc
ERROR: pr ogr am<PI D> not r egi st er ed
LOCATI ON: SAP- Gat eway on host <HOST> / <SERVI CE>
DETAI L: TP <PI D> not r egi st er ed
COMPONENT : SAP Gat eway
COUNTER: 12346
MODULE: gwr 3cpi c. c
LI NE: 1789
RETURN CODE: 679
SUBRC: 0
RELEASE: <RELEASE>
TI ME: Tues Sept 20 12: 42: 55 2011
VERSI ON: 2

( The er r or messages and t r ace ent r i es may di f f er f r omt he exampl es dependi ng on t he ABAP r el ease
used. )

Other Terms
TP Tr ansact i on pr ogr amnot r egi st er ed, SAP- RC=679, CPI C- RC=02
RFC gat eway r egi st r at i on PI D sapr f c. i ni TP_NOTREGI STERED

Reason and Prerequisites
An ABAP syst emt r i es t o access a r egi st er ed RFC ser ver t hat i s not cur r ent l y r egi st er ed on t he
gat eway.

353597 - Registration of RFC server programs
Version 17 Validity: 08.05.2014 - active Language English
Released On 08.05.2014 10:53:55
Release Status Released for Customer
Component BC-MID-RFC RFC


BC-CST-GW Gateway/CPIC
Priority Recommendations / Additional Info
Category Help for error analysis
Other Components
Solution
On t he ext er nal si de

Regi st er t he ser ver pr ogr amon t he gat eway. Fol l ow t he document at i on f or t he r el evant pr ogr am.
I f t he pr ogr amwas pr ogr ammed accor di ng t o t he r ecommendat i ons i n t he RFC SDK gui de, t hen t he
ext er nal RFC ser ver pr ogr ami s cal l ed i n t he r el evant r un di r ect or y usi ng t he f ol l owi ng command:

<PROGRAM> - a <PI D> - g <HOST> - x <SERVI CE>

The ext er nal RFC ser ver pr ogr am<PROGRAM> ( f i l e name of t he ext er nal RFC ser ver pr ogr am- possi bl y
speci f yi ng t he pat h, i f t he r un di r ect or y i s not t he i nst al l at i on di r ect or y) now r egi st er s wi t h t he
pr ogr amI D <PI D> on t he gat eway host <HOST> on t he por t ( gat eway ser vi ce) <SERVI CE>. The val ue
<HOST> may have t o cont ai n a r out er st r i ng t o t he gat eway host .
Al t er nat i vel y t o t hese di r ect met hods, t hese par amet er s can al so be speci f i ed usi ng t he
conf i gur at i on f i l e sapr f c. i ni ( cl assi c RFC l i br ar y) or sapnwr f c. i ni ( NWRFC l i br ar y) ( see onl i ne
document at i on at t he end of t he sapr f c. i ni or sapnwr f c. i ni f i l e) . When you st ar t t he RFC ser ver
pr ogr am, you onl y have t o t r ansf er t he par amet er - D <DEST>:

<PROGRAM> - D <DEST>

I f t he sapr f c. i ni or sapnwr f c. i ni f i l e i s not i n t he cur r ent r un di r ect or y, t hen t he pat h t o t he
sapr f c. i ni has t o be speci f i ed i n t he envi r onment var i abl e RFC_I NI , or f or t he sapnwr f c. i ni t he pat h
has t o be set vi a t he API Rf cSet I ni Pat h( ) .
How t he pr ogr amr f cexec f or t he ALE scenar i o i s r egi st er ed at t he gat eway i s descr i bed i n SAP Not e
1581595.

Ther e ar e ext er nal RFC ser ver pr ogr ams t hat cl ose t he RFC connect i on af t er an er r or and do not r e-
r egi st er aut omat i cal l y at t he gat eway. As a r esul t , t he ext er nal pr ogr ami s no l onger r egi st er ed at
t he gat eway. A wor kar ound f or t hi s pr ogr ami s descr i bed i n t he sect i on " Aut omat i c r egi st r at i on af t er
pr ogr amt er mi nat i on" i n t hi s not e.

On t he ABAP si de

I n t he ABAP syst em, t he dest i nat i on t o be used must be of t he connect i on t ype ' T' ( TCP/ I P
connect i on) and be conf i gur ed i dent i cal l y ( t r ansact i on SM59 - > t ab page " Techni cal Set t i ngs" - >
f r ame " Act i vat i on t ype" - > " Regi st er ed Ser ver Pr ogr am" ) :
l Fi el d val ue " Pr ogr amI D" : must be i dent i cal wi t h t he <PI D> ( case- sensi t i ve)
l Gat eway opt i ons
Gat eway host : The host name t o whi ch t he ext er nal pr ogr ami s r egi st er ed ( cor r esponds t o
par amet er <HOST> wi t hout r out er st r i ng)
Gat eway ser vi ce: Por t of t he gat eway ( cor r esponds t o par amet er <SERVI CE>)

I f t he ar e gat eway opt i ons ar e not mai nt ai ned, t he pr obl emdescr i bed i n Not e 44844.

I n t he gat eway moni t or , you can check whet her t he ser ver pr ogr ami s act ual l y r egi st er ed t o t he
r el evant gat eway. For t hi s pur pose, you have t o change t o t he appl i cat i on ser ver i n t he ABAP syst em
( f or t hi s pur pose, cal l t r ansact i on SMGWf r omt r ansact i on SM51) . The t abl e " Connect i ons t o
cl i ent s" ( menu: Got o - > Logged on Cl i ent s) must now cont ai n an ent r y wher e t he f ol l owi ng f i el ds have
t he r el evant val ues:
l LU name: ' host name' of t he comput er , on whi ch t he ext er nal pr ogr amr uns
l TP name: <PI D>
l Syst emType: " Regi st er ed ser ver "

The ent r y f or t he above exampl e i s t hen:
LU Name TP Name Host Name Host Addr ess Syst emType
<ext Host > t est mei nSAPhost <I P addr ess> r egi st er ed ser ver

Thi s l i st can be di spl ayed usi ng t he f unct i on modul e GWY_READ_CONNECTED_SYSTEMS t o aut omat i cal l y
check t he act ual r egi st r at i on ( i n par t i cul ar when you use a st andal one gat eway) . Gat eways can
pr ot ect agai nst a r emot e quer y when you set t he pr of i l e par amet er gw/ moni t or =1.

An RFC ser ver pr ogr amcan be r egi st er ed sever al t i mes t o t he same gat eway usi ng t he same PI D t o
di st r i but e t he l oad mor e evenl y.

You can use t he f i l e seci nf o ( up t o and i ncl udi ng Ker nel Rel ease 46D) or r egi nf o ( as of Rel ease
6. 40) t o speci f y
whi ch i dent i f i cat i ons RFC ser ver pr ogr ams can use t o r egi st er t hemsel ves
and wher e t hese r equest s f or r egi st r at i on can come f r om( see Not e 1105897 f or det ai l s) .

For mor e i nf or mat i on, r ef er t o t he onl i ne document at i on.

Aut omat i c r egi st r at i on af t er a pr ogr am t er mi nat i on

Ther e ar e ext er nal RFC ser ver pr ogr ams t hat cl ose t he connect i on t o t he gat eway and cl ose t hemsel ves

af t er an er r or . As a r esul t of t hi s behavi or , t he RFC no l onger wor ks usi ng t hi s dest i nat i on.

As a wor kar ound, such a pr ogr amhas t o be st ar t ed usi ng a scr i pt .

On MS Wi ndows:

: connect
<PROGRAM> - a <PI D> - g <HOST> - x <SERVI CE>
got o connect


For Uni x:
whi l e t r ue
do
<PROGRAM> - a <PI D> - g <HOST> - x <SERVI CE>
done

To br i dge t he t i me gap bet ween t he t er mi nat i on and a new connect i on set up, t he pr ogr ammust be
r egi st er ed at l east t wi ce at t he gat eway.

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 (3)

1581595 rfcexec or startrfc fail after upgrade
1105897 GW: reginfo and secinfo with permit and deny ACL
619060 QCI: New RFC server installation guide
44844 No connection to registered RFC program
44844 No connection to registered RFC program
619060 QCI: New RFC server installation guide
1105897 GW: reginfo and secinfo with permit and deny ACL