/Runinfo ODB tree

From MidasWiki
Jump to navigation Jump to search


Creating the /Runinfo tree

The /Runinfo tree is created automatically when the ODB is first created.

Purpose

The /Runinfo ODB tree contains system information about the state of the current run. Several time fields are available for run time statistics. This information is displayed on the mhttpd Status page or can be viewed with odbedit as shown below.

Example

> odb -e expt -h host
[host:expt:Running]/>ls -r -l /runinfo
Key name                      Type    #Val  Size  Last Opn Mode Value
------------------------------------------------------------------------
Runinfo                        DIR
   State                      INT     1     4     2h   0   RWD  3
   Online Mode                INT     1     4     2h   0   RWD  1
   Run number                 INT     1     4     2h   0   RWD  8521
   Transition in progress     INT     1     4     2h   0   RWD  0
   Requested transition       INT     1     4     2h   0   RWD  0
   Start time                 STRING  1     32    2h   0   RWD  Thu Mar 23 10:03:44 2000
   Start time binary          DWORD   1     4     2h   0   RWD  953834624
   Stop time                  STRING  1     32    2h   0   RWD  Thu Mar 23 10:03:33 2000
   Stop time binary           DWORD   1     4     2h   0   RWD  0

Keys in the /Runinfo tree

The keys in the ODB /Runinfo tree are described in the following sections.

State

  • Type: INT
  • Default: 1

This key in the /Runinfo tree specifies the state of the current run (see MIDAS run states) . The possible states are

  • 1: STOPPED ( STATE_STOPPED )
  • 2: PAUSED ( STATE_PAUSED )
  • 3: RUNNING ( STATE_RUNNING )





Online Mode

  • Type: INT
  • Default: 1

This key in the /Runinfo tree specifies the expected acquisition mode. This parameter allows the user to detect if the data are coming from a "real-time" hardware source (the default) or from a data save-set. Note that for analysis replay using "analyzer", this flag will be switched off.





Run number

  • Type: INT
  • Default: 0

This key in the /Runinfo tree specifies the current run number. This number is automatically incremented by a successful run start procedure.




Transition in progress

  • Type: INT
  • Default: 0

This key in the /Runinfo tree specifies the current internal state of the system. This parameter is used for multiple source of "run start" synchronization. Sometimes when run start or stop fails, Transition in progress is left set to 1, and must be manually set to 0 by the user (e.g. with odbedit) before the run start/stop command can be retried.

 > odb set "/runinfo/transition in progress" 0






Start abort

  • Type: INT
  • Default: 0

This key in the /Runinfo tree will be set if run start is aborted. The run start may be aborted if the saved data file already exists, or on alarm (see prevent start on alarm) , or if a required program is not running.



Requested transition

  • Type: INT
  • Default: 0

This key in the /Runinfo tree specifies whether a transition has been requested. It will be set if a deferred transition is in progress.



Start time

  • Type: STRING
  • Default: "Tue Sep 09 15:04:42 1997"

This key in the /Runinfo tree specifies in an ASCII format the time at which the last run has been started.




Start time binary

  • Type: DWORD
  • Default: 0

This key in the /Runinfo tree specifies in a binary format the time at which the last run has been started. This field is useful for time interval computation.



Stop time

  • Type: STRING
  • Default: "Tue Sep 09 15:04:42 1997"

This key in the /Runinfo tree specifies in an ASCII format the time at which the last run was stopped.




Stop time binary

  • Type: DWORD
  • Default: 0

This key in the /Runinfo tree specifies in a binary format the time at which the last run has been stopped. This field is useful for time interval computation.