Micro Focus Visual COBOL 2.3 for Visual Studio 2015 > General Reference > Library Routines > Unit Testing Routines > MFU_ASSERT_FAIL

MFU_ASSERT_FAIL

Signifies that a test case running under the Micro Focus Unit Testing framework has failed, and outputs a message to the test report.

Syntax:

call "MFU_ASSERT_FAIL" using by reference msg
                             by value msg-len
end-call.

Parameters:

msg: pic x(n)
msg-len: binary-long

On Entry:

msg: The message that is used in the test report output.
msg-len: The length of the message.

On Exit:

None.

Example:

call "MFU_ASSERT_FAIL" using
                       by reference "Condition 4 has failed."
                       by value 23
end-call.

Comments:

The unit testing library routines use the mfunit_prototype.cpy copybook for call prototyping. If required, it is available from the cpylib directory of your product installation directory.