NewTagsFullyStarted

(VTScada-Layer function. Must be called with a leading backslash.)

Description: Returns TRUE when all new tags have started, run their Refresh modules, and started their children (if any).
Returns: Boolean
Usage: Script or steady state.
Function Groups: Configuration
Related to: ModifyTags|OpChange
Format: \Code.NewTagsFullyStarted()
Parameters:  
Comments:

In script usage, this function returns the value TRUE or FALSE when called.

In steady state usage, this function waits for all tag updates associated with a ModifyTags call to complete before returning True. This is useful because ModifyTags() does not guarantee that all new children have been refreshed and started their own children.

Make sure that the working copy lock is not engaged while this function is being called. Otherwise, it could end up in a deadlock situation if a tag being started needs the working copy before it refreshes but the working copy lock is already being acquired by some other operation.

Example:

\Code.NewTagsFullyStarted() ? Waiting = FALSE:Waiting = TRUE;

In this example, if the new tags have been registered as started and refreshed, the variable,
"Waiting", is set to FALSE. Otherwise, "Waiting" is set to TRUE.