Creating a new JMS connection factory using the wsadmin tool

Use this command to create a new JMS connection factory for the default messaging provider at a specific scope.

To run the command, use the AdminTask object of the wsadmin scripting client.

[iSeries] The wsadmin scripting client is run from Qshell. For more information, see the topic "Configure Qshell to run WebSphere® Application Server scripts".

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:

For additional details of the command properties, see the related reference topic.

Purpose

This command creates a new JMS connection factory at a specific scope.

Command name
createSIBJMSConnectionFactory
Target
Scope of the default messaging provider at which the JMS connection factory is to be created.
Result
A JMS connection factory.

To save the changes made by the command, invoke the "save" command on the AdminConfig object.

Required parameters

-name factory_name
-jndiName jndi_name
-busName name

Optional parameters

-type queue | topic
-authDataAlias alias_name
-xaRecoveryAuthAlias alias_name
-category category
-description text
-logMissingTransactionContext True | False
-manageCachedHandles True | False
-clientID id
-userName name
-password password
-durableSubscriptionHome me_name
-nonPersistentMapping BestEffortNonPersistent | ExpressNonPersistent | ReliableNonPersistent |
    ReliablePersistent | AssuredPersistent | AsSIBDestination | None
-persistentMapping BestEffortNonPersistent | ExpressNonPersistent | ReliableNonPersistent |
    ReliablePersistent | AssuredPersistent | AsSIBDestination | None
-durableSubscriptionHome me_name
-readAhead Default | AlwaysOn | AlwaysOff
-target target_name
-targetType BusMember | Custom | ME
-targetSignificance Preferred | Required
-targetTransportChain transport_chain
-providerEndPoints tuple_list
-connectionProximity Bus | Host | Cluster | Server
-tempQueueNamePrefix prefix
-tempTopicNamePrefix prefix
-shareDataSourceWithCMP True | False
-shareDurableSubscriptions AsCluster | AlwaysShared | NeverShared

The type parameter is used to specify the type of connection factory to create. To create a queue connection factory, set this to Queue. To create a topic connection factory, set this parameter to Topic. Leave this parameter unset to create a generic connection factory.

Example

wsadmin>$AdminConfig getid /Node:9994GKCNode01
9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
wsadmin>$AdminTask createSIBJMSConnectionFactory 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
 {-name jmscf1 -jndiName jms/jmscf1 -busName abus}
jmscf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#J2CConnectionFactory_1098733325084)
wsadmin>$AdminTask createSIBJMSConnectionFactory 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
 {-name jmsqcf2 -jndiName jms/jmsqcf1 -busName abus -type queue}
jmsqcf2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#J2CConnectionFactory_1098733675578)



Related reference
JMS resource administrative commands
Reference topic    

Terms of Use | Feedback

Last updated: Feb 19, 2011 5:25:36 AM CST
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v610web&product=was-nd-mp&topic=rjn_jmscf_create
File name: rjn_jmscf_create.html