Assert command

Action:	Performs an equality or inequality comparison between a) the value of program data or a macro variable or Client function, and b) a constant or the value of a macro variable or macro function. For example: assert %i==666  This command lets you create simple testing macros that ensure that key elements in your code have the values you expect. If the comparison expression you construct with assert is not logically true, you receive a failure message. If true, you receive no confirmation. assert failure messages are displayed in the console, if it is open. Otherwise, they are displayed in a Windows message box. They have the following format: Assert failed: failing_assert_statement  For example: Assert failed: assert &b = "no way"  The assert command syntax follows: ASSERT {&var|%x|g.x|f.x|$listcnt(x)|$listinf(x,y)|&&function} {=|==|!=|<>} {string|[-]n|&var|&&function} where: &var is a previously defined macro variable. %x is a mainframe variable.   g.x is a Debugger global variable reference. f.x is a Debugger field reference, possibly with a subscript. $listcnt/$listinf are the Debugger functions for viewing $list counts and elements. &&function is a macro function. string is a quoted string constant (double or single quotes are valid). [-]n is an integer constant with an optional leading minus sign. Here are examples of valid assert statements: assert g.JACK = "No play makes Jack a dull boy."    ASSERt   %s='Hey Moe'  ASSERT $listcnt(%g)=2  ASSERT $listinf(%g,2) = " makes Jack a dull boy."  assert &this = 'that'  assert &this <> &that  Notes: The &&assertFailureCount, &&assertSuccessCount, and &&assertStatus Client functions, as well as &&globalAssertFailureCount, &&globalAssertSuccessCount, and &&globalAssertStatus,  report assert command results. If you are specifying a Client mapping command and your assertion includes an ampersand character (&) or the not equal operator (<>), you must XML entity encode the character. For example, to map the command assert &i<>6, you specify it like this: <mapping command="assert &amp;i&lt;&gt;6" button="button9"/>
Client menu:	--
Introduced:	Build 28