executeCollaboration()

Sends business object requests to a business process within the integration broker. This is a synchronous request.

Syntax

public void executeCollaboration(String collabName,
    CWConnectorBusObj theBusObj, 
    CWConnectorReturnStatusDescriptor rtnStatusDesc);
 

Parameters

collabName
Specifies the name of the collaboration to execute the business object request.

theBusObj
Is the triggering event and the business object returned from the collaboration.

rtnStatusDesc
Is the return-status descriptor containing a message and the execution or return status from the collaboration.

Return values

None.

Exceptions

None.

Notes

The executeCollaboration() method initiates a synchronous execution of an event. Synchronous execution means that the calling code waits for a response from the integration broker's business process.

WebSphere InterChange Server

If your integration broker is IBM WebSphere InterChange Server, a business process is a collaboration.

To receive status information about the collaboration execution, pass in an instantiated return-status descriptor, rtnStatusDesc, as the last argument to the method. The collaboration populates this return-status descriptor with its status information. You can use the methods of the CWConnectorReturnStatusDescriptor class to access this status information.

Note:
To initiate an asynchronous execution of an event, use the gotApplEvent() method. Asynchronous execution means that the calling code does not wait for the receipt of the event, nor does it wait for a response.

See also

gotApplEvent(), methods of the CWConnectorReturnStatusDescriptor class

Copyright IBM Corp. 1997, 2003