lsimage

Displays a list of FlashCopy® images in all filesets or a specified fileset.

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

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

>--+--------------+--+-----+--+-------------------------+------->
   |      .-off-. |  +- -l-+  '- -fileset--fileset_name-'
   '- -v--+-on--+-'  '- -s-'

>--+-----------------------+--+----------------+---------------><
   '- -dir--directory_name-'  | .------------. |
                              | V            | |
                              +---image_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
Specifies to display output in a tabular format using spaces as the delimiter between the columns. This is the default value. For example:
Name        Fileset   Directory Name   Date
=============================================================
FCA_image   cnt_A     personnel        Dec 3, 2003 5:48:46 PM
delim character
Specifies 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, lsimage -fmt delim ',' would display output in the following format:
FCA_image,cnt_A,personnel,Dec 3, 2003 5:48:46 PM
xml
Specifies to display output using XML format, for example:
<IRETURNVALUE>
<INSTANCE CLASSNAME="STC_PitImage">
<PROPERTY NAME="FilesetName" TYPE="string"><VALUE TYPE="string">cnt_A<
/VALUE></PROPERTY>
<PROPERTY NAME="Name" TYPE="string"><VALUE TYPE="string">FCA_imag<
/VALUE></PROPERTY>
<PROPERTY NAME="InstallDate" TYPE="datetime"><VALUE TYPE="datetime">
20031203174846&#46;000009&#45;420</VALUE></PROPERTY>
<PROPERTY NAME="DirectoryName" TYPE="string"><VALUE TYPE="string">
personnel</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 FlashCopy images.
–s
Displays only the name of the FlashCopy images and the fileset associated with each.
–fileset fileset_name
Specifies the name of the fileset for which to list all FlashCopy images. If not specified, this command lists FlashCopy images in all filesets.
–dir directory_name
Specifies the directory under the .flashcopy directory from which to list the FlashCopy image. This directory can be up to 256 characters in length and must not contain backslash (\) or forward slash (/) characters as delimiters. If not specified, this command lists the FlashCopy images in all directories under the .flashcopy directory.
image_name
Specifies the names of one or more FlashCopy images to display. If not specified, this command lists all FlashCopy images in the specified fileset and directory.
Specifies that in single-shot command mode you want this command to receive from the input stream (stdin) the names of one or more FlashCopy images to display.

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, 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 –fileset, –dir, and two FlashCopy image names, the search would be performed in the following manner: WHERE fileset AND directory AND (image_name_1 OR image_name_2).

The most-recently created FlashCopy image are listed first.

If no parameters are specified, this command lists all FlashCopy images in all filesets and directories.

If you do not specify a listing parameter, this command displays the following default information for each FlashCopy image:
  • FlashCopy image name.
  • FlashCopy image state. If the FlashCopy image is in a complete state, it is intact and you can revert the fileset to that FlashCopy image. If the FlashCopy image is in an incomplete state, it contains incomplete files caused by a (forced) volume deletion. You cannot revert a fileset to that FlashCopy image.
  • Fileset name.
  • Directory name.
  • Timestamp when the FlashCopy image was created.
If you specify the –l listing parameter, this command displays the following information in addition to the default information for each FlashCopy image:
  • Description.

Example

Listing FlashCopy images The following example lists all the available information about the FlashCopy images:
sfscli> lsimage -l

Name         State       Fileset   Directory Name   Date                     Description
========================================================================================
FCC_image    Complete    cnt_C     payroll          Dec 3, 2003 5:59:14 PM   Payroll data
FCB_image    Incomplete  cnt_B     website          Dec 3, 2003 5:53:26 PM   Web site data
FCA_image    Complete    cnt_A     personnel        Dec 3, 2003 5:48:46 PM   Personnel data

Parent topic: Administrative commands

Related tasks
Listing FlashCopy images
Viewing FlashCopy image details

Related reference
mkimage
reverttoimage
rmimage

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