Keys in the ODB /Logger/History subtree

From MidasWiki
Jump to navigation Jump to search

Links



/Logger/History subtree

The ODB /Logger/History subtree is a subdirectory of the ODB /Logger tree, created when the MIDAS logger utility mlogger is started for the first time. The keys will be filled with default values which users may change as required to customize their experiments.

When mlogger is started for the first time, it creates three odb subtrees 0,1 and 2 as shown in the following example:

Example

The following example shows the /Logger/History ODB subtree after creation by mlogger (obtained using the odbedit ls command). See below for information on individual keys. 

[local:pol:S]/>cd /logger
[local:pol:S]/Logger>ls -r history
History
   0
       Type                    MIDAS
       Active                  y
       Debug                   0
       PerVariableHistory      0
   1
       Type                    ODBC
       Active                  n
       Debug                   0
       Writer_ODBC_DSN         history_writer
       Reader_ODBC_DSN         history_reader
   2
       Type                    SQLITE
       Active                  n
       Debug                   0
       Sqlite dir

The three subtrees are each a history-logging-channel created to control one of the three different types of history logging available, i.e. MIDAS, ODBC and SQLITE.

Each subdirectory is created with a different value in the subkey "Type", i.e.

  • Subtree 0 for MIDAS (key Type set to "MIDAS")
  • Subtree 1 for ODBC (key Type set to "ODBC")
  • Subtree 2 for SQLITE (key Type set to "SQLITE")


The keys present in each history-logging-channel are described below.


/Logger/History/0/ subtree

This subtree controls history logging of Midas events.



/Logger/History/0/Type

  • Type: STRING
  • Default: MIDAS

This key specifies the type of history logging for this history-logging-channel.

mlogger creates this channel with this key set to "MIDAS" since this subtree 0 controls MIDAS history logging.




/Logger/History/0/Active

  • Type: BOOL
  • Default: "y"

If set to "y", MIDAS history logging is active. Set to "n" to disable MIDAS history logging.

See also Type key.

Note:this key replaces obsolete key /Logger/WriteFileHistory




/Logger/History/0/Debug

  • Type: INT
  • Default: 0

If set to 1, debug is enabled for this history logging channel.




/Logger/History/0/PerVariableHistory

  • Type: INT
  • Default: 0

This key is present in a history channel of Type "MIDAS" only (see Type key).

The default value of 0 is intended to operate the midas history in "traditional" mode. In this mode:

  • there is one history record for each equipment
  • history record id is equal to the equipment id
  • /History/Events and /History/Tags are not required and can be safely deleted


Note: this key replaces obsolete key /history/PerVariableHistory






/Logger/History/1/ subtree

This subtree controls history logging of ODBC



/Logger/History/1/Type

  • Type: STRING
  • Default: "ODBC"

This key specifies the type of history logging for this history-logging-channel.

mlogger creates this channel with this key set to "ODBC" since this subtree 1 controls ODBC history logging.



/Logger/History/1/Active

  • Type: BOOL
  • Default: "n"

If set to "y", ODBC history logging is active.


See also Type key.


/Logger/History/1/Debug

  • Type: INT
  • Default: 0

If set to 1, debug is enabled for ODBC history logging.

See also Type key.


Note: this key replaces obsolete key /Logger/ODBC_Debug


/Logger/History/1/Writer_ODBC_DSN

  • Type: STRING
  • Default: "history_writer"

This key is present in a history channel of Type "ODBC" only, and is created by mlogger.

See also Type key.

Note: this key replaces obsolete key /logger/ODB_DSN




/Logger/History/1/Reader_ODBC_DSN

  • Type: STRING
  • Default: "history_reader"

This key is present in a history channel of Type "ODBC" only, and is created by mlogger.

See also Type key.

Note: this key replaces obsolete key /history/ODB_DSN






/Logger/History/2/ subtree

This subtree controls history logging of SQLITE


/Logger/History/2/Type

  • Type: STRING
  • Default: "SQLITE"

This key specifies the type of history logging for this history-logging-channel.

mlogger creates this channel with this key set to "SQLITE" since this subtree 2 controls SQLITE history logging.



/Logger/History/2/Active

  • Type: BOOL
  • Default: "n"

If set to "y", SQLITE history logging is active.


See also Type key.


/Logger/History/2/Debug

  • Type: INT
  • Default: 0

If set to 1, debug is enabled for SQLITE history logging.

See also Type key.





/Logger/History/2/Sqlite dir

  • Type: STRING
  • Default:

This key is present in a history channel of Type "SQLITE" only, and is created by mlogger.

See also Type key.

Retrieved from "https://daq00.triumf.ca/MidasWiki/index.php?title=Keys_in_the_ODB_/Logger/History_subtree&oldid=661"