Broker 10.5 | webMethods Broker Documentation | webMethods Broker Messaging Programmer's Guide | webMethods Messaging Administration | JMSAdmin Command Reference | JMSAdmin Command Descriptions | Create Broker
 
Create Broker
Creates a new Broker on the specified Broker Server. When you create Brokers, the JMS client groups (IS-JMS, JMSClient, and EventMembers) and Broker objects (JMS::Temporary::Queue, JMS::Temporary::Topic, Event::WebM::EventSubscriptionMgmt::SubscriptionChange, and Event::WebM::Deployment) are created by default.
By default, the "can-publish" and "can-subscribe" permissions for Broker objects:
*JMS::Temporary::Queue andJMS::Temporary::Topic are assigned to IS-JMS and JMSClient.
*Event::WebM::EventSubscriptionMgmt::SubscriptionChange is assigned to EventMembers.
Syntax
create [ default ] broker broker-name [ on server[:port] ]
The command syntax has these parts:
Part
Description
default
Optional. If you specify this parameter, the new Broker is designated as the default Broker on the specified server.
broker
Required. The name of the new Broker on the Broker Server. Broker names must agree with the following rules:
*The first character cannot be a pound sign (#).
*The name cannot contain the at sign (@), forward slash ( /), or colon (:).
*The name cannot exceed 255 bytes.
*If the name contains a space, enclose broker-name in quotes.
server
Optional. The name of the Broker Server.
If you omit this parameter, JMSAdmin will attempt to create a Broker on the Broker Server running on localhost.
port
Optional. The port number for the default Broker Server.
If you omit this parameter, JMSAdmin will use port 6849 when creating the new Broker.
Remarks
JMSAdmin automatically connects to the new Broker when this command completes.
Examples
The following command sequence creates a Broker, initializes that Broker, and then ends the connection:
> create broker "JMS Broker #6" on testserver:8849
> initialize broker
> disconnect
The following command creates a Broker called JMS Broker #6 on the Broker Server running on localhost at port 6849:
\> create broker "JMS Broker #6"
Related Commands
Connect
Delete Broker
Disconnect
Initialize Broker