propagated_to/3—verify that an event has been propagated to a specified destination
The syntax for propagated_to/3 is as follows:
$ID = propagated_to($Object,$DestNM)
propagated_to/3 arguments
Argument | Mode | Type | Description |
|---|---|---|---|
$Object | Input | OBJECT | Specifies the handle of the object that might or might not have been propagated to the specified destination $DestNM |
$DestNM | Input | STRING | Specifies the destination that you want to search to determine whether or not the specified object has been propagated |
$ID | Output | INTEGER | Identifier of the object at the specified destination. $ID output is 0 if the object was not propagated to the specified destination. |
Use the propagated_to/3 primitive to determine whether or not the object handle specified in $Object has been propagated to destination $DestNM.
If the object is successfully propagated, $ID will contain the identifier of the event at that destination, which is a strictly positive number. If the event is not successfully propagated to the specified destination, the value of $ID is 0.
propagated_to/3 example
The following example returns a list of events that were successfully propagated to destination dest.