lsfileset

Displays a list of filesets and their attributes.

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

>--+--------------+--+----------------+--+-------------+-------->
   |      .-off-. |  |        .-on--. |  '- -r--number-'
   '- -p--+-on--+-'  '- -hdr--+-off-+-'

>--+--------------+--+-----+--+-----------------------+--------->
   |      .-off-. |  +- -l-+  '- -state--+-attached-+-'
   '- -v--+-on--+-'  '- -s-'             '-detached-'

>--+-----------------------+--+-------------------+------------->
   '- -server--server_name-'  '- -qtype--+-hard-+-'
                                         '-soft-'

>--+------------------+----------------------------------------><
   | .--------------. |
   | V              | |
   +---fileset_name-+-+
   '- - --------------'

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:
Name    Fileset State   Quota   Quota (MB)   Used (MB)   Used (%)
                        Type
=================================================================
cnt_B   Attached        Soft            20          10         50

Threshold (%)   Most Recent Image    

===================================================================
           19   Feb 6, 2003 14:54:15 PM
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:
cnt_B,Attached,Soft,20 MB,10 MB,50%,19%,Feb 6, 2003 14:54:15 PM
xml
Specify this value to display output using XML format, for example:
<IRETURNVALUE>
<INSTANCE CLASSNAME="STC_Fileset">
<PROPERTY NAME="Name" TYPE="string"><VALUE TYPE="string">cnt_B</VALUE>
</PROPERTY>
<PROPERTY NAME="State" TYPE="uint32"><VALUE TYPE="uint32">1</VALUE>
</PROPERTY>
<PROPERTY NAME="Quota" TYPE="uint64"><VALUE TYPE="uint64">20</VALUE>
</PROPERTY>
<PROPERTY NAME="IsHardQuota" TYPE="boolean"><VALUE TYPE="boolean">false
</VALUE></PROPERTY>
<PROPERTY NAME="AlertPercentage" TYPE="uint16"><VALUE TYPE="uint16">19
</VALUE></PROPERTY>
<PROPERTY NAME="SizeAllocated" TYPE="uint64"><VALUE TYPE="uint64">10
</VALUE></PROPERTY>
<PROPERTY NAME="SizeAllocatedPercentage" TYPE="uint16"><VALUE 
TYPE="uint16">50</VALUE></PROPERTY>
<PROPERTY NAME="LastPITCopyDate" TYPE="datetime"><VALUE TYPE="datetime">
20030206145415&#46;000000&#43;000</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 additional information about the filesets.
–s
Displays only the names of the filesets.
–state
Lists only the filesets that match the specified state. Possible states are:
attached
Lists only the filesets that are attached to the global namespace.
detached
Lists only the filesets that are not attached to the global namespace.
–server server_name
Lists only filesets assigned to the specified metadata server.
–qtype
Lists only the filesets that match the specified quota type. Possible types are:
hard
Lists only the filesets that have hard quotas.
soft
Lists only the filesets that have soft quotas.
fileset_name
Specifies the names of one or more filesets to list. If not specified, this command displays a list of all filesets attached to the global namespace.
Specifies that you want to read the names of one or more filesets to list from stdin (for example, – << /work/cnt_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

When you specify multiple parameters in this command, these behaviors apply:
  • Flags work as AND coordinators.
  • Objects work as OR coordinators.
  • When flags and objects are combined, the they are listed in this manner:

    WHERE flag_1 AND flag_2 AND ... AND flag_n AND (object_1 OR object_2 OR ... OR object_m)

  • When flags or objects are not required and not specified, this command searches all possible values unless a default overrides this rule.
For example, if you specify –state, –qtype, and two fileset names, the search would be performed in the following manner:

WHERE state AND quota_type AND (fileset_name_1 OR fileset_name_2)

If you do not specify a listing parameter, this command displays the following default information for each fileset:
  • Name of the fileset.
  • State of the fileset (Detached, Idle, or Inuse).
  • Quota type.
  • Quota size, in MB.
  • Amount of space used, in MB.
  • Threshold, as a percentage of space used.
  • Timestamp of the most recent FlashCopy® image.
  • Metadata server that hosts the fileset.
Tip: If the quota is not set, the values for the amount of space that is used (Used %) and the threshold (Threshold %) are displayed as 0 and have no meaning. Because the threshold value is based on the amount of space used, if the amount of space used is not defined, any value specified for the threshold value has no meaning and no alert is sent if the displayed value is exceeded.
If you specify the –l listing parameter, this command displays the following information in addition to the default information for each fileset:
  • Assigned server. (A dash (-) indicates that the fileset was dynamically assigned.)
  • State of the metadata server.
  • Number of FlashCopy images that exist for this fileset.
  • Attach point.
  • Directory name.
  • Directory path.
  • Parent fileset.
  • Number of nested filesets (children).
  • Fileset description.

Example

Listing filesets The following example lists all the available information about all filesets in the global namespace:
sfscli> lsfileset 

Name    State      Quota (MB) 	 	Quota		Used (MB)   Used (%)
                        Type
=================================================================
ROOT    Attached        Soft            20          10         50
cnt_B   Detached        Hard            88         100         48
cnt_C   Attached        Hard           120         400         45

Threshold (%)   Most Recent Image         Server

================================================
           19   -                         ST0
           70   Nov 6, 2003 20:01:48 PM   ST1
            2   Mar 7, 2003 10:36:37 PM   ST2

Parent topic: Administrative commands

Related reference
autofilesetserver
attachfileset
chfileset
detachfileset
mkfileset
reportfilesetuse
rmfileset
setfilesetserver
statfileset

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