Tags allow one to preserve the state of a database table at some point in time. This is similar in concept to a tag in CVS or SVN.

Perhaps the easiest way to tag a validity database table is via the tagValidityTableInDB command-line utility:

Usage: tagValidityTableInDB [options]
     -h (--host) [dB host]
     -n (--name) [dB name]
     -p (--port) [dB port]
     -d (--detector) [detector name, REQUIRED]
     -f (--file) [XML table def. file, REQUIRED]
     -t (--tag) [tag name, REQUIRED]
     -o (--override)

The tag name should be restricted to a single word (no spaces) with limited special character use (in particular avoid using any kind of quote).

Once a tag is defined, then one may then access the data for that tag via:


If no tag is provided, then the latest validity context data in the database is returned in Table::Load().

In the case where one has uploaded data and tagged, but later has new data that should be associated with that tag, one may re-tag a table with the -o option in tagValidityTableInDB such that the existing tag will first be removed and then the current state of the database is tagged with the same tag. Use this option with care!