D_RBLTST

SUMMARY
   d_rbltst([dbn])
   int dbn;

ARGUMENTS
   dbn         (optional)The number of the database containing the record

DESCRIPTION
   Function d_rlbtst will test the record lock bit of the current record to
   determine if it is set. Status code S_LOCKED is returned if the lock bit
   in the current record is set. Status S_UNLOCKED is returned if the lock
   bit of the current record is clear. It is not necessary to have locked the
   current record type.

   This function is present in the single-user version of db_VISTA, but
   performs no action. This allows multi-user applications to link with the
   single user version for operation on stand-alone computer.


CURRENCY CHANGES
   None.

RETURN CODES

     8      S_LOCKED     Current record's lock bit is already set.

     9      S_UNLOCKED   Current record's lock bit is clear. The single-
                         user version always returns an S_UNLOCKED status.


EXAMPLE
    /* ensure no info records are locked */
    for (d_recfrst(INFO);db_status == S_OKAY; recnext(INFO))
      { if ( d_rlbtst()== S_locked
        {
          /* report locked record */
           ...
          /* clear locked record */
          d_rlbclr();
         }
       }