Man Linux: Main Page and Category List

NAME

       dbadb - Manage the DB-ALLe database

SYNOPSIS

       dbadb [command] [options] [args...]

DESCRIPTION

       It  allows to initialise the database, dump its contents and import and
       export data using BUFR, CREX or AOF encoding.

       dbadb always requires a non-switch argument, that indicates what is the
       operation that should be performed:

       help
              Print a help summary.

       help manpage
              Print this manpage.

       dump [options] [queryparm1=val1 [queryparm2=val2 [...]]]
              Dump  data  from the database.  Query parameters are the same of
              the Fortran API.  Please  see  the  section  "Input  and  output
              parameters  --  For data related action routines" of the Fortran
              API documentation for a complete list..

       wipe [options] [optional rep_memo description file]
              Reinitialise the database, removing all data.   Reinitialisation
              is done using the given report code description file. If no file
              is provided, a default version is used.

       import [options] filename [filename [ ... ] ]
              Import data into the database.

       export [options] rep_memo [queryparm1=val1 [queryparm2=val2 [...]]]
              Export data from the database.  Query parameters are the same of
              the  Fortran  API.  Please  see  the  section  "Input and output
              parameters -- For data related action routines" of  the  Fortran
              API documentation for a complete list..

       repinfo [options] [filename]
              Update   the   report  information  table.   Update  the  report
              information table with the  data  from  the  given  report  code
              description  file.  If no file is provided, a default version is
              used.

       cleanup [options]
              Perform  database  cleanup  operations.   The   only   operation
              currently  performed  by  this command is deleting stations that
              have no values.  If more will be added in the future, they  will
              be documented here..

       stations [options] [queryparm1=val1 [queryparm2=val2 [...]]]
              List the stations present in the database.  Query parameters are
              the same of the Fortran API. Please see the section  "Input  and
              output  parameters  --  For data related action routines" of the
              Fortran API documentation for a complete list..

       delete [options] [queryparm1=val1 [queryparm2=val2 [...]]]
              Delete all the data matching the given query parameters.   Query
              parameters  are  the  same  of  the  Fortran API. Please see the
              section "Input and output parameters -- For data related  action
              routines" of the Fortran API documentation for a complete list..

OPTIONS

       dbadb follows the usual GNU command  line  syntax,  with  long  options
       starting with two dashes (‘-’).

   Options used to connect to the database
       --dsn=(null)
              DSN,  or  URL-like database definition, to use for connecting to
              the DB-All.e database (can also be specified in the  environment
              as DBA_DB)

       --user=(null)
              username to use for connecting to the DB-All.e database

       --pass=(null)
              password to use for connecting to the DB-All.e database

   Options used to filter messages
       --category=num
              match messages with the given data category

       --subcategory=num
              match BUFR messages with the given data subcategory

       --check-digit=num
              match  CREX  messages  with  check digit (if 1) or without check
              digit (if 0)

       --unparsable
              match only messages that cannot be parsed

       --parsable
              match only messages that can be parsed

       --index=expr
              match  messages  with  the  index  in  the  given  range   (ex.:
              1-5,9,22-30)

   Option for command dump
       -?, --help
              print an help message

       --verbose
              verbose output

   Option for command wipe
       -?, --help
              print an help message

       --verbose
              verbose output

   Option for command import
       -?, --help
              print an help message

       --verbose
              verbose output

       -t type, --type=type
              format of the input data (’bufr’, ’crex’, ’aof’)

       -f, --overwrite
              overwrite existing data

       -r rep, --report=rep
              force  data to be of this type of report, specified with rep_cod
              or rep_memo values

       --fast Ignored.  This option is left here for  compatibility  with  old
              versions of dbadb.

       --no-attrs
              do not import data attributes

       --full-pseudoana
              merge  pseudoana  extra values with the ones already existing in
              the database

   Option for command export
       -?, --help
              print an help message

       --verbose
              verbose output

       -r rep, --report=rep
              force exported data to be of this type of report, specified with
              rep_cod or rep_memo values

       -d type, --dest=type
              format of the data in output (’bufr’, ’crex’, ’aof’)

       -t type.sub.local, --template=type.sub.local
              template of the data in output (autoselect if not specified)

       --dump dump data to be encoded instead of encoding it

   Option for command repinfo
       -?, --help
              print an help message

       --verbose
              verbose output

   Option for command cleanup
       -?, --help
              print an help message

   Option for command stations
       -?, --help
              print an help message

   Option for command delete
       -?, --help
              print an help message

TEMPLATE NAMES

       This  is  a  list  of possible template names for the export --template
       switch:

       acars
              Cagegory 4, subcategory 255, local category 145.

       airep
              Cagegory 4, subcategory 255, local category 142.

       amdar
              Cagegory 4, subcategory 255, local category 144.

       buoy
              Cagegory 1, subcategory 255, local category 21.

       generic
              Cagegory 255, subcategory 255, local category 0.

       metar
              Cagegory 0, subcategory 255, local category 140.

       pilot
              Cagegory 2, subcategory 255, local category 91.

       synop
              Cagegory 0, subcategory 255, local category 1.

       temp
              Cagegory 2, subcategory 255, local category 101.

       tempship
              Cagegory 2, subcategory 255, local category 102.

       It is also possible to specify a template directly by number, with  the
       syntax  "category.subcategory.localcategory",  for  example: "1.255.21"
       for buoy templates.

AUTHOR

       dbadb has been written by Enrico Zini <enrico@enricozini.com> for  ARPA
       Emilia Romagna, Servizio Idrometeorologico.

                                 jun 22, 2010