NOTMATCHED

System Testing Test Script Language.

Syntax

NOTMATCHED( <ref_msg> [, <channel> ] )

Description

NOTMATCHED is a function that returns a Boolean value. It returns true if one of the messages received during a WAITTIL does not match the reference message <ref_msg>. If you specify a channel, it returns true only if the non-matching message was received on this channel.

<ref_msg> is a reference message variable declared with the MESSAGE instruction and initialized with the DEF_MESSAGE instruction.

<channel> is a communication channel declared with the CHANNEL instruction and initialized by the ADD_ID instruction.

It returns true if at least one received message has a value different from those defined for the reference message.

NOTMATCHED is only meaningful when used in a WAITTIL instruction or in control statements following a WAITTIL, such as IF, WHILE, or CASE.

The NOTMATCHED return value changes when reused in a WAITTIL.

Example

...

CHANNEL ux_socket: ch

SCENARIO Main

DEF_MESSAGE msg_1, EV={100,10}

DEF_MESSAGE msg_2, EV={200,20}

...

WAITTIL(WTIME==10, NOTMATCHED(msg_1))

...

IF (NOTMATCHED(msg_1,ch)) THEN

...