HISTORY Command

Description:

History logs contain a history of the executions of a test. Therefore, the program always attempts to open an existing history log each time the test is executed.

The HISTORY command allows you to specify a message to be logged in this file. Each message will have a date, time and thread name associated with it in the history log.

A history message may consist of any number of individual values separated by commas. Any nonprintable ASCII characters in character values are replaced with periods (".") Integer values are written as signed values, using only as many characters as necessary.

Format:

 HISTORY value {, value...}

Parameters:

value

The value or variable to be written to the history log. This may be a variable or quoted character string.

Examples:

 HISTORY "Test Run Completed." &
 	 ' Actions = ', action_count
 HISTORY "This message contains a character command " &
 	 "to represent the tilde character ~~"
 HISTORY "This message contains a 'single quoted section'" &
 	 'and "a double one here".'

See also:

Formal Test Control Commands