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

Creating a new messaging engine through the command line

Use this command to create a new messaging engine for a cluster bus member.

Before you begin

When you create a service integration bus, and add a server or a cluster member to that bus, a messaging engine with default settings is created automatically.

Each server bus member has exactly one messaging engine. Cluster bus members can support additional engines. If you create a messaging engine for a cluster, you must explicitly configure both the data store and the JDBC data source that the messaging engine uses to interact with the data store. You must create the data source at cluster scope, not node scope. For more information about creating messaging engines, see Configuring a data source for a messaging engine running in a cluster.

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 commands, plus a brief description of each command, type the following command:
    wsadmin> $AdminTask help SIBAdminCommands
  • 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 creates a new messaging engine for a cluster bus member.

Command name
createSIBEngine
Target
None.
Result
A messaging engine object.

Required Parameters

-bus busname
The name of the service integration bus on which the bus member is configured. You can use the listSIBuses command to list the names of existing buses.
-cluster cluster
To create a messaging engine for a server cluster as a bus member, specify the name of the cluster.
-datasourceJndiName datasource
The JNDI name of the data source that the messaging engine uses to access the relational database management system (RDBMS) for the data store.

Conditional Parameters

None.

Optional Parameters

-description text
An optional description for the messaging engine, for administrative purposes.
-initialState STARTED | STOPPED
The initial state determines whether the messaging engine is started automatically when the server or server cluster is started.
Stopped
When the associated application server is started, the messaging engine is started and is available to process messages.
Started
When the associated application server is started, the messaging engine is stopped and is not available to process messages.
-highMessageThreshold number
The maximum total number of messages that the messaging engine can place on its message points.

When the messaging engine is created, the high message threshold of the bus is used to set the default value for this property. When a message point is created on this messaging engine, the value of this property is used to set the default high message threshold for the message point.

-createDefaultDatasource TRUE | FALSE
Set this to true if a default data source should be created when the messaging engine is created.

Example

install_root/bin>wsadmin -conntype SOAP -port 8879 WASX7209I: Connected to process
"dmgr" on node 9994GKCCellManager01 using SOAP connector;  The type of process
is: DeploymentManager WASX7029I: 
For help, enter: "$Help help" wsadmin>$AdminTask
wsadmin>$AdminTask listSIBEngines {-bus abus}
cluster1.000-abus(cells/9994GKCCell01/clusters/cluster1|sib-engines.xml#SIBMessagingEngine_1098181503570)
wsadmin>$AdminTask createSIBEngine {-bus abus -cluster cluster1 -datasourceJndiName eis/cluster1me3}
cluster1.001-abus(cells/9994GKCCell01/clusters/cluster1|sib-engines.xml#SIBMessagingEngine_1098182419216)

wsadmin>$AdminTask listSIBEngines {-bus abus -cluster cluster1}
cluster1.000-abus(cells/9994GKCCell01/clusters/cluster1|sib-engines.xml#SIBMessagingEngine_1098181503570)
cluster1.001-abus(cells/9994GKCCell01/clusters/cluster1|sib-engines.xml#SIBMessagingEngine_1098182419216)

Reference topic

Terms of Use | Feedback

Last updated: 5 Oct 2005
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.pmc.nd.doc\ref\rjk_cli_me_create.html

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