NAME

       DBIx::Recordset::DBSeq - Sequence generator in DBI database

SYNOPSIS

        use DBIx::Recordset::DBSeq ;

        $self = DBIx::Recordset::DBSeq ($dbh, 'sequences', $min, $max) ;

        $val1 = $self -> NextVal ('foo') ;
        $val2 = $self -> NextVal ('foo') ;
        $val3 = $self -> NextVal ('bar') ;

DESCRIPTION

       DBIx::Recordset::FileSeq generates unique numbers. State is kept in the one table of a database
       accessible via DBI. With the new constructor you give an open database handle and specify the the table
       where state should be kept.  Optionaly you can give a min and a max values, which will be used for new
       sequences.

       With NextVal you can get the next value for the sequence of the given name.

       The table must created in the following form:

       create table
           (
           name    varchar (32),
           cnt     integer,
           maxcnt  integer,
           primary key name
           ) ;

       If the sequence value reaches the maxcnt value, NextVal will die with an error message. If maxcnt
       contains "null" there is no limit.

AUTHOR

       G.Richter (richter@dev.ecos.de)

SEE ALSO

       DBIx::Recordset