Runtime.ClearSignal

Prototypes

static void ClearSignal( String sName )

Parameters

String sName
The name of the signal to clear. The name can contain any character except backslash (\) and it can be up to 240 characters long.

Remarks

This method clears a signal.

A signal enables an IMLPlus program to communicate the occurrence of a significant event to another IMLPlus program. A signal is created on-demand when its name is used with one of the Signal methods. A signal is always in one of two states: Set, or Clear. All signals are created in the Clear state. To configure a signal to the Set state, call the method Runtime.SetSignal. To configure a signal to the Clear state, call the method Runtime.ClearSignal. To halt further program execution until a signal is set, call the method Runtime.WaitForSignal. To halt further program execution until multiple signals are set, call the method Runtime.WaitForMultipleSignals.

Example
run GetPersonalFilesDirectory( PathName );
PathName = PathName + "Programs\DynamicallyGeneratedProgram.sx";

ProgramText = { "Runtime.Delay( 3000 );",
                "Runtime.SetSignal( 'Done' );" };

Runtime.WriteProgramFile( PathName, ProgramText );
Runtime.ClearSignal( "Done" );
Runtime.RunProgramFile( PathName, "", false, true, 1 );
Runtime.WaitForSignal( "Done" );
print "Other program finished";
See Also

Runtime.SetSignal

Runtime.WaitForMultipleSignals

Runtime.WaitForSignal