
Use
LOGTEXT ( <pass/fail> , <string> ).
You can use this command to simulate a failure situation during the execution of a script.
The command writes a text in the log. The text can be specified directly as a string or by a parameter containing a string.
The value of <pass/fail> determines whether the command causes the script to fail. <pass/fail> can be a fixed value or a parameter. Only 0, '0', or an empty parameter causes a pass. All other values causes a fail.
Example
LOGTEXT ( 0 , 'Pass using value 0' ).
PASS_FAIL = 1.
V_STRING = 'Non-zero causes failure'.
LOGTEXT ( PASS_FAIL , V_STRING ).