PASS TEST-CASE Command

Description:

This command indicates that the current test case has succeeded. The test case success message is sent to the report log.

If no GOTO clause is specified, script execution is resumed at the first command 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 PASS TEST-CASE command that would not be executed because of the jump in script execution, the 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 a test case.

If the END TEST-CASE command is reached during execution of the script, the test case is automatically considered to have succeeded, and the success message is sent to the report log.

Format:

 PASS 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
         PASS TEST-CASE
     ELSE
         FAIL TEST-CASE
     ENDIF
 END TEST-CASE

See also:

Formal Test Control Commands