Content-type: text/html Manpage of GETTRGCONFIG
SLAC PEP-II
BABAR
SLAC<->RAL
Babar logo
HEPIC E,S & H Databases PDG HEP preprints
Organization Detector Computing Physics Documentation
Personnel Glossary Sitemap Search Hypernews
Unwrap page!
Det. Search
Who's who?
Meetings
FAQ
Images
Archive
Systems
Performance
Intern. region
Vertex Tracker
Drift chamber
DIRC
Calorimeter
IFR
LST
Magnet
Electronics
Trigger
Operations
Run Coordination
Contact Experts
Shift Takers Info
Operations Manual
Electronic Logbook
Ops Hypernews
Shift Signup
Check this page for HTML 4.01 Transitional compliance with the
W3C Validator
(More checks...)

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