Daylight v4.9
Release Date: 1 February 2008

Name

dt_thor_tdtlockedby - determine who locked a TDT

Generic Prototype

dt_thor_tdtlockedby(dt_Handle, dt_Handle, dt_String) => dt_String

C Prototype

#include "dt_thor.h"

dt_String dt_thor_tdtlockedby(dt_Integer *plen, dt_Handle database, dt_Handle datatype, dt_Integer len, dt_String identifier)

FORTRAN Prototype

include 'dt_f_thor.inc'

character*() dt_f_thor_tdtlockedby(database, datatype, identifier)

integer*4 database
integer*4 datatype
character*() identifier

Description

Returns the name of the user holding the lock, if any, as "user@host".

Note that a TDT (as specified by a datatype and identifier) can be locked even if it is not in the database. See dt_thor_tdtget(3) and dt_thor_settdtlocking(3) for more information about TDT record locking.

Return Value

Returns a string with the name of the user holding the lock, or an empty string (zero-length) if the TDT is not locked, or the invalid string if an error is detected.

Related Topics

dt_server(3) dt_thor_alloc_dataitem(3) dt_thor_settdtlocking(3) dt_thor_tdt2str(3) dt_thor_tdtget(3) dt_thor_tdtlocking(3) dt_thor_tdtput(3) dt_thor_xrefget(3)