• Antelope Release 5.5 Linux 2.6.32-220.el6.x86_64 2015-04-21

 

NAME

dbserver - server engine for Datascope databases

SYNOPSIS

dbserver [-d port] dbname

SUPPORT


Contributed code: NO BRTT support.
THIS PIECE OF SOFTWARE WAS CONTRIBUTED BY THE ANTELOPE USER COMMUNITY. BRTT DISCLAIMS ALL OWNERSHIP, LIABILITY, AND SUPPORT FOR THIS PIECE OF SOFTWARE.

FOR HELP WITH THIS PIECE OF SOFTWARE, PLEASE CONTACT THE CONTRIBUTING AUTHOR.

DESCRIPTION

The dbserver program provides simple client-server access to Datascope databases, honoring basic requests for database operations and queries and returning the requested data in a variety of formats. The output formats currently supported are XML and Ptolemy. The input requests are formatted as parameter-files. A Tbl called recipe gives a set of dbprocess(3) commands to be performed on the database. The format parameter should be set to either xml or ptolemy, which delegates to db2xml(3) or db2ptolemy(3) to format the resulting output. Two optional tables, keys and values, may be specified in the parameter file. If provided, these tables are passed to db2xml(3) and db2ptolemy(3) as the fields and expressions arguments, allowing fine-tuning of the output fields, expressions, and tag names. See the example below.

OPTIONS

EXAMPLE


% cat sample_request.pf
recipe &Tbl{
        dbopen origin
        dbsubset ml > 5
}
format xml

keys &Tbl{
        lat
        lon
        depth
        time
}

values &Tbl{
        lat
        lon
        depth
        strtime(time)
}

% cat sample_request.pf | dbserver /opt/antelope/data/db/demo/demo
HELLO
dbserver *debug*: reading the recipe.
dbserver *debug*: performing dbprocess.
dbserver *debug*: getting 'keys' and 'values'.
dbserver *debug*: outputting results as xml
<View41>
   <row>
      <lat>35.059</lat>
      <lon>26.655</lon>
      <depth>20</depth>
      <time>4/30/1992  11:44:38.900</time>
   </row>
   <row>
      <lat>-33.594</lat>
      <lon>-72.018</lon>
      <depth>30</depth>
      <time>5/18/1992   3:02:21.500</time>
   </row>
   <row>
      <lat>-33.669</lat>
      <lon>-71.942</lon>
      <depth>44</depth>
      <time>5/22/1992   1:20:39.900</time>
   </row>
   <row>
      <lat>51.788</lat>
      <lon>-176.12</lon>
      <depth>49</depth>
      <time>5/24/1992  12:50:19.600</time>
   </row>
</View41>

BUGS AND CAVEATS

The dbserver program has not kept up with changes in the underlying libraries and may not work at all until fixed. dbserver needs to support dbquery(3) operations and session-based interactions. This is a development prototype.

AUTHOR

Tobin Fricke
Documentation begun by Kent Lindquist

Antelope User Group Contributed Software
Printer icon