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

Modifying a messaging engine through the command line

Use this command to change properties of a messaging engine for a bus member.

Before you begin

This command provides only a subset of the properties available. If you want to show other properties, you need to use the administrative console or wsadmin and JACL

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 modifies the properties of a messaging engine.

Command name
modifySIBEngine
Target
None.
Result
A messaging engine object (modified).

To save the changes made by the command, invoke the "save" command on the AdminConfig 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.

Conditional Parameters

-node nodename -server servername
To change properties of a messaging engine for an application server as a bus member, specify both the name of the node on which the server runs and the name of the server.
-cluster cluster
To change properties of a messaging engine for a server cluster as a bus member, specify the name of the cluster.

This option should be used only in WebSphere Application Server environments that support server clusters.

-engine enginename
If the bus member has only one messaging engine, you do not need to specify the engine name. If the bus member has several messaging engines, you must specify the name of the engine for which you want to change properties.

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 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.

Example

wsadmin>$AdminTask showSIBEngine {-bus abus -cluster cluster1 -engine cluster1.001-abus}
{busUuid=E90C76CC83FEA6F9, description=Messaging engine for server1 of cluster1,
 highMessageThreshold=999999999, name=cluster1.001-abus, initialState=STARTED,
 busName=abus, uuid=6A4A980750CB1D2D}
wsadmin>$AdminTask modifySIBEngine {-bus abus -cluster cluster1 -engine cluster1.001-abus
 -initialState STOPPED}
cluster1.001-abus(cells/9994GKCCell01/clusters/cluster1|sib-engines.xml#SIBMessagingEngine_1098182309278)
wsadmin>$AdminTask showSIBEngine {-bus abus -cluster cluster1 -engine cluster1.001-abus}
{busUuid=E90C76CC83FEA6F9, description=Messaging engine for server1 of cluster1,
 highMessageThreshold=999999999, name=cluster1.001-abus, initialState=STOPPED,
 busName=abus, uuid=6A4A980750CB1D2D}

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\rjk_cli_me_modify.html

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