MDB_Common::nextId()MDB_Common::nextId() -- returns the next free id of a sequence Parameter
    - string
        $seq_name
 
         name of the sequence
         - boolean
        $onDemand
 
         when TRUE the sequence is
         automatic created, if it not exists.
         
  
  Return value
   resource - a free id or a
     MDB_Error, if fail
     Throws
    Table 33-1. Possible PEAR_Error values | Error code | Error message | Reason | Solution | 
|---|
 | 
        MDB_ERROR_NOT_CAPABLE
        | 
        NULL
        | 
          Function is not supported by the database backend
          | 
          Switch to another database system, if you really
          need this feature.
          |  | 
        MDB_ERROR_NOT_LOCKED
        | 
        NULL
        | 
          Locking of sequence table fails
          | 
          Database specific, check documention of your
          database,
          |  | 
        MDB_ERROR_NOSUCHTABLE
        | 
        NULL
        | 
          Sequence table was not found
          | 
          Try to create a new sequence or if you are sure, a sequence
          was already create, check database integrity
          |  
  
  NoteThis function can not be called
statically.  | 
 
 
 |