#include<nwfile.h> or #include<nwcalls.h>NWCCODE N_API NWLogPhysicalRecord (NWFILE_HANDLE fileHandle, nuint32 recStartOffset, nuint32 recLength, nuint8 lockFlags, nuint16 timeOut);
The NetWare server attempts to log the record for the length of time specified by timeOutLimit before returning a time out error. timeOut is specified in units of 1/18 second (0 = no wait).
lockFlags' values follow:
0 = Log only 1 = Log and lock exclusive 3 = Log and lock shareable
timeOut is specified in units of 1/18 second (0 = no wait).
In DOS and Windows, all access to the network is blocked during any timeout period. For this reason, timeouts should be kept to an absolute minimum -- a value of 18 or less. (Even though DOS is mono-tasking, the application may be running in a DOSBOX under Windows Enhanced Mode.)
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 entered in the log table.
The release functions, NWReleasePhysicalRecord and NWReleasePhysicalRecordSet, unlock a lock or set of locks. The clear functions, NWClearPhysicalRecord and NWClearPhysicalRecordSet, unlock and remove a lock or set of locks from the log table.
In order to avoid deadlock, request those resources needed to lock by making an entry in the File Log Table at the NetWare server. Once the log table is complete, NWLogPhysicalRecord can then lock those records. The locking works only if all records in the table are available. If some of the logged resources cannot be locked, the lock fails and none of the resources are locked.
Synchronization