START TEST-CASE Command

Description:

The START TEST-CASE command introduces a section of code that is grouped together into a test case. The section is terminated by an END TEST-CASE command.

The START TEST-CASE command must include a description of the test case. The test case description and test case status are written to the report log when the test case is executed.

Test cases cannot be nested, so a test case must be terminated with an END TEST-CASE command before a new test case section can be started. However, there is no restriction on calling another script that contains test cases, from within a test case section.

Format:

 START TEST-CASE description

Parameter:

description

A character variable or quoted literal string containing text that describes the test case.

Examples:

 START TEST-CASE "Checking for appearance of UNITS field"
 	 IF (no_units = 0) THEN
 	 	 FAIL TEST-CASE
 	 ENDIF
 END TEST-CASE
 SET tc_desc_str = "Checking for appearance of UNITS field"
 START TEST-CASE tc_desc_str
 	 IF (no_units = 0) THEN
 	 	 FAIL TEST-CASE
 	 ENDIF
 END TEST-CASE

See also:

Formal Test Control Commands