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");