Help statement for relBbkDatasetTcl
BbkDatasetTcl V2.0 - Create TCL file for one or more datasets
Usage:
BbkDatasetTcl [OPTIONS] [[-ds] DATASET ...]
Multiple dataset names may be specified, and may be wildcarded
(remember to add quotes to bypass your shell wildcard expansion).
If run without any dataset arguments, BbkDatasetTcl just prints
a list of all datasets in the bookkeeping system (same as -l '*')
OPTIONS are
-h --help -? Show this help
-V --version Show version information
-v --verbose Verbose running of BbkDatasetTcl
(specify multiple times for more detail)
--quiet Quiet running of BbkDatasetTcl
--dbsite SITE Connect to database at SITE (slac, ral, etc)
File options
-t --tcl [ MAXEVTS[,SEQNO]] Output in tcl files: number of events per
tcl nearest to the one required.
--splitruns Output in tcl files: exact number of events
required per tcl.
-b --basename FILE Base name for the tcl files default to
dataset names
Selection options
-l --list WILDCARD Comma-separated list of dataset wildcards to list
-ds --datasets DATASETS Select dataset names
(can also be specified without -ds flag)
--nolocal Include collections even if they are not
available at the site specified in --dbsite.
-s --start DATE Selects entries starting from start date
-e --end DATE Selects entries up to end date
-M --marker Write selection date in a file
incompatible with start and end
selection options
-n --newer Get entries newer than the marker file date
-o --older Get entries older than the marker file date
The -e option allows one to obtain the dataset as it was at any
time in the past. The -s option will only include collections added
since that date (prints a warning for removed collections or runs).
The dates can be specified as YY/MM/DD-hh:mm:ss with two- or four-digit
years (YY). Delimeter characters (/-: or space) can be used interchangably,
and the time of day or the seconds may be ommitted.
The time can optionally be followed by a timezone indicator
(otherwise the time is assumed to be in the local timezone):
either +/-hhmm (eg. 2004/06/28-15:45:00+0200) or -XXX (2004/06/28-06:45-PDT).
Only short-form mainland US (RFC822) and European timezone names are accepted
(eg. -GMT or -PST or -CEST; otherwise, use numeric format).
The start and end date can also be given as a tagged dataset name
(eg. A0-Run4-OnPeak-R14-GreenCircle), in which case the selection is
based on that dataset's tag date.
The -n and -o options read the date/time info from the last session info
recorded into the marker file. They are _NOT_ compatible with -s and -e for
obvious conflicting reasons.
Author:
BbkDatasetTcl was written by Tim Adye and
Alessandra Forti