titles_tsdb


                                Titles: TSDB
                                ============
 
    Contact:  N. West, Oxford.
 
    Revision History:-
    ================
 
    3.00  R. Komar    First Version.
    3.02  R. Komar    Add supernova monitoring flag.


 
Titles Files
------------
 
job_control.dat
 
Verification
------------
 
 
 
Description
-----------
 
This is the SDB option initialization control bank.
 
 
Data Words
----------
 
     All data words are integer.
 
 
        KSDB_IDX...
 
 
    1   _WHICH_BANK        Flag for choosing which bank gets retrieved based
                           on the instant of validity : = 0 valid bank,
                           = 1 bank following valid one, = 2 bank preceding
                           valid one.
                           Should be left at default value of `0' in TSDB.
    2   _VALIDITY_INST     Flag for indicating what type of instant of validity
                           is used: = 0 date/time, = 1 run number.
                           Should be left at default value of `0' in TSDB.
    3   _BANK_TYPE         Flag for choosing the type of bank retrieved:
                           = 0 data, = 1 titles format.  Should be left at
                           default value of `0' in TSDB.
    4   _VERIFICATION      Data verification flag: = 0 disabled, = 1 enabled.
                           If enabled, a checksum verification is done of any
                           data retrieved from the database.
    5   _WRITE_MODE        Flag for choosing write mode to database.  This
                           is presently not used.
    6   _WRITE_OPTION      Flag for choosing write option.  This is presently
                           not used.
    7   _MAX_INS_DATE      Maximum insertion date for retrieved banks (in
                           YYYYMMDD format).  See Note 2.
    8   _MAX_INS_TIME      Maximum insertion time for retrieved banks (in
                           HHMMSS format).  See Note 2.
    9   _SN_MON            Should only be used for supernova monitoring.
                           Setting it to `1' allows the nearest neighbour bank
                           to be retrieved if a valid bank isn't found.  This
                           mode is not recommended for normal data analysis,
                           since incorrect constants might be retrieved, and the
                           results of the analysis may differ if repeated in the
                           future.

Notes
-----

1)  Of the words described above, only word 4 (database verification) and
    words 7 and 8 (maximum insertion date/time) will usually be modified
    in TSDB for global use in SNOMAN.  For the others, non-default values
    are usually set during run-time prior to reading or writing each
    individual bank.
 
 
 
2)  The maximum insertion date/time are used to set an upper limit on the
    insertion time of banks to be retrieved.  These would be used when
    reproducing an old analysis, to ensure that only those banks that
    existed at the time of the original analysis are used.  To disable
    this feature, the date should be set to `0'.
 
 

Go Back to the Snoman Companion Top Page