titles_job

                              Titles:  JOB
                              ============
 
    Contact:  N. West, Oxford.
 
    Revision History:-
    ================
 
    1.03  N. West     First version with revision history.
    2.05  N. West     Document tidy-up.
    2.06  N. West     Add pegs file entry to doc (was already in bank).
    2.07  N. West     Add ASCII pattern file
    2.08  N. West     Remove ASCII Pattern file support.
    3.00  N. West     Add processor sequence control. Add initial context.
    3.01  M. Thorman  Hardwired processor sequence no longer supported.
          N. West     Initial context now GMT not EST.


 
Titles Files
------------
 
job_control.dat
 
 
Verification
------------
 
 
Description
-----------
 
    This is a top level titles bank for SNOMAN.
 
Data Words
---------
 
                 Fixed length Database Header.  See TITLES_DBHDR.
 
 Word   /TTJOB/  [symbolic command]  Description
 ----   -------  -------------------------------
 
   1  I IJOBSF   [store_full_limit]
                 No. of store fulls before failing job.  See note 1.
   2  I IJOBNE   [event_limit]
                 Maximum number of events to proces.
   3  I IJOBIF   Default input file spec word count = 15.
   4..I          [default_input_file]
                 Default input file spec.
  19  I IJOBOF   Default output file spec word count = 15.
  20..I          [default_output_file]
                 Default output file spec.
  35  I IJOBHB   Default hBOOK file spec word count = 15.
  36..I          [default_hbook_file]
                 Default hBOOK file spec.
  51  I IJOBSD   Default seed file spec word count = 15.
  52..I          [default_seed_file]
                 Default seed file spec.
  67  I IJOBPG   Default pEGS file spec word count = 15.
  68..I          [default_pegs_file]
                 Default pEGS file spec.
  83    IJOBPSC  Obsolete.
                 [processor_sequence]
                 Processor sequence controll = 0 Hardwired, = 1 User controlled.
                 See note 3.
  84  I IJOBIDT  [initial_data_type]
                 Initial context: Data type (to be defined)
  85  I IJOBIDA  [initial_date]
                 Initial context: Date.  See note 4.
  86  I IJOBITI  Initial context: GMT time
 
 
Notes
-----
 
 
1)  If processing real data then IJOBSF should be set to zero to prevent
    the programming skipping large events.  For Monte Carlo it is recommended
    that a small value, say 5 be used.
 
 
2)  The word counts preceeding the file specifications do not appear in the
    external file, they are inserted by the TZ Title Handling package under the
    control of the -AW option.
 
 
3)  The $processor_list command e.g.:-
 
        $processor_list ' MCO FTT ANL OUT END '
 
    defines what primary processors are required. The order of calling each
    processor was originally hardwired but could be set to 

	$processor_sequence $user_controlled

    in version 3_00 so that processors are called in the exact order given
    in the JOBP bank or $processor_list command.

    With the introduction in version 3_01 of the programmable event loop 
    (see the DEFINE EVENT_LOOP command), the $processor_list command may 
    still be used but the hardwired sequence is no longer supported.

    Note:

        1) It is up to the user to ensure that the list is sensible!
        2) Processors can appear in the list more than once.
        3) Event processing terminates as soon as a processor fails, unless it
           is a fitter or classifier, as failures here are not considered 
           fatal to further processing.
  
 
4)  The initial context date may be used in conjunction with $mc_event_rate to
    generate events with progressive Universal Date stamps as described in
    MCMA note 3