FAIL TEST-CASE Command

This command indicates that the current test case has failed. The test case failure message is sent to the report log, and the test case anomaly count is incremented.

Script execution is resumed at the first instruction following the end of the test case section (i.e. the END TEST-CASE command). If a GOTO clause is specified, Script execution is resumed at the point identified by the clause label. If a valid command immediately follows the FAIL TEST-CASE command that would not be executed because of the jump in Script execution, the Script compiler outputs a warning message when the Script is compiled, but still produces an object file (assuming there are no errors).

This command is only valid within a test case section of a Script. It can be repeated as often as required within an individual test case.

Command Definition:

FAIL TEST-CASE {GOTO label}

label

A label defined within the current scope of the Script to which control branches.

Example:

START TEST-CASE "Checking input rate"
	IF (Inp-Rate < Min-Rate) THEN
		FAIL TEST-CASE
	ELSEIF (Inp-Rate > Max-Rate) THEN
		FAIL TEST-CASE
	ENDIF
END TEST-CASE