The fts lsheader command displays the fileset header from every DCE LFS fileset on a File Server machine or one of its aggregates. You control the amount of information to be displayed by including the -fast option to display only the fileset ID number of each fileset, including the -long option to display all available information about each fileset, or omitting both options to display a single line of information about each fileset. Information about the filesets is displayed in numeric order by fileset ID number if the -fast option is used; otherwise, it is displayed in alphabetical order by fileset name. To view the header of a single DCE LFS fileset, use the fts lsft command, as described in Listing FLDB and Fileset Header Information .
Non-LFS filesets do not have DCE LFS fileset headers. However, the fts lsheader command can still be used to display some local information, such as fileset ID numbers, that is stored in the dcelocal/var/dfs/dfstab file on a File Server machine.
To list information from fileset headers, do the following:
1. Verify that you have the necessary privilege. You must be included in the admin.ft file on the machine on which the filesets reside. If necessary, issue the bos lsadmin command to verify the members of the list.
2. Issue the fts lsheader command to display information from fileset headers. Include the -fast or -long option to see less or more information.
$ fts lsheader -server machine [-aggregate name] [{-fast | -long}]
Interpreting the Output
Following is an example of the output from this command when it is executed with the -fast option:
$ fts lsheader /.../abc.com/hosts/fs3 /dev/lfs1 -fast
0,,196953
0,,196956
.
.
0,,199845
0,,199846
When you omit both the -fast and -long options, the command produces the following information:
· The File Server machine name, aggregate name, and aggregate ID number where the filesets reside.
· The total number of filesets on the aggregate.
· Each fileset's name (with a .readonly or .backup extension, if appropriate).
· Each fileset's ID number.
· Each fileset's type (RW for read/write, RO for read-only, or BK for backup).
· Each fileset's allocation usage and quota usage, in kilobytes.
· Each fileset's status (On-line, Off-line, or an error indicator).
· The total number of filesets online, the total number of filesets offline, and the total number of filesets busy. A busy fileset is one upon which a fileset-related operation is currently in progress (for example, the fileset is being moved or cloned, or the Replication Server is currently forwarding changes from the fileset to read-only replicas).
Following is an example of the output from the command when it is run without the -fast or -long option:
$ fts lsheader /.../abc.com/hosts/fs3 /dev/lfs1
Total filesets on server fs3 aggregate lfs1 (ID 10): 16
user.terry 0,,196953 RW \5071 K alloc \8421 K quota \On-line
user.wvh 0,,196956 RW \4955 K alloc \9371 K quota \On-line
.
.
Total filesets on-line 15; total off-line 1; total busy 0
When you include the -long option, the command displays the following additional information for each fileset:
· Whether it is a DCE LFS (LFS) or non-LFS fileset
· Information about the state of the fileset
· The ID numbers of the parent, clone, and backup filesets that are related to the fileset
· The ID numbers of the low-level backing and low-level forward filesets that are related to the fileset
· The version number of the fileset
· The allocation and allocation usage, in kilobytes, of the fileset
· The quota and quota usage, in kilobytes, of the fileset
· The day, date, and time when the fileset was created (replicated or cloned for a read-only or backup fileset)
· The day, date, and time when the contents of the fileset were last updated (this is the same as the creation time for a read-only or backup fileset)
Following is an example of the output from the command when it is executed with the -long option:
$ fts lsheader /.../abc.com/hosts/fs3 /dev/lfs1 -long
Total filesets on server fs3 aggregate lfs1 (ID 10): 16
user.terry 0,,196953 RW LFS states 0x10010005 On-line
fs3.abc.com, aggregate lfs1 (ID 10)
Parent 0,,196953 Clone 0,,0 Backup 0,,196955
llBack 0,,0 llFwd 0,,0 Version 0,,25963
429496729 K alloc limit; \1252 K alloc usage
\15000 K quota limit; \9340 K quota usage
Creation Tue Oct 15 16:45:16 1991
Last Update Fri Nov 22 11:36:00 1991
user.wvh 0,,196956 RW LFS states 0x10010005 On-line
.
.
Total filesets on-line 15; total off-line 1; total busy 0