PLBWIN_QNAME Keyword

PLBWIN Only

PLBWIN_QNAME={value}

This keyword causes the runtime to validate that two files are the same by only comparing the names of the files that have been opened. When PLBWIN_QNAME is not specified, the default validation action is to ask Windows to provide information based on the file handles of files that have been opened. Then, based on the information returned, the runtime determines if two files are the same. This method of using file handle detection is more reliable than simply comparing names under normal circumstances.

However, a problem occurred using file handle detection. The Windows 95 API was returning invalid data concerning a file handle from a NFS network connection to a Linux server. The function did not indicate a failure but simply returned bad data. If the API had indicated a failure, the runtime would fall back to the standard name comparison method.

The PLBWIN_QNAME keyword causes the runtime to bypass the comparison of file handle information and to only use the file name comparison.

The actual value is ignored, but a value must be given for the variable to be set.

PLBWIN_QNAME=YES

Note the following:

There are two situations where the runtime must validate that two files are the same:

Files are checked for an INSERT operation after a WRITE.
Files in a FILEPI are checked to determine that a given file is only locked once.

The use of the PLBWIN_QNAME keyword should not be required under normal circumstances and should only be used as a last resort to correct unexplained I38/I39 errors.
The PLBWIN_QNAME keyword is a work-around to a problem that could be a bug in a specific version of Windows or it's associate network interface drivers of which Sunbelt has no direct control. The use of PLBWIN_QNAME should be reserved to specific circumstances.