Get Physical Record Locks By File (old) 0x2222 23 222

Returns a logical connection's physical record locks within a file.

NetWare Servers:2.x

Request Format

Offset

Content

Type

Request header

6

FunctionCode (23)

byte

7

SubFuncStrucLen (5 + PathLen)

word (Hi-Lo)

9

SubFunctionCode (222)

byte

10

LastRecordSeen

word

12

DirectoryHandle

byte

13

PathLen

byte

14

FilePath

byte[PathLen]

Reply Format

Offset

Content

Type

Reply header

8

NextRequestRecord

word

10

NumberOfLocks

byte

11

Reserved

byte

. . .repeats NumberOfLocks times. . .

12

LoggedCount

word

14

ShareableLockCount

word

16

RecordStart

long

20

RecordEnd

long

24

LogicalConnectionNumber

word

26

TaskNumber

byte

27

LockType

byte

Parameters

LastRecordSeen

(Request) Specifies the last record for which information is returned (set to zero initially).

DirectoryHandle

(Request) Specifies the file path that is relative to this directory.

PathLen

(Request) Specifies the length of FilePath.

FilePath

(Request) Specifies the path and name of the file for which information is being requested.

NextRequestRecord

(Reply) Specifies the next value for LastRecordSeen.

NumberOfLocks

(Reply) Specifies the number of physical record locks.

LoggedCount

(Reply) Specifies the number of tasks that have the record logged.

ShareableLockCount

(Reply) Specifies the number of tasks that have the record locked in a shareable state.

RecordStart

(Reply) Specifies the byte offset where the record begins within the file.

RecordEnd

(Reply) Specifies the byte offset where the record ends within the file.

LogicalConnectionNumber

(Reply) Specifies the logical connection number for the connection that has the record exclusively locked.

TaskNumber

(Reply) Specifies the task number within the logical connection that has the file exclusively locked.

LockType

(Reply) Specifies the bits indicating the file's lock status:

  • 0x00 Not locked
  • 0xFE Locked by a file lock
  • 0xFF Locked by Begin Share File Set

Return Values

Decimal

Hex

Description

0

0x00

Successful

150

0x96

Server Out Of Memory

198

0xC6

No Console Rights

253

0xFD

Bad Station Number

255

0xFF

No Files Found

Remarks

You must have console operator privileges to call Get Physical Record Locks By File (old).

For subsequent requests, set LastRecordSeen to the value returned in the previous request in NextRequestRecord. If NextRequestRecord is zero, the server has passed all information back to the requesting client.

See Also

Get Physical Record Locks By Connection And File 0x2222 23 237, Get Physical Record Locks By File 0x2222 23 238, Get Physical Record Locks By Connection And File (old) 0x2222 23 221