/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 Main 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.

/Runinfo/State

  • Type: INT
  • Default: 1

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 )





/Runinfo/Online Mode

  • Type: INT
  • Default: 1

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.





/Runinfo/Run number

  • Type: INT
  • Default: 0

Specifies the current run number. This number is automatically incremented by a successful run start procedure.




/Runinfo/Transition in progress

  • Type: INT
  • Default: 0

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






/Runinfo/Start abort

  • Type: INT
  • Default: 0

Start abort 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 /Experiment/Prevent start on alarms) , or if a required program is not running.



/Runinfo/Requested transition

  • Type: INT
  • Default: 0


Specifies whether a transition has been requested. It will be set if a deferred transition is in progress.



/Runinfo/Start time

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

Specifies in an ASCII format the time at which the last run has been started.




/Runinfo/Start time binary

  • Type: DWORD
  • Default: 0

Specifies in a binary format the time at which the last run has been started. This field is useful for time interval computation.



/Runinfo/Stop time

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

Specifies in an ASCII format the time at which the last run was stopped.




/Runinfo/Stop time binary

  • Type: DWORD
  • Default: 0

Specifies in a binary format the time at which the last run has been stopped. This field is useful for time interval computation.