The node parameter is a node path pattern that identifies the software node that should become active. See the Analyzer User's Guide for more information about node path patterns. The node path pattern will be evaluated every time a node becomes active in order to check if the wait condition is fulfilled. This means that a node that did not exist when this command was issued might cause this command to return.There is also a performance penalty involved. If only one node is of interest, a node id can be given (as an integer value) instead.
If the -immediately flag is specified and a processor is active on any of the nodes matching the node path pattern, this command will return directly, otherwise the command will wait until the set of active processors on the matching nodes goes from being empty to being non-empty.
The command will by default only wait for events that occur when the simulation is running forward. To wait for events in the reverse direction use the -reverse flag. Similarly, the -always flag tells the command to wait for events in both simulation directions.