IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive ...

DescriptionThe description option assigns or specifies a description for files when performingarchive, delete archive, retrieve, query archive, or query backupset.For example, if you want to archive a file named budget.jan and assign to it thedescription 2002 Budget for Proj 1, you would enter:dsmc archive –des="2003 Budget for Proj 1" /home/plan/proj1/budget.janNote:1. The maximum length of a description is 254 characters.2. Enclose the value in quotes (" ") if the option value that you enter contains ablank space.Use the description option with the following commands:v archivev delete archivev query archivev query backupsetv retrieveSupported ClientsThis option is valid for all clients. The Tivoli Storage Manager client API does notsupport this option.Syntax►► DEScription = description ►◄ParametersdescriptionAssigns a description to the file you are archiving. If you do not specify adescription with the archive command, the default is Archive Date:x, where xis the current system date. Note that the date is always 10 characters long. Ifyour date format uses a two digit year, there will be two blank spaces at theend of the date. For example, a default description using a four-digit yearmight be "Archive Date: 2002/05/03", and the same default with a two-digityear might be "Archive Date: 02/05/03 " (note the two spaces at the end).When retrieving files using the two-digit year description, you can enter the-description option string in either of the following ways:-description="ArchiveDate: 02/05/03 "or-description="ArchiveDate: 02/05/03*"If you use the archive command to archive more than one file, the descriptionyou enter applies to each file. For example, to archive a group of files andassign the same description, Project X, to each file, you would enter:dsmc archive –description="Project X" "/Users/van/Documents/*.x"dsmc archive –description="Project X" "/home/allproj/.*"You can then use the description to retrieve all of the files.Chapter 10. Using processing options 289