TEIO: Event Input Output Support

                              Titles:  TEIO
                              =============
 
    Contact:  N. West,  Oxford.
 
    Revision History:-
    ================
 
    2.07  N. West     First version.
    2.09  N. West     Major revision for multiple streams.
    3.01  M. Thorman  Output to streams specified by PEL args.
          N. West     Add NHIT_THRESH.  Add print flag.
    3.02  N. West     Add RETURN_EOF and spare words.  I/O err limit is per file
          N. McCauley Add fake data type option.
          P. Wittich  Make print flag two digits.


 
Titles Files
------------
 
event_io.dat
 
 
Verification
------------
 
 
Description
-----------
 
    This bank contains input data for the Event Input Output Support.
 
 
Data Words
---------
 
        Data types: B(bit), I, F, D(double), H(hollerith 4 char)
 
        Fixed length Database Header.  See titles_dbhdr.html

 Word   Mnemonic      [symbolic command]  Description
 ----   --------      ------------------------------- 
        KTEIO...
 
   1  I _OUT_OPT       [default_output_format] Default output option:-
                       0 (= $FULL_DS) Full SNOMAN D/S event output
                       1 (= $ZDAB_ONLY) Dump only the ZDAB bank (un-masted Zebra record)
                       Can be overriden by FILE OUT ... FORMAT=...
 
  2   I _ERR_LIM       [io_err_lim] I/O error limit per file.  Program aborts if reached.
 
  3   I _SKIP_ON_ERROR [skip_on_error] Handling of I/O error:-
                       0 (= $DISABLED) Don't skip; return error code.
                       1 (= $ENABLED)  Skip directly to next event (via ZTELL).
 
  4   I _END_ON_EOF    [end_on_eof] Handling of EOF:-
                       0 (= $DISABLED) Don't end; return EOF (KSU_QUIT) code.
                       1 (= $ENABLED)  Switch to termination phase (via ZEND).
 
  5   I _I_SELECT      [multi_input_sel] Multiple stream input selection:-
                       0 (= $USER_SEL)    Call user routine (EIO_I_SELECT_USER).
                       1 (= $MERGE_ALL)   Merge all events in time order (keep duplicates).
                       2 (= $MERGE_FIRST) Merge first events in time order (drop duplicates).
                       3 (= $BY_WEIGHT)   Pick randomly according to weight.
 
  6   I _O_SELECT      [multi_output_sel] Multiple stream output selection:-
                       0 (= $USER_SEL)   Call user routine (EIO_O_SELECT_USER).
                       4 (= $ALL)        Accept all events.
                       5 (= $PEL_ARGS)   Streams specified by programmable event loop args.

  7   I _NHIT_THRESH   [input_nhit_thresh] Input NHIT threshold:-
                        0    No NHIT threshold
                        n    Reject events with NHIT < n.

  8   I _RETURN_EOF    [return_eof] Return EOF:  = 0 no, = 1 yes.

  9   I _FAKE_DATA     [fake_data_type] Fake Data Type on input.
                       0 (= $DISABLED)  Don't change the data type.
                       1 (= $REAL)      Fake data type real.
                       2 (= $MC)        Fake data type monte carlo.

10..18 I                Spare.

Notes
-----
 
1)  Word KDBHD_PRINT_FLAG of the Database Header is the print flag.  It
    consists of a 2 digit number:-

      ij

    Both act independently and can be set as follows:-

       j =  0  Produce no output
            1  Brief(one line) summary.
            2  As 1 plus full data structure survey (one line per bank chain)

       i=   0  Produce no output
            1  Full dump of permanent records
            2  Full dump of all events (warning: a lot of output!)