6.4 Monitoring Files

Table 6-2 File Monitoring command options

Option

Description

-Flp FILE_PATH, --Files --list --path=FILE_PATH

Lists users who opened the file with the specified file path.

-Flv VOLUME_NAME, --Files --list --volume=VOLUME_NAME

Lists users and the files opened by them on the specified volume.

NOTE:Listing all files on a volume is a time-consuming operation if too many files are open, so use this option sparingly.

-Fln CONNECTION_ID, --Files --list --connection=CONNECTION_ID

Lists files opened by the user session with the specified connection ID.

-Flop FILE-PATH, --Files --list --oplock-lease-info --path=FILE-PATH

Lists users who opened the file and the oplock or lease information of the file by the specified file path.

-Flov VOLUME-NAME, --Files --list --oplock-lease-info --volume=VOLUME-NAME

Lists users, files opened by them, and the oplock or lease information of the files on the specified volume.

-Flon CONNECTION-NUMBER, --Files --list --oplock-lease-info --connection=CONNECTION-NUMBER

Lists files opened by the user session and the oplock or lease information of the files by the specified connection number.

-FCp FILE_PATH, --Files --Close --path=FILE_PATH

Closes an open file with the specified file path.

-FCn CONNECTION_ID, --Files --Close --connection=CONNECTION_ID

Closes the files opened by the user session with the specified connection ID.

-FCv VOLUME_NAME, --Files --Close --volume=VOLUME_NAME

Closes all open files on the specified volume.

You use the file listing options to view the following:

  • All open files within a particular volume

  • All open files by connection

  • All users who have open file handles for a particular file

  • Oplock or lease information of the file

You use the file closing options to close the following:

  • All open files within a particular volume

  • All open files by a particular connection

  • All open file handles associated with a particular file

If a user tries to perform any operation on an open file that was closed by using this utility, the changes might appear the next time the file is opened. This depends on the application. The data that was saved before the file was closed will be intact.

IMPORTANT:This is not the recommended way to close files. It is provided as a tool to administrators to force close open files.

Oplock or Lease Information: Specifies the oplock or lease acquired by the client on the file.

batch: Indicates the Batch Oplock.

excl: Indicates the Exclusive Oplock.

R: Indicates the Read Caching Lease.

RH: Indicates the Read Handle Caching Lease.

RW: Indicates the Read Write Caching Lease.

RWH: Indicates the Read Write Handle Caching Lease.