man page(1) manual page
Table of Contents

NAME

qadd - Add a new record to a QDDB database.

SYNOPSIS

qadd [-tcl] RelationDirectory

DESCRIPTION

qadd(1) attempts to add a new tuple to the QDDB database contained in the directory RelationDirectory. In the absence of the -tcl option, qadd will attempt to invoke the user's favorite text editor on a file containing QDDB readable format.

USING A STANDARD EDITOR

A complete set of attributes with blank fields are initially given so the user can easily choose the ones (s)he needs to add. Each attribute's initial value is "" and any added value must be placed between the two double quotes. Double quotes in the data must be backslashed (\") or qadd will report an error and allow you to reinvoke the editor.

The EDITOR environment variable determines the editor used to edit each tuple. /usr/bin/vi is the default editor if the EDITOR variable is not initialized.

Tuples modified and saved in the editor are added to the Additions directory. Unsaved entries are not added.

INTERFACING WITH TCL

qadd -tcl accepts new records from standard input (stdin) in the following format (following the Schema described in the query(1) manual page):

Author,1 Eric H. Herrin II
Author,2 Raphael A. Finkel
Title,1 An ASCII Database for Fast Queries of Relatively Stable Data Description,1 This is a description with a backslashed newline \ in it. Each newline must be backslashed. Borrower.Name,1.1 Joe Moses
Borrower.Phone,1.1 (606) 222-5555
Borrower.Name,2.1 Jane Sword
Borrower.Phone,2.1 (578) 432-1234
Borrower.Phone,2.2 (578) 432-3232

SEE ALSO

qchange(1)

BUGS

The qadd program checks the modification time of the temporary file against the creation time when determining whether to add the tuple. The user must insure somehow that (s)he doesn't accidentally save an empty tuple.

Although empty tuples are allowed, they may slow the searching of the unstable database.

REFERENCES

A Guide to QDDB
Eric H. Herrin II and Raphael A. Finkel

Qddb User's Guide

An ASCII Database for Fast Queries of Relatively Stable Data Eric H. Herrin II and Raphael A. Finkel Computing Systems, Volume 4 Number 2
University of California Press, Berkeley CA

Schema and Tuple Trees: An Intuitive Structure for Representing Relational Data
Eric H. Herrin, II and Raphael A. Finkel Computing Systems, Volume 9, Number 2
MIT Press, Cambridge MA


Table of Contents