statfile

Displays metadata information about the specified files.

Read syntax diagramSkip visual syntax diagram
>>-statfile--+----------+--+-------------------------------+---->
             +- –?----+  |          .-default----------. |
             +- –h----+  '- –fmt--+-delim--character-+-'
             '- –help-'             '-xml--------------'

>--+----------------+--+------------------+--------------------->
   |        .-off-. |  |          .-on--. |
   '- –p--+-on--+-'  '- –hdr--+-off-+-'

>--+---------------+--+----------------+--+-------+------------->
   '- –r--number-'  |        .-off-. |  +- –l-+
                      '- –v--+-on--+-'  '- –s-'

     .-----------.
     V           |
>--+---file_path-+-+-------------------------------------------><
   '- – ---------'

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.
–fmt
Specifies the format of the output. You can specify one of the following values:
default
Specify this value to display output in a tabular format using spaces as the delimiter between the columns. This is the default value. For example:
OS Device Path   LUN ID   Engine WWN                Vendor  Product
===================================================================
/dev/sda              2   12:34:56:78:91:23:45:67   IBM     2105F20 

Size (MB)   Volume   State
=============================
    47000   Vol1     Assigned
delim character
Specify this value to display output in a tabular format using the specified character to separate the columns. If you use a shell metacharacter (for example, * or \t) as the delimiting character, enclose the character in single quotation marks (') or double quotation marks ("). A blank space is not a valid character. For example:
/dev/sda,2,12:34:56:78:91:23:45:67,IBM,2105F20,47000,Vol1,Assigned
xml
Specify this value to display output using XML format, for example:
<IRETURNVALUE>
<INSTANCE CLASSNAME="STC_AvailableLUNs">
<PROPERTY NAME="LUNID" TYPE="uint64"><VALUE TYPE="uint64">2</VALUE>
</PROPERTY>
<PROPERTY NAME="NodeWWN" TYPE="string"><VALUE TYPE="string">
12&58;34&58;56&58;78&58;91&58;23&58;45&58;67</VALUE></PROPERTY>
<PROPERTY NAME="Vendor" TYPE="string"><VALUE TYPE="string">IBM</VALUE>
</PROPERTY>
<PROPERTY NAME="Product" TYPE="string"><VALUE TYPE="string">2105F20
</VALUE></PROPERTY>
<PROPERTY NAME="Size" TYPE="uint64"><VALUE TYPE="uint64">47000</VALUE>
</PROPERTY>
<PROPERTY NAME="State" TYPE="uint64"><VALUE TYPE="uint64">2</VALUE>
</PROPERTY>
<PROPERTY NAME="VolumeName" TYPE="string"><VALUE TYPE="string"></VALUE>
</PROPERTY>
<PROPERTY NAME="DeviceID" TYPE="string"><VALUE TYPE="string">
&47;dev&47;sda</VALUE></PROPERTY>
</INSTANCE>
</IRETURNVALUE>
–p
Specifies whether to display one page of text at a time or all text at once.
off
Displays all text at one time. This is the default value when the sfscli command is run in single-shot mode.
on
Displays one page of text at time. Pressing any key displays the next page. This is the default value when the sfscli command is run in interactive mode.
–hdr
Specifies whether to display the table header.
on
Displays the table header. This is the default value.
off
Does not display the table header.
–r number
Specifies the number of rows per page to display when the –p parameter is on. The default is 24 rows. You can specify a value from 1 to 100.
–v
Specifies whether to enable verbose mode.
off
Disables verbose mode. This is the default value.
on
Enables verbose mode.
–l
Displays default information about the logical units (LUs).
–s
Displays default information about the LUs.
file_path
Specifies one or more file paths referenced from the global fileset for which to display information.
Restriction: Wildcards are not allowed in the file path.
Specifies that you want to read the file paths from stdin (for example, – << /work/path_list.txt).

Prerequisites

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

Description

No data is available if the fileset is detached.

You can use this command to ensure that a specific file was correctly placed into a storage pool when it was created. This helps to validate policy rules. You can also use this command to validate metadata information viewed through a client.

After a metadata server failure and recover, there is a grace period where new locks for metadata are not granted. If the fileset is in a grace period, the fileset cannot access the metadata or file information, and this command fails.

This command displays information about files, not directories or symbolic links.

If you do not specify a listing parameter, this command displays the following default information for each file:
  • File name.
  • Storage pool.
  • Fileset.
  • Metadata server.
  • File size, in megabytes.
  • Date and time that the file was last modified.
If you specify the –l listing parameter, this command displays the following information for each file in addition to the default information:
  • File type (Regular File, Directory, Symbolic Link, FIFO or unknown).
  • File block size, in bytes.
  • Number of blocks allocated to the file.
  • Number of names that reference this file.
  • Date and time that the file was created.
  • Date and time that the metadata was last modified without altering the file data (for example, moving, touching or changing permissions will affect the metadata but not the file data).
  • Date and time that the file was last accessed.
If you specify the –s listing parameter, this command displays the following information for each file:
  • File name.
  • Storage pool.
  • Fileset.

Example

List file information The following example displays information about files located in path sanfs/fileset_AP/notes/tips.nsf:
sfscli> statfile sanfs/fileset_AP/notes/tips.nsf
Name            Pool           Fileset   Size (MB)    Server
==================================================================
resources.txt   DEFAULT_POOL   FS1            0.7     ST1
sales.lwp       pool_1         OS             3.6     ST2

File Modified  
======================
Oct 15, 2003 1:22:22PM
Oct 25, 2003 5:19:03PM

Parent topic: Administrative commands

Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.