WebSphere WebSphere Application Server Express, Version 6.0.x Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Modifying a new JMS connection factory through the command line

Use this command to change the properties of a JMS connection factory for the default messaging provider at a specific scope.

Before you begin

The command described in this topic is run using the AdminTask object of the wsadmin scripting client.

This command is only valid when run against WebSphere Application Server Version 6 application servers. Do not run it against earlier versions.

Command-line help is provided with each of the service integration technologies commands:
  • For a list of all the available service integration bus JMS commands, plus a brief description of each command, type the following command:
    wsadmin> $AdminTask help SIBJMSAdminCommands
  • For detailed help on a given command, enter the following command:
    wsadmin> $AdminTask help command_name

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

Purpose

This command changes the properties of a JMS connection factory.

Command name
modifySIBJMSConnectionFactory
Target
A JMS connection factory.
Result
A JMS connection factory (modified).

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

Required Parameters

None.

Optional Parameters

-name factory_name
-jndiName jndi_name
-authDataAlias alias_name
-xaRecoveryAuthAlias alias_name
-category category
-description text
-logMissingTransactionContext True | False
-manageCachedHandles True | False
-busName name
-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

Example

wsadmin>$AdminConfig getid /Node:9994GKCNode01
9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)

wsadmin>$AdminTask modifySIBJMSConnectionFactory jmsqcf2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#J2CConnectionFactory_1098736176544)
 {-manageCachedHandlers True}
jmsqcf2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#J2CConnectionFactory_1098733675578)
Related information
JMS connection factory settings
JMS queue connection factory settings
JMS topic connection factory settings

Reference topic

Terms of Use | Feedback

Last updated: 2 Aug 2005
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.pmc.express.doc\ref\rjn_jmscf_modify.html

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