NWReleaseLogicalRecord(3nw)


NWReleaseLogicalRecord -- unlocks logical record but does not remove it from log table

Synopsis

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

NWCCODE N_API NWReleaseLogicalRecord (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 released (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.

File Log Table contains data locking information used by a NetWare server. The NetWare server tracks this information for each workstation and workstation task. Whenever a file, logical record, or physical record is logged, information identifying the data being logged is placed in the File Log Table. Normally, a set of files or records is logged and then locked as a set. However, a single file or record can also be locked when it is placed in the table.

NWReleaseLogicalRecord is ignored if the requesting workstation has no records to release.

Services

Synchronization

NCP calls

0x2222 12 Release Logical Record

 
 -------------------------------------- 
| 0x2222|  12|  Release Logical Record| 
|-------|----|------------------------| 

References

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