Flags Property (AProgram)

Returns flags representing all the conditions that have occurred since the program started.

Syntax

[ lFlags = ] Object.Flags

The Flags property syntax has the following parts:

Name	Type	Description
Object	AProgram	AProgram object
lFlags	enumARuntimeFlag	An integer specifying the conditions that have occurred since the program started.

Where

enumARuntimeFlag can be one of the following:

Name	Value	Description
aFlagsTaskSkipped	0x00000001	Task Skipped
aFlagsTestSkipped	0x00000002	Test Skipped
aFlagsLoopOnTestCalled	0x00000004	Loop On Test Called
aFlagsCurrentTestCalled	0x00000008	Current Test Called
aFlagsStepTraceCalled	0x00000010	Step/Trace Called
aFlagsDoitLoopitCalled	0x00000020	Doit/Loopit
aFlagsPauseCalled	0x00000040	Pause
aFlagsAbortCalled	0x00000080	Abort
aFlagsErrorCalled	0x00000100	Error
aFlagsIgnoreCalled	0x00000200	Ignore
aFlagsRetryCalled	0x00000400	Retry
aFlagsValueChanged	0x00000800	Change Value
aFlagsSetNextStatementCalled	0x00001000	Set Next Statement
aFlagsSerialNumber	0x00010000	Serial Number
aFlagsProfile	0x00020000	Profile
aFlagsTaskByTask	0x00040000	Task By Task
aFlagsTestByTest	0x00080000	Test By Test
aFlagsStopOnFail	0x00100000	Stop On Fail
aFlagsLoopOnTest	0x01000000	Loop On Test
aFlagsCurrentTest	0x02000000	Current Test
aFlagsStepTrace	0x04000000	Step/Trace
aFlagsDoitLoopit	0x08000000	Doit/Loopit

Comments

This property is read-only at run time. It is the combination of all the flags which have been set so far.

Example

The following statement prints a warning to the log that trace mode is active in code which is timing-dependent, for example, a protocol interchange with a remote device:

if Program.Flags and aFlagsStepTrace then

print "NOTE: Step/Trace active in timing dependent code in test "; Test.Id

print "NOTE: May cause timeout errors in UUT "; Program.Uut

endif

Applies to

AProgram