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