rmimage

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

Read syntax diagramSkip visual syntax diagram
>>-rmimage--+--------+-- -fileset--fileset_name--+---------+---->
            +- -?----+                           '- -quiet-'
            +- -h----+
            '- -help-'

              .------------.
              V            |
>--+-----+--+---image_name-+-+---------------------------------><
   '- -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 name of a fileset from which to delete one or more FlashCopy images.
–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.
image_name
Specifies the names of one or more FlashCopy images to delete.
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 delete.

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.

You cannot use the rmimage command while the mvfile command is in progress on a file on the same fileset.

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
FlashCopy CA_image for filset cnt_A successfully deleted.

Parent topic: Administrative commands

Related tasks
Deleting a FlashCopy image

Related reference
lsimage
mkimage
reverttoimage

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