propagated_to/3—verify that an event has been propagated to a specified destination
The syntax for propagated_to/3 is as follows:
propagated_to($Object,$DestNM,$ID)
$ID = propagated_to($Object,$DestNM)
propagated_to/3 arguments
Argument | Mode | Type | Description |
---|---|---|---|
| Input | OBJECT | Specifies the handle of the object that might or might not have been propagated to the specified destination |
| Input | STRING | Specifies the destination that you want to search to determine whether or not the specified object has been propagated |
| 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
.
mquery -n <CellName> -a EVENT -w 'propagated_to($THIS,dest) > 0'
Comments
Log in or register to comment.