I am not quite sure how to use BAM. Seems to me that this is part of SwitchYard.
The BAM project is separate from SwitchYard. However the main focus currently is on monitoring business transactions executed using SwitchYard. In the future we will also have integration with other execution environments.
Essentilally the integration with SwitchYard is just based on registering a handler/interceptor that observes message exchanges and then reports them to the BAM infrastructure. So the same could be achieved by registering JAX-WS handlers, etc.
In terms of how to use it - the purpose is to observe business transactions and provide tooling to help monitor, analyse and present high level information about them. We have some webcasts (available in the articles section of the user forum) showing the current features, but if you require other functionality then please create some feature requests in our jira.
Can BAM be integrated into RHQ ? Or why create a new project rather than extend or add RHQ features ?
Yes - the BAM infrastructure can emit JMX notifications regarding situations it has detected.
RHQ is a management system, designed to monitor IT infrastructure. BAM is more focused on business transactions that execute across that infrastructure. There is no concept of a managed object when observing a business transaction.
These technologies are also aimed at a different audience - RHQ (or any management system) is used by an IT department, whereas a BAM product would be used by business analysts to understand how their business functions to determine how it can be optimised. However, as mentioned above, it is possilble for the BAM project to report situations that have been detected to a JMX based management system (i.e. if IT involvement is required to rectify a problem).
Hope that helps.