Use the createSIBMQLink command to create a new WebSphere® MQ link for a specified service integration bus.
To run the command, use the AdminTask object of the wsadmin scripting client.
print AdminTask.help('SIBAdminCommands')
print AdminTask.help('command_name')
AdminConfig.save()
The createSIBMQLink command creates a new WebSphere MQ link for a specified service integration bus. The WebSphere MQ link connects a messaging engine as a queue manager to WebSphere MQ, thereby providing a bridge between a service integration bus and a WebSphere MQ network.
A bus.
The queue manager name must conform to the WebSphere MQ naming conventions; for example, the name must be a maximum of 48 characters.
None.
The batch size does not affect the way the sender and receiver channels for this link transfer messages. Messages are always transferred individually, but are committed or backed out as a batch.
For more information about choosing the batch size, see the description of the batch size (BATCHSZ) property in the Intercommunication section of the WebSphere MQ information center.
Default | 50 |
Range | 1 through 9999 |
For information about how to choose an appropriate number, see the description of the Maximum message length (MAXMSGL) property in the Intercommunication section of the WebSphere MQ information center.
Default | 4194304 bytes (4MB) |
Range | 0 through 104857600 Specify 0 to use the largest value that the target queue manager will honor. |
Heartbeats give the receiving channel the opportunity to quiesce the channel connection.
For more information about choosing the value for this property, see the Intercommunication section of the WebSphere MQ information center.
Default | 300 seconds |
Range | 0 through 999999 |
For more information about choosing the value for this property, see the description of the Sequence Number wrap (SEQWRAP) property in the Intercommunication section of the WebSphere MQ information center.
Default | 999999999 |
Range | 1 through 999999999 |
Default | Fast |
Range |
|
If you set this option to True, the WebSphere MQ sender channels might reestablish a connection to this WebSphere MQ link in the event that a communications failure has occurred and the link has not yet detected the failure condition.
Default | True |
Default | Started |
Range |
|
This name must be the same as the name of the receiver channel on WebSphere MQ.
For more information about choosing channel names, see the description of the channel name (CHANNEL) property in the Intercommunication section of the WebSphere MQ information center.
Type the host name or IP address of the host on which the gateway queue manager runs.
If this field is blank, the gateway queue manager is assumed to be running on the same host as the messaging engine on which the WebSphere MQ link is defined.
Default | 1414 |
Range | 0 through 65535 |
The default value is a reasonable interval. Change this value only if you understand the implications for performance, and you need a different value for the requirements of the traffic flowing down your channels.
Performance is affected by the value specified for the disconnect interval. A very low value (a few seconds) can cause an unacceptable amount of processing in constantly starting up the channel. A very large value (more than an hour) might mean that system resources are unnecessarily held up.
If you want your channels to be active only when there are messages for them to transmit, you should set the disconnect interval to a fairly low value. Note that the default setting is quite high and so is not recommended for channels where this level of control is required. Because it is difficult to interrupt the receiving channel, the most economical option is to have the channel automatically disconnect and reconnect as the workload demands. For most channels, the appropriate setting of the disconnect interval can be established heuristically.
Default | 900 seconds |
Range | 0 through 999999 A value of 0 (zero) means never disconnect; the channel waits indefinitely for messages. |
For more information about using retry mechanisms with WebSphere MQ, see the Intercommunication section of the WebSphere MQ information center.
Default | 10 |
Range | 0 through 999999999 |
For more information about using retry mechanisms with WebSphere MQ, see the Intercommunication section of the WebSphere MQ information center.
Default | 60 seconds |
Range | 0 through 999999 |
For more information about using retry mechanisms with WebSphere MQ, see the Intercommunication section of the WebSphere MQ information center.
Default | 999999999 |
Range | 0 through 999999999 |
For more information about using retry mechanisms with WebSphere MQ, see the Intercommunication section of the WebSphere MQ information center.
Default | 1200 seconds |
Range | 0 through 999999 |
Default | Started |
Range |
|
This name must be the same as the name of the sender channel on WebSphere MQ.
This reliability delivery option is assigned to all WebSphere MQ nonpersistent messages flowing over this receiver channel.
Default | Reliable |
Range |
|
Default | Assured |
Range |
|
Default | Started |
Range |
|
This option is supported only when used by a JMS application that is running with a WebSphere Application Server Version 7.0 server or client, and that is connected to a messaging engine running on WebSphere Application Server Version 7.0 server. Use on previous versions of WebSphere Application Server will result in an exception to the application.
Default | TRUE |
Range |
|
AdminTask.createSIBMQLink('[-bus bus1 -messagingEngine cluster1.000-bus1 -name myMQLink2 -foreignBusName MQNetwork2 -queueManagerName MQMgrIPL -senderChannelTransportChain OutboundBasicMQLink]') 'myMQLink2(cells/cell01/nodes/node01/servers/server1|sib-engines.xml# SIBMQLink_1132607756126)'
Create a SIBMQLink that uses queue points on the same messaging engine as the target destination, whenever possible.
AdminTask.createSIBMQLink('[-bus bus1 -messagingEngine cluster1.000-bus1 -name MyMQLink -foreignBusName -MQQMgr1 -queueManagerName bus1 -senderChannelTransportChain OutboundBasicMQLink -preferLocal TRUE]')