dbsrv is the Bbuuzzb database server. This application is a connection oriented iterative server based upon the server IPC API that handles database requests. In the Unix/Linux and Windows environments, the TCP socket IPC method is used to communicate between client and server. In the QNX 4.x OS, QNX native message passing is used as the IPC method. Note that any mention of QNX in this document refers to the QNX 4.x OS.
The database server uses the socloc interface to manage the database server TCP configuration information including host name and TCP port number in use. Before running the Bbuuzzb server, there must be at least one socloc server and at least one system log server already running within the environment. The socloc requirement does not exist in the QNX version of the database server.
In order to use the Bbuuzzb database server, you first must setup two configuration files. The first is the socloc startup file (TCP only) and the second file is the database server configuration file which must contain the definition of tmp_path, log, catalog and session_table. The server catalog must already exist. You can create an empty catalog by creating a zero byte file. The session table must point to a directory and file name that is writable. The session_table does not have to already exist like the catalog. The database server will create a session table if one does not already exist. The database server automatically flushes all records (both active and marked for deletion) from the session table upon initialization.
Both configuration files must be located in the same directory as the binary/executable program. The Bbuuzzb database server must be executed within its current directory so the program can locate the configuration files.
When the Bbuuzzb database server starts up, it will attempt to register its host name and TCP port number with the first available socloc server (TCP only) and also communicate with the first available system log server.
The Bbuuzzb database server is a normal process and not a daemon/service.
The Bbuuzzb database server can be compiled for all stated platforms except DOS where there is no TCP IPC method.
Under the Linux/Unix/QNX operating systems, the dbsrv application can be compiled using the mkdbsrv script.
The Bbuuzzb database server command line syntax is:
TCP syntax: dbsrv [-q] port QNX syntax: dbsrv [-q]
Where port is the TCP port number that the database server will listen to. The optional parameter q is used to have the server run quietly without any console/screen output. Note that the switch character (a dash/hyphen [-] is shown here) depends on the platform the application is running on.