snapcol create

Creates a collection of simultaneous snapshots of the volumes in a volume collection, or volumes you specify individually.

Format

snapcol create {coll_name|vol_name} [snap_coll_name] [description text]

Variables

coll_name

Name of a volume collection.

snap_coll_name

Optional name for the snapshot collection, up to 128 alphanumeric characters. Both autogenerated names and assigned names are appended with a timestamp, which is not part of the 64-character name length limit.

vol_name

One or more volume names, separated by commas and no spaces.

text

Text for snapshot collection description, up to 128 alphanumeric characters. If the text variable contains spaces, surround it with quotation marks.

Examples

The following command creates a snapshot collection (sc23monday) from a volume collection (coll23) that contains two volumes:

> snapcol create coll23 sc23monday description "Database Snaps"

Snapshot creation succeeded.

The actual snapshot collection name will have a timestamp appended, so it will appear in output as sc23monday-2006-06-15-13:28:54.49, for example. If the name plus the timestamp is longer than 30 characters, the name will wrap in the output of the snapcol show command.

The timestamp portion of the name is always 23 characters long, and consists of the leading hyphen, year, month, day, and hour (separated by hyphens), then the minute and second (separated by colons), a period, and an incremental number.

This leaves seven (7) available characters for the user-assigned portion of the name, before the name will wrap onto the following line of output.

The following command creates a snapshot collection from the specified volumes. The snapshot collection name is generated automatically:

> snapcol create vol1,vol2,vol3

Snapshot collection creation succeeded.

For the previous example, the snapshot collection name is "snapcol" followed by a hyphen and the timestamp; for example: snapcol-2007-05-01-09:36:42.149.