NWClearLogicalRecord(3nw)


NWClearLogicalRecord -- unlocks a logical record and removes it from the log table

Synopsis

   #include <nwfile.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWClearLogicalRecord (NWCONN_HANDLE conn, pnstr8 logRecName);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle containing the logical record.

logRecName
(IN) Points to the name of the logical record being cleared (128 characters).

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x89FF
LOCK_ERROR

Notices

A logical record is simply a name (a string) registered with the NetWare server. The name (as with a semaphore) can then be locked or unlocked by applications and can be used as an inter-application locking mechanism.


NOTE:

Locking or unlocking a logical record does not physically lock or unlock those resources associated with the logical record; only the applications using the record know about such an association.


Applications define logical record names. A logical record name represents a group of files, physical records, structures, etc. NWLogLogicalRecord or NWLockLogicalRecordSet lock one or more logical record names, not the actual files, physical records, or structures associated with each logical record name. Any uncooperative application can ignore a lock on the logical record name and directly lock physical files or records. Therefore, applications using logical record locks must not use other locking techniques simultaneously.

Services

Synchronization

NCP calls

0x2222 11
Clear Logical Record

References

NWClearLogicalRecordSet(3nw), NWLockLogicalRecordSet(3nw), NWLogLogicalRecord(3nw), NWReleaseLogicalRecord(3nw), NWReleaseLogicalRecordSet(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.