Use this task to define new outbound chains using the wsadmin utility.
The chains created can be used for interoperating with WebSphere MQ.
Why and when to perform this task
The channels used to build an outbound chain determine with which
configurations of the WebSphere MQ queue manager sender channel a network
connection can be successfully established. The following table shows all
the valid chain configurations and describes the configuration of WebSphere
MQ queue manager sender channel with which they can be used to establish a
connection.
WebSphere MQ channel |
TCP channel |
SSL channel |
MQFAP channel |
Unsecured WebSphere MQ channel |
X |
|
X |
WebSphere MQ channel secured using SSL |
X |
X |
X |
For example, an SSL-based chain would consist of a TCP channel,
SSL channel and MQFAP channel. When creating chains, the order of channels
in the chain is important. You must specify channels in the order (left to
right) in which they appear in the above table.
The example in this
topic describes how to create an outbound chain capable of being used to contact
WebSphere MQ queue manager receiver channels using SSL-based encryption
Steps for this task
- Locate the TransportChannelService object for the server in which
you wish to create the new chain. For example in a network deployment configuration,
you can list the available TransportChannelService objects and select the
appropriate service as follows:
wsadmin> $AdminConfig list TransportChannelService
(cells/BadgerCell01/nodes/BadgerCellManager01/servers/dmgr|server.xml#TransportChannelService_1)
(cells/BadgerCell01/nodes/BadgerNode01/servers/nodeagent|server.xml#TransportChannelService_1095711814579)
(cells/BadgerCell01/nodes/BadgerNode01/servers/server1|server.xml#TransportChannelService_1095712023139)
(cells/BadgerCell01/nodes/BadgerNode01/servers/server2|server.xml#TransportChannelService_1095712039302)
wsadmin> set tcs [lindex [$AdminConfig list TransportChannelService] 2]
(cells/BadgerCell01/nodes/BadgerNode01/servers/server1|server.xml#TransportChannelService_1095712023139)
- Define an outbound TCP channel called testTCPChannel:
wsadmin>set tcpChannel [$AdminConfig create TCPOutboundChannel $tcs "{name testTCPChannel}"]
testTCPChannel(cells/BadgerCell01/nodes/BadgerNode01/servers/server1|server.xml#TCPOutboundChannel_1095969213949)
- Define an outbound SSL channel called testSSLChannel. There are
two steps required to define such a channel.
- Identify the SSL alias to be used by the channel.
wsadmin>foreach obj [$AdminConfig list SSLConfig] { puts "$obj [$AdminConfig show $obj alias]]" }
(cells/BadgerCell01|security.xml#SSLConfig_1) {alias BadgerCellManager01/DefaultSSLSettings}]
(cells/BadgerCell01|security.xml#SSLConfig_1095711819776) {alias BadgerNode01/DefaultSSLSettings}]
- Create an SSL channel as in the following example, in which
the BadgerNode01/DefaultSSLSettings alias is used:
wsadmin>set sslChannel [$AdminConfig create SSLOutboundChannel $tcs "{name testSSLChannel} (sslConfigAlias BadgerNode01/DefaultSSLSettings}"]
testSSLChannel(cells/BadgerCell01/nodes/BadgerNode01/servers/server1|server.xml#SSLOutboundChannel_1095971760671)
- Define an outbound MQFAP channel called testMQFAPChannel:
wsadmin>set mqfapChannel [$AdminConfig create MQFAPOutboundChannel $tcs "{name testMQFAPChannel}"]
testMQFAPChannel(cells/BadgerCell01/nodes/BadgerNode01/servers/server1|server.xml#MQFAPOutboundChannel_1095977512682)
- Finally, create the channel chain by combining the channels defined
so far. For example, to create a chain called testChain:
wsadmin>$AdminConfig create Chain $tcs "{name testChain} {enable true} {transpor
tChannels {$tcpChannel $sslChannel $mqfapChannel}}"
testChain(cells/BadgerCell01/nodes/BadgerNode01/servers/server1|server.xml#Chain_109
5977640896)