Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- db_VISTA III - d_reclstat http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
   D_RECLSTAT

SUMMARY
   d_reclstat(REC,type[,dbn])
   int REC;
   char *type;
   int dbn;

ARGUMENTS
   REC         The record type for which  the lock status is to be checked.

   type        Pointer to a character variable to contain the current lock
               type status.

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

DESCRIPTION
   This function returns the calling process's current lock status for record
   type REC in the character variable pointed to by type. The lock types
   which can be returned are as follows:
                     Type            Description
                      'r'              Read lock.
                      'w'              Write lock.
                      'x'              Exclusive lock.
                      'k'              Keep lock.
                      's'              Static record.
                      'f'              Free. The single-user version allways
                                       returns a 'f'(free) status.
   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 computers.

CURRENCY CHANGES
   None;

RETURN CODES

   -3     S_INVREC      Invalid record type specified. Perhaps you passed
                        a set or field type instead.
EXAMPLE

    char lstat;
    ...
    d_recistat(INFO,&ISTAT);
    if (lstat=='f')
           d_reclock(INFO,"r");

See Also: d_reclock d_setlstat

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson