Professional Documents
Culture Documents
((//ss//)) C
Coom
mmmu
unniittyy LLeea
arrn
n PPrro
oddu
uccttss TTrra
aiin
niin
ngg D
Doow
wnnllo
oaad
dss SSu
uggg
geesstt ((//ss//iid
deea
attiio
onn))
Rate Like Bookmark
(/s/profile/0056A000000izetQAA) H
Hoow
w tto
o sse
et u
upp TTA
AFFC
CCCA
AL L JJEEE i n
n IBM W
Weeb
bssp
phhe
erre
e?
Vinay Jain - Admin (/s/profile/0056A000000izetQAA) • Apr 06, 2021 • Technology > Core Infra > System Core (EB)
33
11.. IIn
nttrro
oddu
uccttiio
onn
The DeliveryMDB is a message-driven bean that can be called from a jBC program using the CALLJEE or JEEActivate functions. These remote calls are achieved by using a
TCP/IP communication from the TAFC process to a Java Enterprise Edition Application Server – such as JBoss (see the JRemote Inbound JCA User Guide for more
information.). The only configuration necessary in TAFC is a host and a port.
1 of 17 2/10/2023, 8:47 PM
How to setup TAFC CALLJEE in IBM Websphere? https://basecamp.temenos.com/s/article-detail/a042K00001LAtfUQAT/how-to-setup-tafc-callj...
((//ss//)) C
Coom
mmmu
unniittyy LLeea
arrn
n PPrro
oddu
uccttss TTrra
aiin
niin
ngg D
Doow
wnnllo
oaad
dss SSu
uggg
geesstt ((//ss//iid
deea
attiio
onn))
In order to be callable, a message-driven bean must implement the JRemoteMessageListener interface and activate the JRemote JCA (jremote-ra.rar). Once activated
the JRemote JCA will listen for incoming requests on the configured IP address and port (see the ra.xml inside jremote-ra.rar). The DeliveryMDB is configured to only
receive messages that have been sent with an activation string of "DELIVERY". This configuration is using a feature of the JRemote JCA that allows many message-driven
beans to be activated but only called when a message with the correct activation string is received (see the DeliveryMDB ejb-jar.xml).
The purpose of the DeliveryMDB is to place messages onto a JMS queue and optionally wait for a reply on a JMS queue. The DeliveryMDB ejb-jar.xml contains the
configuration required for these request and reply queues. Multiple instances of the DeliveryMDBs can be created in the ejb-jar.xml to receive requests for different
activation types. The jBC program can determine which MDB instance it needs to call by the ACTIVATION string, but it can also pass a timeout value, processing type
(SYNC or ASYNC), correlation tag to identify messages on the JMS queue and the JMSType.
2 of 17 2/10/2023, 8:47 PM
How to setup TAFC CALLJEE in IBM Websphere? https://basecamp.temenos.com/s/article-detail/a042K00001LAtfUQAT/how-to-setup-tafc-callj...
((//ss//)) C
Coom
mmmu
unniittyy LLeea
arrn
n PPrro
oddu
uccttss TTrra
aiin
niin
ngg D
Doow
wnnllo
oaad
dss SSu
uggg
geesstt ((//ss//iid
deea
attiio
onn))
3 of 17 2/10/2023, 8:47 PM
How to setup TAFC CALLJEE in IBM Websphere? https://basecamp.temenos.com/s/article-detail/a042K00001LAtfUQAT/how-to-setup-tafc-callj...
<activation-config>
((//ss//)) C
Coom
mmmu
unniittyy LLeea
arrn
n PPrro
oddu
uccttss TTrra
aiin
niin
ngg D
Doow
wnnllo
oaad
dss SSu
uggg
geesstt ((//ss//iid
deea
attiio
onn))
<activation-config-property>
<activation-config-property-name>handler</activation-config-property-name>
<activation-config-property-value>DELIVERY</activation-config-property-value>
</activation-config-property>
</activation-config>
"DELIVERY" is the activation string which has to be passed as a parameter to the CALLJEE/JEEActivate functions in order to call this particular MDB. The value of this
activation property can be changed to have multiple instances of the DeliveryMDB receiving requests for different activation strings.
As mentioned before, the purpose of the DeliveryMDB is to place messages on JMS queues. A jBC program invoking a DeliveryMDB should leave the first 10
attributes of the message parameter as header properties. The properties are as follows:
JMS type
The message type, used as a JMS message type on the queue. This gives the consumer the opportunity to decide whether it wants to consume this type of
message. The consumer receiving a message can use the getJMSType() method (see class javax.jms.Message) to retrieve the message type.
Correlation ID prefix
This value is used by the reply queue to pick up the correct reply. The DeliveryMDB will use this prefix to set the JMS Correlation ID with the following syntax.
<<C
Coorrrre
ella
attiio
onn IID
Dpprre
effiixx>>__<<m
meessssa
agge
ennu
ummb
beerr>>
The example below sets the following correlation IDs:
1st message (attribute 11) --> MSG_ID_1
2nd message (attribute 12) --> MSG_ID_2
This ensures uniqueness on the queue and enables external systems to send response messages in orders which are different than originally sent by the
DeliveryMDB.
Processing type
Two values are supported:
• ◦ SSYYN
NCC will cause the DeliveryMDB to wait for a reply on the response queue. See timeout attribute 4.
4 of 17 2/10/2023, 8:47 PM
How to setup TAFC CALLJEE in IBM Websphere? https://basecamp.temenos.com/s/article-detail/a042K00001LAtfUQAT/how-to-setup-tafc-callj...
◦ A
ASSYYN
NCC will cause the DeliveryMDB to place message on request queue and not wait for a response.
((//ss//)) C
Coom
mmmu
unniittyy LLeea
arrn
n PPrro
oddu
uccttss TTrra
aiin
niin
ngg D
Doow
wnnllo
oaad
dss SSu
uggg
geesstt ((//ss//iid
deea
attiio
onn))
Timeout
A total value in milliseconds specifying how long the DeliveryMDB will wait for all messages to be processed.
<5> RESERVED
<6> RESERVED
<7> RESERVED
<8> RESERVED
<9> RESERVED
<10> RESERVED
The messages should therefore be assigned to attributes 11 and greater. The following example places two JMS messages on the request queue and then waits
until both responses have been received.
5 of 17 2/10/2023, 8:47 PM
How to setup TAFC CALLJEE in IBM Websphere? https://basecamp.temenos.com/s/article-detail/a042K00001LAtfUQAT/how-to-setup-tafc-callj...
PROGRAM HELLO_WORLD
((//ss//)) C
Coom
mmmu
unniittyy LLeea
arrn
n PPrro
oddu
uccttss TTrra
aiin
niin
ngg D
Doow
wnnllo
oaad
dss SSu
uggg
geesstt ((//ss//iid
deea
attiio
onn))
INCLUDE JBC.h
ACTIVATION = "DELIVERY"
INFO = ""
INFO<1> = "HELLO_MESSAGE"
INFO<2> = ""
INFO<3> = "SYNC"
INFO<4> = "3000"
INFO<5> = ""
INFO<6> = ""
INFO<7> = ""
INFO<8> = ""
INFO<9> = ""
INFO<10> = ""
IF SYSTEM(0) EQ 0 THEN
CRT "OK"
END ELSE
END
6 of 17 2/10/2023, 8:47 PM
How to setup TAFC CALLJEE in IBM Websphere? https://basecamp.temenos.com/s/article-detail/a042K00001LAtfUQAT/how-to-setup-tafc-callj...
((//ss//)) C
Coom
mmmu
unniittyy LLeea
arrn
n PPrro
oddu
uccttss TTrra
aiin
niin
ngg D
Doow
wnnllo
oaad
dss SSu
uggg
geesstt ((//ss//iid
deea
attiio
onn))
ERROR.CODE = JEEActivate(JEECON,ACTIVATION,INFO)
IF ERROR.CODE NE 0 THEN
END
JEEClose(JEECON)
END
The order in which messages are placed on the request queue follows a sequential order, i.e. message on attribute 11 first, then message on attribute 12, etc. The external
system is allowed to send the responses back in a different order since the JMS Correlation ID ensures uniqueness in a queue. When the processing type is SYNC, the
DeliveryMDB will wait until it has received a response for each respective request or until the timeout value has been reached.
The activation specification in the application server deployment descriptor specifies that a DeliveryMDB instance will be executed each time a message arrives at the
inbound T24 Resource Adapter and the activation string of the message matches the activation specification of the DeliveryMDB:
AAccttiivva
attiio
onn ssp
peecciiffiicca
attiio
onn JJN
NDDII n
naam
mee::
JBoss Weblogic Websphere
tocfT24ra-ra.rar [RAR mapping] jca/t24ResourceAdapter jca/t24ResourceAdapter
The ejb-jar.xml defines the following resource references to locate the
1. JMS connection factory – to create a JMS session and place the request on the request queue
2. request queue - to send the request to the external system.
3. response queue – to receive the response from the external system.
RReesso
ouurrccee rreeffeerreen
ncceess JJN
NDDII n
naam
meess::
Resource reference / App. Server JBoss Weblogic Websphere
jms/jmsConnectionFactory jms/jmsConnectionFactory jms/t24QueueCxFactory jms/t24QueueCxFactory
queue/requestQueue queue/requestQueue jms/requestQueue jms/requestQueue
queue/responseQueue queue/responseQueue jms/responseQueue jms/responseQueue
If the DeliveryMDB has not been enlisted into a global transaction propagated by CALLJEE, it will use a transacted JMS session to ensure that either all or none of the
messages are placed on the JMS request queue. The DeliveryMDB should be configured to one of the following modes:
• Use Bean Managed Transaction demarcation (BMTD) and a non XA enabled JMS connection factory
• Use Container Managed Transaction demarcation (CMTD) and a XA enabled JMS connection factory
7 of 17 2/10/2023, 8:47 PM
How to setup TAFC CALLJEE in IBM Websphere? https://basecamp.temenos.com/s/article-detail/a042K00001LAtfUQAT/how-to-setup-tafc-callj...
33.. IBM websphere ((//ss//)) C
Coom
mmmu
unniittyy LLeea
arrn
n PPrro
oddu
uccttss TTrra
aiin
niin
ngg D
Doow
wnnllo
oaad
dss SSu
uggg
geesstt ((//ss//iid
deea
attiio
onn))
Version: 7.0.0.0+
Configure the following components in Websphere's Administrative
IIn
nsstta allll TT2244 RRA
A::
Resource Adapters
Install tto occffTT2244rra
a--rraa..rra
arr using default values
Resource adapters > T24RA > J2C activation specification
Set activation specification which is used by the RA to configure a specific endpoint instance
- NAME: T24 Resource Adapter
- JNDI NAME: jca/t24ResourceAdapter
Resource adapters > T24RA > J2C connection factories
Define new JCA connection factory
- NAME: T24 JCA Connection Factory
- JNDI NAME: jca/t24ConnectionFactory
CCo on nffiig
gu urree tth hee ''lliisstteen
nh hoosstt'' w
wiitth
h tthhee IIPP a
addd
drreessss o
off tth
hee h
hoosstt w
whheerree JJM
MSS q
quueeu
uee((W
WAASS)) iiss d
deep
pllo
oyyeed
daan
ndd ''lliisstteen
nppo
orrtt'' w
wiitth
haan
nyy p
poorrtt ((5555000066:: D
Deeffa
auulltt))
8 of 17 2/10/2023, 8:47 PM
How to setup TAFC CALLJEE in IBM Websphere? https://basecamp.temenos.com/s/article-detail/a042K00001LAtfUQAT/how-to-setup-tafc-callj...
((//ss//)) C
Coom
mmmu
unniittyy LLeea
arrn
n PPrro
oddu
uccttss TTrra
aiin
niin
ngg D
Doow
wnnllo
oaad
dss SSu
uggg
geesstt ((//ss//iid
deea
attiio
onn))
CCo
onnffiig
guurree JJM
MSS M
Meessssa
aggiin
nggU
Ussiin
nggW
Weeb
bSSp
phheerree M
MQQM
Meessssa
aggiin
ngg PPrro
ovviid
deerr
Download Websphere MQ from IBM Website and install the product following the instructions available on the IBM Website.
This section of the document explains the minimum required steps to configure MQ alongside the JCA architecture.
After installing the MQ server, user need to login to the system (UNIX/Windows) as the MQ user defined during installation and create Queue Manager and Queues.
CCrreea
attee Q
Quueeu
uee M
Maan
naag
geerr
To create queue manager issue the following command.
ccrrttm
mqqmm ––q
qQQuueeuuee..M
Maannaaggeerr..N
Naam
mee
SSttaarrtt Q Qu ueeu
uee M
Maan
naag
geerr
Before creating Queues user needs to start the Queue Manager defined in the previous step. To start the Queue Manager issue the following command
ssttrrm
mqqmmQ Qu
ueeu
uee..M
Maan na
aggeerr..N
Na mee --> to start Queue.Manager.Name
am
Also make note of the following commands:
eennd dm
mqqm
mQQuueeuuee..M
Maan
naag
geerr..NNa
ammee ---->> to stop Queue.Manager.Name
ddllttm
mqqm
mQQu
ueeuuee..M
Maanna
aggeerr..N
Na mee ---->> to delete Queue.Manager.Name
am
QQu
ueeu
ueess
We need to define two queues for the simple JCA architecture.
9 of 17 2/10/2023, 8:47 PM
How to setup TAFC CALLJEE in IBM Websphere? https://basecamp.temenos.com/s/article-detail/a042K00001LAtfUQAT/how-to-setup-tafc-callj...
10 of 17 2/10/2023, 8:47 PM
How to setup TAFC CALLJEE in IBM Websphere? https://basecamp.temenos.com/s/article-detail/a042K00001LAtfUQAT/how-to-setup-tafc-callj...
--> Switch to tab 'Local Topology' and add a new Bus member
Service Integration Bus > Buses > BrowserBus > Bus members > T24 MQ Server
--> Select (check) the option called 'Override WebSphere MQ server connection properties'
--> Create a new JMS connection factory using e.g. the 'Websphere MQ messaging Provider'
--> Create a new JMS Queue connection factory using e.g. the 'Websphere MQ messaging Provider'
11 of 17 2/10/2023, 8:47 PM
How to setup TAFC CALLJEE in IBM Websphere? https://basecamp.temenos.com/s/article-detail/a042K00001LAtfUQAT/how-to-setup-tafc-callj...
--> Create a new JMS Queue connection factory using e.g. the 'Websphere MQ messaging Provider'
--> Create a new JMS Queue connection factory using e.g. the 'Websphere MQ messaging Provider'
JJM
MSS q
quueeuueess a
annd
d JJN
NDDII''ss::
12 of 17 2/10/2023, 8:47 PM
How to setup TAFC CALLJEE in IBM Websphere? https://basecamp.temenos.com/s/article-detail/a042K00001LAtfUQAT/how-to-setup-tafc-callj...
((//ss//)) C
Coom
mmmu
unniittyy LLeea
arrn
n PPrro
oddu
uccttss TTrra
aiin
niin
ngg D
Doow
wnnllo
oaad
dss SSu
uggg
geesstt ((//ss//iid
deea
attiio
onn))
--> Create a new Activation specification using e.g. the 'WebSphere MQ messaging Provider'
- Click Test Connection Button: Should see the message 'A connection was successfully made to WebSphere MQ.'
IIn
nsstta
allll TTO
OCCFF((EEEE))::
Enterprise Applications
--> Install tto
occffeeee..eea
arr using default values. The following warnings can be ignored at this stage:
ADMA0114W: Resource assignment with JNDI name eeiiss//cco omm..tteemmeen nooss..tto
occff..cco
ommmmo onn..jjcca
a..O
OFFSSM
Meessssa
aggeeLLiisstteen
neerr is not found …
ADMA0114W: Resource assignment with JNDI name jjcca a//tt2244PPllu
uggiin
nssRReessoouurrcceeA Adda
apptteerr is not found …
ADMA0115W: Resource assignment of name q quueeu
uee//rreeqquueessttQ Quueeuuee and type javax.jms.Queue, with JNDI name jms/requestQueue is not found...
ADMA0115W: Resource assignment of name q quueeu
uee//rreessppo onnsseeQQu ueeu
uee and type javax.jms.Queue, with JNDI name jms/responseQueue is not found…
Enterprise Applications > TOCF(EE)_EAR > Manage Modules > TOCFPLUGIN > Resource Adapter > J2C Activation specifications >
com.temenos.tocf.common.jca.OFSMessageListener
13 of 17 2/10/2023, 8:47 PM
How to setup TAFC CALLJEE in IBM Websphere? https://basecamp.temenos.com/s/article-detail/a042K00001LAtfUQAT/how-to-setup-tafc-callj...
--> Set activation specification for the TOCF(EE) Plugin component
- NAME: T24 Plugin ((//ss//))Resource
C
CoomAdapter
mmmuun
niittyy LLeea
arrn
n PPrro
oddu
uccttss TTrra
aiin
niin
ngg D
Doow
wnnllo
oaad
dss SSu
uggg
geesstt ((//ss//iid
deea
attiio
onn))
- JNDI NAME: jca/t24PluginsResourceAdapter
Enterprise Applications
---->> SStta
arrtt TTO
OCCFF((EEEE))__EEAARR
RReesso ou urrccee RReeffeerreen nccee::
TTeesstt ssccrreeeen
n ssh
ho ottss::
MMQ Qq qu ueeuueess w
wiitth
hoou utt a
annyy m
meessssa
aggeess::
14 of 17 2/10/2023, 8:47 PM
How to setup TAFC CALLJEE in IBM Websphere? https://basecamp.temenos.com/s/article-detail/a042K00001LAtfUQAT/how-to-setup-tafc-callj...
((//ss//)) C
Coom
mmmu
unniittyy LLeea
arrn
n PPrro
oddu
uccttss TTrra
aiin
niin
ngg D
Doow
wnnllo
oaad
dss SSu
uggg
geesstt ((//ss//iid
deea
attiio
onn))
Executing the HELLO_WORLD program which post 2 messages onto a JMS queue.
15 of 17 2/10/2023, 8:47 PM
How to setup TAFC CALLJEE in IBM Websphere? https://basecamp.temenos.com/s/article-detail/a042K00001LAtfUQAT/how-to-setup-tafc-callj...
((//ss//)) C
Coom
mmmu
unniittyy LLeea
arrn
n PPrro
oddu
uccttss TTrra
aiin
niin
ngg D
Doow
wnnllo
oaad
dss SSu
uggg
geesstt ((//ss//iid
deea
attiio
onn))
0 Comments
PPo
osstt Q
Quueessttiio
onn
Sort by:
16 of 17 2/10/2023, 8:47 PM
How to setup TAFC CALLJEE in IBM Websphere? https://basecamp.temenos.com/s/article-detail/a042K00001LAtfUQAT/how-to-setup-tafc-callj...
((//ss//)) C
Coom
mmmu
unniittyy LLeea
arrn
n PPrro
oddu
uccttss TTrra
aiin
niin
ngg D
Doow
wnnllo
oaad
dss SSu
uggg
geesstt ((//ss//iid
deea
attiio
onn))
Collaborate here!
Here's where you start talking with your colleagues about this.
17 of 17 2/10/2023, 8:47 PM