reportvolfiles

Displays a list of files, and their attributes, in the specified volume.

Read syntax diagramSkip visual syntax diagram
>>-reportvolfiles--+--------+--volume_name---------------------><
                   +- -?----+
                   +- -h----+
                   '- -help-'

Parameters

–? | –h | –help
Displays a detailed description of this command, including syntax, parameter descriptions, and examples. If you specify a help option, all other command options are ignored.
volume_name
Specifies the name of the volume to report.

Prerequisites

You must have Backup, Operator, or Administrator privileges to use the command.

You must be logged in to the operating system on the engine hosting the master metadata server to run this command.

Description

This command displays the following information for each file in the specified volume:
  • Fileset name
  • Fileset directory
  • Relative file path
  • File name
This information is displayed in the following format:

fileset:fileset_directory/relative_file_path/file_name

This command is useful for performing a file-based restore operation after a user volume failure because it can list the files in a failed user volume; however, it cannot list files on a failed system volume.

Tip: This command gathers all the data before displaying any output. If there are a very large number of files on the volume, there could be a delay of several minutes before output is displayed.

Example

List files in a volume The following example displays a list of files in volume vol2:
sfscli> reportvolfiles vol2
Root:Work/doc/language.doc
NotesR5D:InfoDev/IDPlan.doc
Resources:Personnel/dept/manager/people.txt

Parent topic: Administrative commands

Related tasks
Checking the placement of current files
Listing files on a volume

Related reference
activatevol
chvol
expandvol
lslun
lsvol
mkvol
rediscoverluns
rmvol
suspendvol

Library | Support | Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.
IBM TotalStorage SAN File System v2.2