/Runinfo ODB tree: Difference between revisions

From MidasWiki
Jump to navigation Jump to search
(The midas documentation has moved to https://midas.triumf.ca/docs/)
Tag: Replaced
 
(3 intermediate revisions by one other user not shown)
Line 1: Line 1:
== Creating the /Runinfo tree ==
The midas documentation has moved. See [https://midas.triumf.ca/docs/develop/reference/reference/odb_keys/#runinfo /Runinfo] on the ODB keys page for the new documentation about the /Runinfo ODB keys.
The <span style="color: purple;">''/Runinfo''</span> tree is created automatically when the [[odbedit #Creating the ODB|ODB is first created]].
 
== Purpose ==
The <span style="color: purple;">''/Runinfo''</span> 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 [[#Example |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  <span style="color: purple;">''/Runinfo''</span> tree are described in the following sections.
 
=== <span style="color: purple;">''/Runinfo/State''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' INT
* '''Default:'''  1
</div>
Specifies the state of the current run (see [[Run States and Transitions #MIDAS State and Transition Codes|MIDAS run states]]) . The possible states are
*    1: STOPPED ( STATE_STOPPED )
*    2: PAUSED ( STATE_PAUSED )
*    3: RUNNING ( STATE_RUNNING )
 
<br>
--------
<br>
 
 
=== <span style="color: purple;">''/Runinfo/Online Mode''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' INT
* '''Default:'''  1
</div>
 
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.
 
<br>
--------
<br>
 
 
=== <span style="color: purple;">''/Runinfo/Run number''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' INT
* '''Default:'''  0
</div>
 
Specifies the current run number. This number is automatically incremented by a successful run start procedure.
 
<br>
--------
<br>
 
=== <span style="color: purple;">''/Runinfo/Transition in progress''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' INT
* '''Default:'''  0
</div>
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, <span style="color: purple;">''Transition in progress''</span>  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
 
 
<br>
--------
<br>
 
 
=== <span style="color: purple;">''/Runinfo/Start abort''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' INT
* '''Default:'''  0
</div>
 
 
<br>
--------
<br>
 
 
=== <span style="color: purple;">''/Runinfo/Requested transition''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' INT
* '''Default:'''  0
</div>
 
 
Specifies whether a transition has been requested. It will be set if a [[Run States and Transitions #Deferred Transitions|deferred transition]] is in progress.
<br>
--------
<br>
 
=== <span style="color: purple;">''/Runinfo/Start time''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' STRING
* '''Default:'''  "Tue Sep 09 15:04:42 1997"
</div>
Specifies in an ASCII format the time at which the last run has been started.
 
<br>
--------
<br>
 
=== <span style="color: purple;">''/Runinfo/Start time binary''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' DWORD
* '''Default:'''  0
</div>
 
Specifies in a binary format the time at which the last run has been started. This field is useful for time interval computation.
<br>
--------
<br>
 
=== <span style="color: purple;">''/Runinfo/Stop time''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' STRING
* '''Default:'''  "Tue Sep 09 15:04:42 1997"
</div>
 
Specifies in an ASCII format the time at which the last run was stopped.
<br>
--------
<br>
 
 
=== <span style="color: purple;">''/Runinfo/Stop time binary''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' DWORD
* '''Default:'''  0
</div>
 
Specifies in a binary format the time at which the last run has been stopped. This field is useful for time interval computation.  
<br>
--------
<br>

Latest revision as of 22:00, 30 October 2026

The midas documentation has moved. See /Runinfo on the ODB keys page for the new documentation about the /Runinfo ODB keys.

Retrieved from "https://daq00.triumf.ca/MidasWiki/index.php?title=/Runinfo_ODB_tree&oldid=3659"