KID - SpyDAQ module

Description:

Read events from KLOE DAQ circular buffers.

The database is searched for the available circular buffers and when there are some available, the data are taken from all of them.

Syntax:

spydaq : stream_name ? options

where:

• stream_name is a DAQ stream (defined in descript.stream_descript).
  At the time of writting, the following streams were available:
  • ALL - All events passing the builders.
  • L3BHA - BhaBha events filtered by the l3filters.
  • L3MIP - Minimum Ionizing Particles events filtered by the l3filters.
  • L3COS - Cosmic Ray events filtered by the l3filters.
• Options are an optional list of URI options.

  option	param. type	description
  dbnode	string	Name of the DB machine. (i.e. fibm01). If not specified, the environment variable SQLREMOTENODE is used.
  dbport	integer	Port on which the SQLr_selectd listens. If negative or not specified, the default port will be used.
  wait_run	one of: yes, Y, 1, true, T (default) no, N, 0, false, F	if true, the spyDAQ module will return empty events until the DAQ circular buffers are not available if false, an error will be returned if there are no DAQ circular buffers available at the moment of opening the URL
  wait
  multi_run	one of: yes, Y, 1, true, T (default) no, N, 0, false, F	if true, the spyDAQ module will never declare to have reached the end of the stream. If for any reason the connection with the DAQ circular buffers get lost (i.e. run closed or net problems), when a new run starts the data will be delivered from these new DAQ circular buffers. Note: multi_run=true implies wait_run=true! if false, the stream will de decalred closed, if the DAQ circular buffers get closed. (see also the merge_mode)
  multi
  merge_mode	one of: DEFAULT ANY ROUND_ROBIN RR SORTED	The way in which the events are sorted from different DAQ farms. ROUND_ROBIN or RR - One event is passed from each farm, using the round-robin policy. (for example, if there are 4 sources, the events will come from sources 1,2,3,4,1,2,3,4,...) If the farm under inspection signals no ready events, also the spyDAQ module will signal the same. ANY - One event is passed from each farm, using the round-robin policy. The spyDAQ will signal no data found, only if ALL the farms reports no data found. SORTED - The events get ordered by trigger number. The spyDAQ module will signal no data available if ANY farm reports no data found.
  mode
  partial_open	one of: yes, Y, 1, true, T no, N, 0, false, F (default)	iff false, the data will be served only if all the circular buffers decalred in the DB are opened
  partial
  spy_max_events_per_packet	natural number	maximum number of events to get from the single packet from each circular buffer
  spymaxevt
  remote_max_events_per_packet	natural number	maximum number of events to get from the single packet from each farm
  rmtmaxevt
  remote_request_type	one of: DEFAULT POP PUSH POP_IN_ADVANCE	Type of communication with the remote KID daemon. POP - a packet get sent only when the caller asks for a new event and there are no events in the local buffer (slow) PUSH - packets get sent as soon as there is some space in the local TCP/IP buffer (very fast but can deliver old events) POP_IN_ADVANCE - a packet get sent as soon as the local buffer get empty (fast)
  rmtreq
  rcv_buf_size	integer	TCP receive buffer size Use -1 to use the system default
  rsize
  snd_buf_size	integer	TCP send buffer size Use -1 to use the system default
  ssize
  tcp_nodelay	integer (boolean)	1 - disable smart output packeting 0 - enable smart output packeting -1 - use system default
  rmtnodelay

Examples:

• spydaq:ALL
• spydaq:L3BHA?mode=SORTED
• spydaq:L3COS?remote_request_type=POP&spy_max_events_per_packet=1

Send comments to: Igor Sfiligoi