DARN: Data Analysis Request Numbers

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


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

    darn_m.dat    where m is the mask number e.g. darn_7.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 DARN bank holds all the masks for
    all runs 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
 ----   --------           ------------------------------- 
        KDARN...
 
    1  I _HDR_VER          Version number
    2  I _HDR_COMP_ALGOR   Compression algorithm
    3  I _HDR_FORMAT       Format: Always 0
    4  I _SUB_RUN          Sub-run: Always 0 (not used)
5..10  I                   Spare

       The remainder of the bank consists of a series of Run Records.
       Each Run Record 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