Help statement for relBbkExpertTcl

BbkExpertTcl V1.0 - Create TCL file for one or more datasets

Usage:
  BbkExpertTcl [OPTIONS] [[-ds] DATASET ...]

BbkExpertTcl is identical to BbkDatasetTcl, except that it allows some
additional selection options.

WARNING: BbkExpertTcl should only be used if you know what you are doing -
not all selections and combination of selections have been tested in
the context of BbkExpertTcl, so unexpected results should be expected!

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, BbkExpertTcl 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 BbkExpertTcl
                          (specify multiple times for more detail)
     --quiet              Quiet running of BbkExpertTcl

     --dbsite SITE        Connect to database at SITE (slac, ral, etc)
     --runinfo            Get lumi, run count, and peakiness from run tables

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.
  --runs RUNLIST              Comma-separated list of runs/ranges to select
  -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

and additional selection OPTIONS can be one or more of the following 95 selectors

  --use_alias --limit --group_by --order_by --distinct --where --having --with
  --inner --outer --alias --ali_tagdate --dataset --ds_name --ds_events
  --ds_lumi --input_ds --ds_description --ds_maintainer --ds_tagdate
  --link_status --prune --dse --collection --events --tot_events --events_in
  --dse_type --is_local --dse_status --dse_run_sel --ndses --dse_on_peak
  --dse_run_cycle --dse_modenum --dse_lumi --dse_nruns --tot_dse_lumi
  --reject_status --reject_type --reject_value --nrejects --reject_nev
  --reject_lumi --tot_reject_nev --tot_reject_lumi --reject_prune --use_reject
  --rejected_runs --run_status --pr_lumi --tot_lumi --dtr_events
  --tot_dtr_events --reject_runs --run_cycle --run --nruns --first_run
  --last_run --on_peak --run_events --tot_run_events --l3_lumi --tot_l3_lumi
  --condalias --bkg --modenum --input_dse --ete_nev --ete_lumi --ete_rel_id
  --release --rel_name --rel_precedence --skim --stream --skimstate --file
  --lfn --filenum --file_suffix --components --bytes --gbytes --uuid --checksum
  --nfiles --tot_bytes --tot_gbytes --file_status --site_local --site_name
  --comp_name --comp_description

For each of these selectors, --nooption and (except for --use_alias --limit
--distinct --prune --reject_prune --use_reject --rejected_runs --reject_runs)
--option-file can also be specified. There are also data items and selectors
table_id, table_pub_id, table_created, table_modified, and table_columns for
each table ali, ds, dtd, dse, reject, dtr, run, ete, rel, str, skim, file,
dfile, scnt, site, and comp as well as corresponding join columns in other
tables.

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:
  BbkExpertTcl was written by Tim Adye  and
                               Alessandra Forti