NWReleasePhysicalRecord(3nw)


NWReleasePhysicalRecord -- unlocks physical record without removing it from log table

Synopsis

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

NWCCODE N_API NWReleasePhysicalRecord (NWFILE_HANDLE fileHandle, nuint32 recStartOffset, nuint32 recSize);

Description

The parameters are as follows:

fileHandle
(IN) Specifies the file handle associated with the file containing the specified record.

recStartOffset
(IN) Specifies the offset, within the file, where the physical record begins.

recSize
(IN) Specifies the length, in bytes, of the record being released.

Return values

0x0000
SUCCESSFUL

0x8988
INVALID_FILE_HANDLE

0x89FF
LOCK_ERROR

Notices

A physical record lock, as opposed to a logical lock, is the actual lock of a specified record relative to a physical file. When a record is locked, it is also entered into a log table. Records are allowed to be locked only if all records in the log table are available for locking. This is done to avoid deadlock.

NWReleasePhysicalRecord is ignored if the requesting workstation or process does not have locked physical records.

Services

Synchronization

NCP calls

0x2222 28 Release Physical Record

 
 ---------------------------------------- 
| 0x2222|  28|  Release Physical Record | 
|-------|----|--------------------------| 

References

NWClearPhysicalRecord(3nw), NWClearPhysicalRecordSet(3nw), NWLockPhysicalRecordSet(3nw), NWLogPhysicalRecord(3nw), NWReleasePhysicalRecordSet(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.