FAIL TEST-CASE Command

Description:

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.

Format:

 FAIL TEST-CASE {GOTO label}

Parameter:

label

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

Example:

 START TEST-CASE "Checking distribution rate"
     IF (dist_rate < minimum) THEN
         FAIL TEST-CASE
     ELSEIF (dist_rate > maximum) THEN
         FAIL TEST-CASE
     ENDIF
 END TEST-CASE

See also:

Formal Test Control Commands