SNOMAN Commands

• file TCA 1 tca_demo_in.ntp id=100
  Defines the input n-tuple file name and the input n-tuple id. The file must exist.

• file TCA 2 tca_demo_out.ntp
  Defines the output n-tuple file name. The output n-tuple id is defined by the bank number of the enabled TCAR in exactly the same way as for the NTPR. If the output file does not exist it will be created. The output file name can be the same as the input, in which case the same file is used for input and output. However, in all cases, the output n-tuple id must be different to the input id.

• $processor_sequence $user_controlled
  $processor_list ' TCA END'
  Defines the processor list.

• $tca_disable_ntuple 500
  Disables the specified TCAR. Only one TCAR can be enabled at a time.

• $tca_enable_ntuple 600
  Enables the specified TCAR. Only one TCAR can be enabled at a time.

• $tca_buffer_frac 0.5
  Defines what fraction of the available /Z/ memory TCA can allocate in total to its input and out buffers. If TCA is running as the only processor, leave this at its default of 1.0

• $tca_ambig_max 10
  Defines maximum possible ambiguity (the number of times a given primary can form associations with different secondaries) that TCA will encounter. This defines the size, in records, of the output buffer that has to hold them.

• $tca_ambig_req 2
  Defines maximum ambiguity TCA is to output. By using the _SORT_ON variable to measure the quality of the association together with this command, the user can output just the best associations.

• $tca_quit_on_ovfl $on
  Tells TCA to abort if either its input buffer (which holds all the events in the time gate) or its output buffer (which holds all the associations that can be formed between the current primary and all secondaries in the time gate) overflows.

• $tca_quit_on_ovfl $off
  This is the default and tells TCA to continue even though data will be lost. The output log will give an estimate of the size of buffer needed to prevent the overflow.

• $tca_output_unass $on
  This tells TCA to output a primary even if it fails to form an association. Such n-tuple entries have the undefined value for any variable that depends directly or indirectly on any event other than the primary.

• $tca_output_unass $off
  This is the default and tells TCA to produce no output for a primary that fails to form an association.

• $tca_time_gate_low -1000.
  Selects the low edge of the time gate. Any event occurring at a time earlier than this, relative to the current primary, will not form an association in which the current event is the primary. The lower limit must be less than zero.

• $tca_time_gate_high +1000.
  Selects the high edge of the time gate. Any event occurring at a time later than this, relative to the current primary, will not form an association in which the current event is the primary. The higher limit must be greater than zero.

• $tca_time_gate -2000 2000
  A convenient way to set both edges of the time gate at once.