NWReleaseLogicalRecordSet(3nw)


NWReleaseLogicalRecordSet -- unlocks all logical records but does not remove them from log table

Synopsis

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

NWCCODE N_API NWReleaseLogicalRecordSet (void);

Return Values

0x0000
SUCCESSFUL

Remarks

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.

To avoid deadlock, a workstation is required to request those files it needs to lock; it does so by making an entry into the File Log Table at the NetWare server. Once the log table is complete, the application can then lock those files. The locking works only if all files in the table are available.

NWReleaseLogicalRecordSet is ignored if the requesting workstation or process does not have locked logical records.

Services

Synchronization

NCP Calls

0x2222 23 17 Get File Server Information
0x2222 23 22 Get Station's Logged Info (old)
0x2222 23 28 Get Station's Logged Info
0x2222 104 1 Ping for NDS NCP

 
 ------------------------------------------ 
| 0x2222|  23 |  17|  Get File Server     | 
|       |     |    |  Information         | 
|-------|-----|----|----------------------| 
| 0x2222|  23 |  22|  Get Station's Logged| 
|       |     |    |  Info (old)          | 
|-------|-----|----|----------------------| 
| 0x2222|  23 |  28|  Get Station's Logged| 
|       |     |    |  Info                | 
|-------|-----|----|----------------------| 
| 0x2222|  104|  1 |  Ping for NDS NCP    | 
|-------|-----|----|----------------------| 

References

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