TIBCO EMS Transport channel for WCF

WHITE PAPER

WHITE PAPER TIBCO EMS Transport channel for WCF
Contents
Change Record...............................................................................................................2
1. Introduction..................................................................................................................4
2. Interoperability............................................................................................................5
3. Meage E!change Pattern..................................................................................7
". #a$ple Pro%ect.............................................................................................................8
".1. Pro%ect #cope............................................................................................................8
".2. Product&#o't(are re)uire$ent...........................................................................9
".3. Con*guration re)uire$ent................................................................................9
".3.1. +uine Wor, #er-ice....................................................................................9
".3.2. #tep to 'or creating the Client uing /iual #tudio............................10
".". WC0 Client12i$itation.....................................................................................12
".3. Running the a$ple pro%ect..............................................................................13
Appendi! A.........................................................................................................................14

Page 2 of 14
WHITE PAPER TIBCO EMS Transport channel for WCF
1.Introduction
Windo( Co$$unication 0oundation 4WC05 i an application
progra$$ing inter'ace 'or de-elop$ent o' connected application
through er-ice6oriented progra$$ing $odel. WC0 i baed on the
notion o' $eage6baed co$$unication (hich i repreented in a
uni'or$ (ay in the progra$$ing $odel. It alo pro-ide a 'ra$e(or,
baed application progra$$ing inter'ace 'or de-elop$ent o' tranport
channel beyond the tandard tranport pro-ided by the WC07 i.e.
HTTP7 TCP7 8a$ed pipe and M#M9.
Page 3 of 14
WHITE PAPER TIBCO EMS Transport channel for WCF
Meage can be ent o-er the intranet or Internet by uing
co$$on tranport7 uch a HTTP and TCP. WC0 pro-ide a 'ra$e(or,
by (hich $ore tranport $echani$&channel can be added uing
the built6in e!tenion point o' WC0. Thi pro-ide uer a 'acility to
change the tranport channel (ithout changing the $ain progra$ but
by %ut changing the con*guration o' e!tenion point. The TI+C:
EM# Tranport Channel 'or WC0 i a 'ra$e(or, de-eloped by TI+C: to
allo( ue o' TI+C: Enterprie Meage #er-ice 4EM#5 a a tranport
channel 'or Windo( Co$$unication 0oundation 4WC05 er-ice.
The TI+C: EM# Tranport Channel 'or WC0 4;Te$Tranport channel;5
allo( ending and recei-ing $eage through the TI+C: EM#
#er-er. To enable the Te$Tranport channel (ithin WC0 'ra$e(or,7
Page 4 of 14
WHITE PAPER TIBCO EMS Transport channel for WCF
(e need to create cuto$ binding that peci*e Te$Tranport 'or the
tranport channel in the channel tac,.

2.Interoperability
The TI+C: EM# Tranport Channel 'or WC0 can be ued in the
'ollo(ing (ay.

Co$$unication bet(een WC0 application to WC0

WC0 application to a (eb er-ice that i$ple$ent TI+C:< #:AP o-er =M#
protocol
8on6WC0 application to WC0 application
Page 5 of 14
WHITE PAPER TIBCO EMS Transport channel for WCF
To upport thi interoperability7 >Te$Tranport? pro-ide the neceary
$eage protocol inter'ace that help to acce to both the EM#
$eage and the WC0 $eage (hen recei-ing or ending a $eage -ia
Te$. The >$eageProtocol? attribute i ued to peci'y the type o'
i$ple$entation that i ued to tran'or$ bet(een a WC0 $eage and
an EM# $eage. The $eageProtocol attribute can be et to one o' the
'ollo(ing >Te$MeageProtocolType? enu$eration -alue.
WCFNative 6 #peci*e WC06to6WC0 co$$unication and thi
i$ple$entation by de'ault do not per'or$ any tran'or$ation.
@
TIBCOSoapOverJMS2004 6 #peci*e co$$unication bet(een a
WC0 application and a (eb er-ice that i$ple$ent TI+C:< #:AP
:-er =M# protocol. Thi i$ple$entation auto$atically per'or$ all
neceary tran'or$ation bet(een WC0 and TI+C:< #:AP :-er
=M#.
@
Custo 6 #peci*e co$$unication bet(een a 8on6WC0 EM#
application and a WC0 application. Thi pro-ide e!tenibility o
that uer can de-elop o(n cuto$ i$ple$entation and
tran'or$ation.
3.Meage E!change Pattern
Page 6 of 14
WHITE PAPER TIBCO EMS Transport channel for WCF
The TI+C: EM# Tranport Channel 'or WC0 upport datagra$4 one
(ay co$$unication57 'ull duple! 4either (ay co$$unication
i$ultaneouly5and re)uet6reply WC0 $eage e!change pattern
4MEP5 and thee $eage e!change pattern i peci*ed in the
er-ice contract. TI+C: EM# Tranport Channel 'or WC0 alo
upport both eion6le and eion6'ull channel.
".#a$ple Pro%ect
".1. Pro%ect #cope
Thi pro%ect decribe the co$$unication bet(een WC0
application to a (eb er-ice that i$ple$ent TI+C:< #:AP
o-er =M# protocol uing TI+C: EM# tranport channel 'or
Page 7 of 14
WHITE PAPER TIBCO EMS Transport channel for WCF
WC0. Thi pro%ect ue $eage protocol a
>TI+C:#oap:-er=M#2AA"? and $eage e!change pattern a
>Re)uet6Reply? (hich are decribed abo-e.
Thi pro%ect cope doen<t include co$$unication bet(een
WC0 application to WC0 application and co$$unication
bet(een 8on6WC0 application to WC0.
!ro"ect

Overvie#
In thi a$ple pro%ect7 a i$ple 'or$ baed WC0 client
application in-o,e a TI+C: +uineWor, er-ice 4#:AP
o-er =M#5 and pae >0irtna$e? and >2atna$e? a input
para$eter -ia TI+C: EM# WC0 channel7 a a reult
+uineWor, er-ice return concatenation o' >0irtna$e?
and >2atna$e?.
+elo( ection 4".2 to "."5 decribed the tep re)uired 'or
intallation and con*guration 'or creating a$ple pro%ect7 the
actual code logic ection i not decribed here.
Bou can re'er ection ".3 'or the a$ple pro%ect code
attach$ent and the tep to run thi pro%ect.
Page 8 of 14
WHITE PAPER TIBCO EMS Transport channel for WCF
".2. Product&#o't(are re)uire$ent
TI+C: EM# ".3 or abo-e
TI+C: EM# Tranport Channel 'or WC0 1.1
TI+C: +uineWor, 3." or abo-e
Microo't /iual #tudio 2AAC #P1 or abo-e
Microo't .8ET 0ra$e(or, 3.3 #P1 or abo-e
".3. Con*guration re)uire$ent
".3.1. +uine Wor, #er-ice.
Con*gure the +W er-ice a ho(n belo( and ,eep
Services$%WS&' Source$%JN&I !roperties (JMS onl)*
elected (hile generating the W#D2.
".3.2. #tep to 'or creating the Client uing /iual
#tudio.
Page 9 of 14
WHITE PAPER TIBCO EMS Transport channel for WCF
Create a ne# Win+o#s Fors ,pplication-
>WC0Client?
,++ the asse.l) reference-
Right6Clic, >Re'erence? in #olution E!plorer
Clic, on >Add Re'erenceE?
#elect the >+ro(e? tab
add
>C.FtibcoFe$G(c'F1.1FbinFTI+C:.EM#.WC0.dll?
Add the er-ice re'erence 'or the +W er-ice
Modi'y the >App.con*g? *le to ue TI+C: EM#
Code the client
,++in/ the service reference-
Thi (ill auto$atically generate the pro!y client clae and
populate the app.con*g *le.
#a-e the concrete W#D2 'ro$ the +uineWor,
er-ice
E!. C.FWC02EM# 1.1FW#D2FWC02EM#.(dl
Right6Clic, >Re'erence? in #olution E!plorer
Clic, >Add #er-ice Re'erenceE?
Enter the location o' the W#D2 in the >Addre?
co$bo bo!
Clic, the >Ho? button 4>#er-ice? and
>:peration? (ill populate5
Enter the er-ice na$epace >EM##:AP#er-ice?
in the >8a$epace? *eld
Ie the de'ault in the >Ad-anced? $enu
Clic, on >:J? to generate the pro!y clae
Mo+if) the ,pp0con1/ 1le-
Page 10 of 14
WHITE PAPER TIBCO EMS Transport channel for WCF
Adding the er-ice re'erence doe not update
App.con*g *le properly. The 'ollo(ing $anual tep (ill
*! thi proble$.
Re$o-e the cuto$ binding re'erence to the
>=M#E8DP:I8T+inding?
<binding name="JMSENDPOINTBinding">
<textMessageEncoding maxReadPoolSie="!""
max#$itePoolSie="%!& message'e$sion="Soa(%%"
)$iteEncoding="*t+,-">
<$eade$.*otas maxDe(t/="01"
maxSt$ing2ontent3engt/="-%41" max5$$a63engt/="%!0-"&
maxB6tesPe$Read=""74!"
maxNameTable2/a$2o*nt="%!0-"" 8>
<8textMessageEncoding>
<8binding>
Replace it (ith one to the TI+C: EM# #:AP binding
<binding name="TemsSO5PBinding">
<textMessageEncoding
message'e$sion="Soa(%%#S5dd$essing%7" 8>
<TemsT$ans(o$t messageP$otocol="TIB2OSoa(O9e$JMS177""
8>
<8binding>
Note- Thi enure you are uing the #:AP 1.1
$eage protocol 41.2 i not upported5 and the
TI+C: #:AP o-er =M# tranport.
Page 11 of 14
WHITE PAPER TIBCO EMS Transport channel for WCF
Ma,e ure the endpoint i con*gured properly

The addre point to the proper EM# )ueue

The binding point to the cuto$ binding

decribed earlier

The contract point to the autogenerated

PortType o' your er-ice 4na$epace.PortType5
<end(oint
add$ess="net:tems;88local/ost;<1118=*e*e8>ET?@33N5ME&
binding="c*stomBinding&
binding2onAg*$ation="TemsSO5PBinding&
cont$act=B<Se$9ice>:<Po$tT6(e>&
name=B<End(ointName>" 8>
Co$plete con*guration *le
A a$ple co$plete con*guration KM2 *le i attached
here7
".". WC0 Client12i$itation
When uing the #:AP o-er =M# protocol.
:nly eion6le channel are upported
Attach$ent are not upported
:nly #:AP 1.1 i upported
Note- WC0 doe not upport the TI+C: generated W#D2 'or
deploying an enterprie er-ice under $ultiple tranport
4HTTP and =M# endpoint5 protocol.
Page 12 of 14
AppCon*g.!$l
WHITE PAPER TIBCO EMS Transport channel for WCF
".3. Running the a$ple pro%ect
BWService-
WCFClient-
The 'ollo(ing tep are re)uired to per'or$ 'or ucce'ul
de$o o' a$ple pro%ect.
#tart TI+C: EM# er-er.
Create a )ueue na$ed LHET0I228AMEL in the EM#
er-er.
Run attached +W#er-ice pro%ect.
Run attached WC0Client7 enter >0irtna$e? and
>2at8a$e?7 and call the er-ice by clic,ing the >Call
#er-ice? button. It hould return >0ritna$e?M
>2atna$e?
Page 13 of 14
+W#er-ice.Nip
WC0Client.Nip
WHITE PAPER TIBCO EMS Transport channel for WCF
Appendi! A
Re'erence.
MS&N O http://!"#.$%&o!oft.%o/e#'(!/)$*&a&y/!735119.a!p+
TIBCO pro+uct +ocuent' ,TI-./ I#!ta))at$o# Hoe0/
e!12%f/1.1/"o%/p"f/t$*1e!1t&a#!1%ha##e)12%f1(!e&.p"f

Page 14 of 14