API for sending events across address spaces

When sending events to reactive objects in different address spaces, the RidSendRemoteEvent function must be used (and not the standard event generation macro RiCGEN):

RiCBoolean RidSendRemoteEvent (const RhpString strReactiveName, struct 
RiCEvent* const ev, const RhpPositive eventSize);

strReactiveName - the published name of the destination reactive object

ev - pointer to the event to send

eventSize - the size of the event to send

Note: When providing the strReactiveName parameter for the RidSendRemoteEvent function, you can indicate which address space contains the target object, using the format addressSpaceName::publishedNameOfReactiveObject. This means that you can have objects with the same name in multiple address spaces and still have the event sent to the appropriate object.

When using this option, the name you use for the address space is the value of the C_CG::Configuration::AddressSpaceName property, described in Properties for sending events across address spaces.

For convenience, IBM® Rational® Rhapsody® includes a macro named RiCGENREMOTE, which calls the RidSendRemoteEvent function:

RiCGENREMOTE ([string - the published name of the destination reactive object], [type of event with parameters in parentheses])

For example:

RiCGENREMOTE("destinationObject", Fstarted());

Feedback