The DQF Interface

The single DQF DMM takes one, two or 3 args that correspond to the 3 DMM calls described above. For example, to define filter 3 that is true if either bit 0 of mask 7 is true or bit 3 of mask 9 is false:-

$enable_test 3 
$define_test 3 $line_1 '_ok_7  dmm  7,1,1;       '  
$define_test 3 $line_2 '_ok_9  dmm  9,8,0;       ' 
$define_test 3 $line_3 'test   or   _ok_7, _ok_9;'

The DQF DMM_GET_EMASK takes a single arg, the mask number, and retrieves the full 32 bits of a DAMN or DARN data mask. The function returns a pair of masks:-

    Applied Mask: Bit is set if test applied.
    Result Mask: Bit is set if test applied and succeeded.

As n-tuples cannot hold full 32-bit precision integers, the function splits each mask into two in the same way as HALF_WORDS. For example:-

    ' app_top  dmm_get_emask 0;           '
    ' app_bot  reserved;                  '
    ' res_top  reserved;                  '
    ' res_bit  reserved;                  '

retrieves the DAMN mask 0.