API Exceptions
This appendix describes the exceptions that are unique to the webMethods Broker Java administrative API. Other possible exceptions are described in the webMethods Broker Client Java API Programmer’s Guide.
BrokerDependencyException
Your request to destroy a client group or an event type (without the force--destroy option) could not be completed because there are Broker clients that depend on the group or event type.
BrokerExistsException
You have attempted to create a Broker with a name that is already being used by another Broker on the same Broker Server.
BrokerInClusterException
You have attempted to destroy a Broker that is currently part of a cluster or you have attempted to add a Broker to a cluster when it is already a member of a cluster.
BrokerIncompatibleVersionException
You have attempted to perform an operation on a Broker Server that is not supported. This results from the Broker Server in question having an earlier version number than the API that your client is using.
BrokerInTerritoryException
You have attempted to destroy a Broker that is currently part of a territory or you have attempted to add a Broker to a territory when it is already a member of a territory.
BrokerInvalidAccessListException
The Access Control List you specified is not valid.
BrokerInvalidBrokerNameException
The Broker name you specified contains illegal characters. See the appendix in the webMethods Broker Client Java API Programmer’s Guide for details on naming rules.
BrokerInvalidClientGroupNameException
The client group name you specified contains illegal characters. See the appendix in the webMethods Broker Client Java API Programmer’s Guide for details on naming rules.
BrokerInvalidLogConfigException
The log configuration object you have specified is not valid.
BrokerInvalidClusterNameException
The cluster name you specified when creating a cluster is not valid. See the appendix in the webMethods Broker Client Java API Programmer’s Guide for details on naming rules.
BrokerInvalidNameException
The application name you specified when creating a Broker client is not valid. See the appendix in the webMethods Broker Client Java API Programmer’s Guide for details on naming rules.
BrokerInvalidTerritoryNameException
The application name you specified when creating a territory is not valid. See the appendix in the webMethods Broker Client Java API Programmer’s Guide for details on naming rules.
BrokerNotInClusterException
You have attempted to create or destroy a cluster gateway, but the Broker you have specified is not a member of any cluster.
You have specified a Broker that is not a member of any territory when attempting to add a Broker to or remove a Broker from a territory.
This error may also occur if you attempt to list the territories, territory gateways, shared event types, or territory statistics for a Broker that is not a member of any territory.
BrokerNotInTerritoryException
You have attempted to create or destroy a territory gateway, but the Broker you have specified is not a member of any territory.
You have specified a Broker that is not a member of any territory when attempting to add a Broker to or remove a Broker from a territory.
This error may also occur if you attempt to list the territories, territory gateways, shared event types, or territory statistics for a Broker that is not a member of any territory.
BrokerUnknownBrokerNameException
You have attempted to create or modify a territory gateway, but the remote half of the gateway has not yet been established and the remote Broker could not be found. You should start the remote Broker and attempt the operation again.
BrokerUnknownClusterException
You have attempted to create or modify a cluster, but the cluster with the name you specified cannot be found.
This error might also occur if Broker did not find a gateway to the cluster you specified.
BrokerUnknownTerritoryException
You have attempted to create or modify a territory, but the specified territory cannot be found.
This error might also occur if Broker did not find a gateway to the territory you specified.