Use the createSIBDestination command to create a new bus destination for a service integration bus.
This command provides only a subset of the properties available. If you want to set other properties, you need to use the administrative console or wsadmin and JACL
To run the command, use the AdminTask object of the wsadmin scripting client.
This command is only valid when used with WebSphere® Application Server Version 6 and later application servers. Do not use it with earlier versions.
Command-line help is provided for service integration bus commands:
wsadmin> $AdminTask help SIBAdminCommands
wsadmin> $AdminTask help command_name
For additional details of the command properties, see the related reference topic.
The createSIBDestination command creates a new bus destination for a service integration bus. With this command, a messaging destination can also be localized to a WebSphere MQ server bus member.
To save the changes made by the command, invoke the "save" command on the AdminConfig object.
None.
When service integration converts a message from the service integration format to WebSphere MQ format, by default it includes a WebSphere MQ RHF2 in the WebSphere MQ message. This header contains message attributes, such as JMS message attributes, which are not WebSphere MQ message attributes and therefore do not appear in the MQMD WebSphere MQ message descriptor. Some WebSphere MQ applications cannot process messages which include an RFH2. If messages sent to this destination will be processed by WebSphere MQ applications which cannot tolerate an RFH2, specify FALSE.
Possible values are:Determines the service integration quality of service level property for WebSphere MQ messages that are received by service integration from a WebSphere MQ network. The messages in a WebSphere MQ network have their own quality of service level that is determined by WebSphere MQ. However when these messages are received by a service integration application, they are assigned a service integration quality of service level property that depends on their WebSphere MQ quality of service level.
For example, if a WebSphere MQ message is persistent, using this attribute, you can specify that a service integration application which examines the quality of service level will observe best effort nonpersistent, express nonpersistent, reliable nonpersistent, reliable persistent or assured persistent (the default is assured persistent).
Possible values are:
For non-transactional JMS message-driven beans and MessageListeners that use a JMS destination configured on the default messaging provider, best-effort nonpersistent messages are not recoverable. In this case, if a message is unlocked because the message-driven bean or MessageListener threw an exception, then the message is not redelivered or sent to the exception destination because it was deleted from the message store when it was passed to the listener. If you require higher message reliability for non-transactional JMS message-driven beans and MessageListeners, configure a different option for the Maximum reliability property of the bus destination.
Determines the service integration quality of service level property for WebSphere MQ messages that are received by service integration from a WebSphere MQ network. The messages in a WebSphere MQ network have their own quality of service level that is determined by WebSphere MQ. However when these messages are received by a service integration application, they are accorded a service integration quality of service level property that depends on their WebSphere MQ quality of service level.
For example, if a WebSphere MQ message is nonpersistent, using this attribute, you can specify that a service integration application which examines the quality of service level will observe best effort nonpersistent, express nonpersistent, reliable nonpersistent, reliable persistent or assured persistent (the default is reliable nonpersistent).
Possible values (as previously described) are:
For the message point, any open consumers change state and an exception is generated if the consumer requests a message. Messages can continue to be sent, and accumulate on the message point.
At runtime, this property has priority over other configuration property values. For information on the configuration properties that are overridden at runtime, see Strict message ordering for bus destinations.
wsadmin>$AdminTask createSIBDestination {-bus abus -name myqueue -type QUEUE -cluster cluster1} (cells/9994GKCCell01/buses/abus|sib-destinations.xml#SIBQueue_1098215169998)