WebSphere WebSphere Application Server Network Deployment, Version 6.1.x Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows, z/OS

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.

For i5/OS platforms 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)

Reference topic

Terms of use | Feedback


Timestamp icon Last updated: 26 February 2009
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.pmc.nd.multiplatform.doc/ref/rjn_jmscf_create.html

Copyright IBM Corporation 2004, 2009. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)