Archive

The archive command archives a single file, selected files, or all files in a directory and its subdirectories on a server.

Archive files that you want to preserve in their current condition. To release storage space on your workstation, delete files as you archive them using the deletefiles option. Retrieve the archived files to your workstation whenever you need them again.

Use the snapshotroot option with the archive command along with an independent software vendor application that provides a snapshot of a logical volume to associate the data on the local snapshot with the real file space data that is stored on the IBM Spectrum® Protect server. The snapshotroot option does not provide any facilities to take a volume snapshot, only to manage data that is created by a volume snapshot.

AIX operating systems AIX® only: You can enable snapshot-based file archive by using the option snapshotproviderfs=JFS2.

Supported Clients

This command is valid for all clients.

Syntax

Parameters

filespec

Specifies the path and name of the file you want to archive. Use wildcard characters to include a group of files or to include all files in a directory.

To include multiple file specifications, separate eachfilespec parameter with a space character. If multiple file specifications are included, and two or more of the specifications have common parent directories, then it is possible for the common directory objects to be archived more than once. The conditions under which this behavior occurs are runtime-dependent, but the behavior itself has no adverse effects.

Mac OS X operating systems Oracle Solaris operating systems Linux operating systems AIX operating systems For example, if the filespec is /home/amr/ice.doc /home/amr/fire.doc, then /home and /home/amr might be archived twice. The file objects ice.doc, and fire.doc, are archived only once.

Windows operating systems For example, if the filespec is C:\proposals\drafts\ice.doc C:\proposals\drafts\fire.doc, then C:\proposals and C:\proposals\drafts might be archived twice. The file objects ice.doc and fire.doc are archived only once.

If you want to avoid including the shared parent directory more than once, use separate, non-overlapping archive commands to archive each file specification.

If you archive a file system, include a trailing slash (/home/).

There is a limit of 20 operands. This limit prevents excessive sessions that are caused when wildcards are expanded by the UNIX shell command processor. You can prevent shell expansion from causing you to go over the 20-operand limit by placing quotation marks around file specifications that contain wildcards ("home/docs/*").

You can use the removeoperandlimit option to specify that the 20-operand limit is removed. If you specify the removeoperandlimit option, the 20-operand limit is not enforced and is restricted only by available resources or other operating system limits. For example, remove the 20 operand limit to archive 21 file specifications:

selective -removeoperandlimit filespec1 filespec2 ... filespec21

If you archive a file system, include a trailing slash (C:\).

You can specify as many file specifications as available resources or other operating system limits allow.

You can use the filelist option, instead of file specifications, to identify which files to include in this operation. However, these two methods are mutually exclusive. You cannot include file specification parameters and use the filelist option. If the filelist option is specified, any file specifications that are included are ignored.

Table 1. Archive command: Related options
Option	Where to use
archmc	Command line only.
archsymlinkasfile	Client user-options file (dsm.opt) or command line.
autofsrename	Client options file (dsm.opt) only.
changingretries	Client options file (dsm.opt) or command line.
changingretries	Client system options file or command line.
compressalways	Client options file (dsm.opt) or command line.
compressalways	Client user-options file (dsm.opt) or command line.
compression	Client options file (dsm.opt) or command line.
compression	dsm.sys file within a server stanza or command line.
deletefiles	Command line only.
description	Command line only.
dirsonly	Command line only.
encryptiontype	dsm.sys file within a server stanza.
encryptiontype	Client options file (dsm.opt).
encryptkey	dsm.sys file within a server stanza.
encryptkey	Client options file (dsm.opt).
filelist	Command line only.
filesonly	Command line only.
postsnapshotcmd	Client options file (dsm.opt) or with the include.fs option.
preservelastaccessdate	Client user-options file (dsm.opt) or command line.
preservelastaccessdate	Client options file (dsm.opt) or command line.
presnapshotcmd	Client options file (dsm.opt) or with the include.fs option.
removeoperandlimit	Command line only.
skipntpermissions	Client options file (dsm.opt) or command line.
skipntsecuritycrc	Client options file (dsm.opt) or command line.
snapshotcachesize	Client options file (dsm.opt) or include.fs option.
snapshotroot	Command line only.
subdir	Client options file (dsm.opt) or command line.
tapeprompt	Client options file (dsm.opt) or command line.
v2archive	Command line only.

Examples

Task: Archive a single file that is named budget in the /home/proj1 directory.
Command: archive /home/proj1/budget
Task: Archive a single file that is named budget.jan in the c:\plan\proj1 directory.
Command: archive c:\plan\proj1\budget.jan
Task: Archive all files in the /home/proj1 directory with a file extension of .txt.
Command: archive "/home/proj1/*.txt"
Task: Archive all files in the c:\plan\proj1 directory with a file extension of .txt.
Command: archive c:\plan\proj1\*.txt
Task: Archive all files in the directory tree that is headed by the /home directory.
Command: archive -subdir=yes "/home/*"
Task: Archive all files in the c:\ drive.
Command: archive -subdir=yes c:\*.*
Task: Archive all files in the Microsoft Dfs volume, MyDfsVolume. You must specify subdir=yes to archive all files in the volume.
Command: archive \\myserver\mydfsroot\mydfsvolume\*.* -subdir=yes
Task: Assuming that you initiated a snapshot of the /usr file system and mounted the snapshot as /snapshot/day1, archive the /usr/dir1/sub1 directory tree from the local snapshot and manage it on the IBM Spectrum Protect server under the file space name /usr.
Command: dsmc archive /usr/dir1/sub1/ -subdir=yes -snapshotroot=/snapshot/day1
Task: Assuming that you initiated a snapshot of the C:\ drive and mounted the snapshot as \\florence\c$\snapshots\snapshot.0, archive the c:\dir1\sub1 directory tree from the local snapshot and manage it on the IBM Spectrum Protect server under the file space name C:.
Command: dsmc archive c:\dir1\sub1\* -subdir=yes -snapshotroot=\\florence\c$\snapshots\snapshot.0