DAMN: Data Analysis Mask Numbers

                              Titles:  DAMN
                              =============
 
    Contact:  N. West,  Oxford.
 
    Revision History:-
    ================
 
    3.02  N. West     First version.  Support for sub-run DAMN.


 
Titles Files
------------
 
DAMN banks should be stored in files using the naming convention:-

    damn_m_r_sss.dat    where m is the mask number
                              r is the run number
                              s is the 3 digit sub-run number
                    e.g. damn_0_123456_001.dat

Where the sub-run number is unknown (run number < 10614), or when reprocessing
any DAMN bank created before support was added for single sub-run DAMN banks,
the name convention excludes _sss e.g.  damn_0_123456.dat
 
It is recommended that these files are not loaded using TITLES commands.  
See the Data Mask Manager chapter of the User Manual for details.


Verification
------------
 
 
Description
-----------
 
Bank Number:  Mask number

    This bank contains sets of data masks that are created and used by
    Data Mask Manager (DMM).  A singe DAMN bank holds all the masks for
    a single run to which the numbered mask applies.

 
Data Words
----------
 
        Data types: B(bit), I, F, D(double), H(hollerith 4 char)
 
        Fixed length Database Header.  See titles_dbhdr.html
        The validity range is always universal.


 Word   Mnemonic           [symbolic command]  Description
 ----   --------           ------------------------------- 
        KDAMN...
 
    1  I _HDR_VER          Version number
    2  I _HDR_COMP_ALGOR   Compression algorithm
    3  I _HDR_FORMAT       Format: =0 multiple sub-run, =1 single sub-run
    4  I _SUB_RUN          Sub-run (=0 for Format = 0)
5..10  I                   Spare

       The remainder of the bank consists of a single Run Record.
       It starts with a 3 word header:-

   +1  I                   -ve. run number (the minus sign flags a new Run Record)
   +2  I                   Default Applied Mask
   +3  I                   Default Result mask
 

       The Run Record Header is followed by none or more Run Record Entries.  
       Each is between 1 and 3 words long:-

   +1  I                  Entry_mask*10**8 + GTID    
                          where  entry_mask = 0 GTID only
                            = 1 GTID + Applied Mask
                            = 2 GTID + Result Mask
                            = 3 GTID + Applied Mask + Result Mask.
   +2 I                   Applied Mask if necessary
   +3 I                   Result Mask if necessary