mkimage

Creates a near-instantaneous FlashCopy® image of the file layout and contents of the specified fileset and stores it in that fileset.

Read syntax diagramSkip visual syntax diagram
>>-mkimage--+----------+-- –fileset--+-fileset_name-+--------->
            +- –?----+               '- – --------'
            +- –h----+
            '- –help-'

>-- –dir--directory_name--+-------+--------------------------->
                            '- –f-'

>--+-----------------------+--image_name-----------------------><
   '- –desc--description-'

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 the fileset for which to create a FlashCopy image. Specifying a – indicates that you want to read the name of the fileset from stdin (for example, – << /work/cnt_list.txt).
–dir directory_name
Specifies the file-system directory under which you want to access the FlashCopy image. This directory can be up to 256 characters in length and must not contain backslash (\) or forward slash (/) characters as delimiters.

The directory name is created under the .flashcopy directory in the fileset. The full path of any file in the FlashCopy image is under the directory attach_point/.flashcopy/directory, where attach_point is the location to which the fileset attaches in the global namespace (for example, sanfs/cnt_A/.flashcopy/fc1dir).

Note: The .flashcopy directory is a hidden directory. Windows®-based clients must use special operating-system commands to view this directory.
–f
Forces the metadata server to delete the oldest FlashCopy image if the fileset already contains the maximum number of FlashCopy images. The oldest image is deleted even if the image is currently in use.
Attention: Any open files associated with the oldest image will be lost.
–desc description
Specifies a description for the FlashCopy image. The description must be enclosed in matching single (') or double (") quotation marks if it contains any blank characters. This description can be up to 256 characters in length.

The default is an empty string.

image_name
Specifies the name of the FlashCopy image to create. This name must be unique within the fileset and can be up to 256 characters in length.
Note: This name must not contain colons (:).

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

This command does not create FlashCopy images of nested filesets. You must create a FlashCopy image for each fileset in the hierarchy.

After you create a FlashCopy image, you cannot modify the name, description, or directory.

Until the mkimage command completes, you can view files in the fileset but not modify them.

You cannot use the mkimage command while the reverttoimage command is in progress on the same fileset.

A fileset is limited to 32 FlashCopy images at one time.

Example

Create a FlashCopy image The following example creates a FlashCopy image for the fileset cnt_A:
sfscli> mkimage –fileset cnt_A –dir website cntA_image
Image "cntA_image" successfully created.

Parent topic: Administrative commands

Related reference
lsimage
reverttoimage
rmimage

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