/Runinfo ODB tree: Difference between revisions

From MidasWiki
Jump to navigation Jump to search
(Created page with "== Creating the /Runinfo tree == The <span style="color: purple;">''/Runinfo''</span> tree is created automatically when the ODB is first created...")
 
No edit summary
Line 6: Line 6:
about the state of the current run. Several time fields are available for run time statistics.  
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
This information is displayed on the [[mhttpd Main Status page]] or can be
viewed with [[odbedit]] as shown below.
viewed with [[odbedit]] as shown [[#Example |below]].


== Example ==  
== Example ==  
Line 32: Line 32:
* '''Default:'''  1
* '''Default:'''  1
</div>  
</div>  
Specifies the state of the current run (see [[Run States and Transitions #MIDAS State and Transition Codes]]) . The possible states are
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 )
*    1: STOPPED ( STATE_STOPPED )
*    2: PAUSED ( STATE_PAUSED )
*    2: PAUSED ( STATE_PAUSED )
Line 48: Line 48:
</div>  
</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.  
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>
Line 72: Line 72:
* '''Default:'''  0
* '''Default:'''  0
</div>  
</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 before the run start/stop can be
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.
retried.
   > odb set "/runinfo/transition in progress" 0
   > odb set /runinfo/transition in progress 0




Line 81: Line 80:
<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:'''  1
</div>


Specifies the current internal state of the [[Deferred Transition]] state of the system.
=== <span style="color: purple;">''/Runinfo/Start abort''</span>  ===  
<br>
--------
<br>
 
=== <span style="color: purple;">''/Runinfo/''</span>  ===  
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' INT
* '''Type:''' INT
* '''Default:'''  1
* '''Default:'''  0
</div>  
</div>  


Line 103: Line 92:
<br>
<br>


=== <span style="color: purple;">''/Runinfo/''</span>  ===  
 
=== <span style="color: purple;">''/Runinfo/Requested transition''</span>  ===  
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' INT
* '''Type:''' INT
Line 110: Line 100:




Specifies whether a [[Run States and Transitions #Deferred Transitions|deferred transition]] is in progress.
<br>
<br>
--------
--------
<br>
<br>


=== <span style="color: purple;">''/Runinfo/''</span>  ===  
 
=== <span style="color: purple;">''/Runinfo/Start time''</span>  ===  
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' INT
* '''Type:''' STRING
* '''Default:'''  1
* '''Default:'''  "Tue Sep 09 15:04:42 1997"
</div>  
</div>  
 
Specifies in an ASCII format the time at which the last run has been started.


<br>
<br>
Line 125: Line 117:
<br>
<br>


=== <span style="color: purple;">''/Runinfo/''</span>  ===  
=== <span style="color: purple;">''/Runinfo/Start time binary''</span>  ===  
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' INT
* '''Type:''' DWORD
* '''Default:'''  1
* '''Default:'''  0
</div>  
</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>
--------
--------
<br>
<br>


 
=== <span style="color: purple;">''/Runinfo/Stop time''</span>  ===  
=== <span style="color: purple;">''/Runinfo/''</span>  ===  
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' INT
* '''Type:''' STRING
* '''Default:'''  1
* '''Default:'''  "Tue Sep 09 15:04:42 1997"
</div>  
</div>  


 
Specifies in an ASCII format the time at which the last run was stopped.
<br>
<br>
--------
--------
<br>
<br>


=== <span style="color: purple;">''/Runinfo/''</span>  ===  
 
=== <span style="color: purple;">''/Runinfo/Stop time binary''</span>  ===  
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' INT
* '''Type:''' DWORD
* '''Default:'''  1
* '''Default:'''  0
</div>  
</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>
--------
--------
<br>
<br>

Revision as of 13:59, 20 August 2013

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






/Runinfo/Requested transition

  • Type: INT
  • Default: 1


Specifies whether 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.