rmimage

Deletes one or more FlashCopy® images for a specific fileset.

Read syntax diagramSkip visual syntax diagram
                                     .--------------.
                                     V              |
>>-rmimage--+--------+-- -fileset--+---fileset_name-+-+--------->
            +- -?----+             '- - --------------'
            +- -h----+
            '- -help-'

                           .------------.
                           V            |
>--+---------+--+-----+--+---image_name-+-+--------------------><
   '- -quiet-'  '- -f-'  '- - ------------'

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.
–fileset fileset_name | –
Specifies the names of one or more filesets from which to delete one or more FlashCopy images. Specifying a – indicates that you want to read the names of one or more filesets from stdin (for example, – << /work/cnt_list.txt).
–quiet
Turns off confirmation messages for this command.
–f
Forces the metadata server to delete a FlashCopy image if one or more files are open in the image tree. Changes that were made to the open files but not saved will be lost.
image_name
Specifies the names of one or more FlashCopy images to delete.
Specifies that you want to read the names of one or more FlashCopy images to delete from stdin (for example, – << /work/image_list.txt).

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

Unless you specify the –f parameter, you cannot delete a FlashCopy image if there is client activity on that image.

Depending on the age of the FlashCopy image and the amount of unique file data in the image tree, the delete operation might result in significant background activity to clean up the file-system objects that are no longer referenced.

Example

Delete a FlashCopy image The following example deletes the FlashCopy image (CA_image) from the fileset cnt_A:
sfscli> rmimage -fileset cnt_A CA_image
Are you sure you want to delete FlashCopy image CA_image? [y/n] Y
Image "CA_image" successfully deleted.

Parent topic: Administrative commands

Related reference
lsimage
mkimage
reverttoimage

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