GETTRGCONFIG
Section: BaBar Trigger Documentation (1)
Updated: December 2001
Index
Return to Main Contents
NAME
getTrgConfig - get a TrgConfig file from the database
SYNOPSIS
getTrgConfig
[options] [<config-key>|<config-alias>]
DESCRIPTION
Fetch a
TrgConfig(5)
file for the given configuration key or alias from the database and
save it to disk or print its contents to the standard output.
ARGUMENTS
getTrgConfig
can be called with one optional argument to specify the configuration
tree, or without arguments to retrieve the current default
configuration according to the latest Run Control configuration.
- <config key>
-
If a numeric configuration key is given getTrgConfig will search
for a TrgConfig object that is associated with that key. The key
argument is assumed to represent a "top key", i.e., a key pertaining
to the
Top
map of the configuration database. The key can be given either in
decimal format or in hexadecimal format using a "0x" prefix.
- <config alias>
-
A non-numeric argument is interpreted as a run-type alias.
getTrgConfig
will look up the key that is referred to by this alias and try to find
the corresponding TrgConfig object.
An alias can be specified as a simple run-type, e.g.,
"PHYSICS",
or as a combination of a map and an alias, e.g.,
"Top/Dec2001-Cfg".
If no map is given, the
Orc
alias map is used as the default map, which contains the data-taking
aliases used by Run Control (Orc). The
Top
alias map contains the aliases used for Monte Carlo production. If
the specified alias or alias map does not exist, or if the
corresponding key does not contain a TrgConfig object,
getTrgConfig
will report an error.
- <>
-
If no argument is given
getTrgConfig
will look up the latest configuration record in the conditions
database to find out which configuration key was last used by Run
Control. It will then fetch the TrgConfig object for that key. Note
that Run Control's database proxy writes a configuration record every
time the DAQ system is configured.
OPTIONS
The following options control the output of the command.
- -x
-
Extract the TrgConfig file under its stored name and write it to the
current directory. Without the -x option, the file is parsed
and the parsed output is written to the standard output. Both the
stored file and the parsed output represent valid inputs to the
TrgConfig parser.
- -v[vv]
-
Produce verbose output. More v's increase the verbosity.
- -q
-
Stay quiet. The opposite of -v.
DATABASE ACCESS
The
getTrgConfig
application will attempt to make a connection to a BaBar database
federation specified by the
OO_FD_BOOT
environment variable. The database schema of that federation must be
compatible with the release from which
getTrgConfig
is executed and it must have at least the configuration data loaded.
The
OO_FD_BOOT
variable should be set by the appropriate script sourced by a shell
function such as
setboot
or
ambientboot.
Note that new configuration data become available in
ambientboot
only after the regular sweeps from
ir2boot.
If a very recent configuration needs to be accessed, it may be
necessary to run the
ir2boot
script, following the usual regulations for its use.
EXAMPLES
Look up the configuration currently in use for data taking:
-
getTrgConfig
[Note that this version of the command gives the most recent result
only when run on the IR2 platform, as this requires access to
ir2boot. On other federations it will retrieve the most recent
configuration up to the time of the last sweep.]
Retrieve the current
"PHYSICS"
configuration:
-
getTrgConfig PHYSICS
Save the configuration contained under top key 1219 to disk:
-
getTrgConfig -x 1219
Look up the most recent list of aliases:
-
getTrgConfig ?
This command will look up "?" in the
Orc
default map and since an alias with that name does not exist it will
print the alias list it found. [Depending on the command shell, one
may have to quote the "?" or use any other character that does not
represent a valid alias.] The
Orc
map defines the run-types that are used for data taking, e.g.,
"PHYSICS". This version of the command is useful for looking up
the current list of run-types.
Similarly, the command
-
getTrgConfig Top/?
will print the alias list of the
Top
map. The
Top
map contains the aliases used for Monte Carlo production, e.g.,
"Dec2001-Cfg".
AUTHOR
Rainer Bartoldus <bartoldu@slac.stanford.edu>.
REPORTING BUGS
Report bugs to
bartoldu@slac.stanford.edu.
COPYRIGHT
Software developed for the BaBar Detector at the SLAC B-Factory.
Copyright © 2001 BaBar Collaboration
SEE ALSO
TrgConfig(5),
getTrgLineNames(1)
More documentation on
getTrgConfig
and the BaBar Trigger can be found on the BaBar web site
/BFROOT.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- ARGUMENTS
-
- OPTIONS
-
- DATABASE ACCESS
-
- EXAMPLES
-
- AUTHOR
-
- REPORTING BUGS
-
- COPYRIGHT
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 00:21:45 GMT, February 20, 2005
|
