Ifyouwanttoexcludespecificfilesor groupsoffilesfromcompressionprocessing during abackuporarchive operation,consider thefollowing:
v RememberthatTivoliStorageManagercomparesthefilesit processesagainst thepatterns specifiedintheinclude-excludestatements,readingfromthebottom tothetopof theoptionsfile.
v Youmust setthecompressionoptiontoyestoenablecompressionprocessing. If youdonotspecifythecompressionoptionoryouset thecompressionoption to no,TivoliStorageManagerdoesnotperformcompressionprocessing.See
“Compression”onpage144 formoreinformation.
Ifyouset thecompressionoptiontoyes andnoexclude.compressionstatements exist,TivoliStorageManagerconsidersallfilesforcompressionprocessing.
v TivoliStorageManager processesexclude.dirand otherinclude-exclude
statementsfirst.TivoliStorageManagerthenconsidersanyexclude.compression statements.For example,considerthefollowinginclude-excludelist:
exclude /Users/jones/proj1/*.*
exclude.compression /Users/jones/proj1/file.txt include /Users/jones/proj1/file.txt
TivoliStorageManager examinesthestatements(readingfrombottomtotop) anddeterminesthatthe/Users/jones/proj1/file.txtfileisacandidatefor backup,butisnotacandidateforcompressionprocessing.
v Include-excludecompressionprocessingisvalidforbackupandarchive
processingonly. Theexclude.compressionoption doesnotaffectwhetherfilesare excludedfrombackuporarchiveprocessing, onlywhethertheyare excluded fromcompressionprocessing.
Filelist
Use thefilelistoption withthefollowingcommandstoprocessalistoffiles:
v archive v deletearchive v deletebackup v expire
v
incremental v
queryarchive v
querybackup v restore v retrieve v selective
TheTivoliStorageManager clientopensthefileyouspecifywiththis optionand processesthelistoffileswithin accordingtothespecificcommand.Withthe exceptionoftherestoreandretrievecommands,whenyouusethefilelistoption, TivoliStorageManagerignoresallotherfilespecificationsonthecommandline.
Thefiles (entries)listedinthefilelistmustadhere tothefollowingrules:
v
Eachentrymustbea fullyorpartiallyqualifiedpathtoa fileordirectoryora relativepath.
v Eachentrymustbeona newline.
v Donotusewildcardcharacters.
v Eachentryresultsintheprocessingofonlyone object(fileordirectory).
v Ifthefilenamecontainsanyspaces,enclosethefilenamewithquotes.
v Thefilelistcanbe anMBCSfileor aUnicodefilewithallUnicodeentries.
v TivoliStorageManager ignoresanyentrythatisnotvalid.
Thefollowingisanexampleofa listoffileswithin afilelist:
/Users/mike/Documents/file1
/Users/van/Documents/file2
/Users/avi/Documents/file3
/Volumes/fs1/dir2/file3
"/Volumes/fs2/Ha Ha Ha/file.txt"
/Volumes/fs3/file.txt
Ifan entryinthefilelistindicatesa directory,onlythatdirectorywillbe processed and notthefileswithin thedirectory.
Ifthefilename(thefilelistspec)youspecifywith thefilelistoptiondoesnot exist, thecommandfails.TivoliStorageManagerskips anyentriesinthefilelist thatare notvalidfilesordirectories.TivoliStorageManagerlogserrorsand processingcontinuestothenextentry.
Use filespecifications withtherestoreandretrievecommandstodenotethe destination fortherestored filelistentries. Forexample,intherestorecommand:
restore -filelist=/Users/van/Documents/file3 /Users/mike/Documents/
thefilespecification/Users/mike/Documents/representstherestoredestination forall entriesinthefilelist.However,intheselectivecommand:
selective -filelist=/Users/Documents/file3 /Users/mike/Documents/
thefilespecification/Users/mike/Documents/isignored.
|
Ifyouspecifyadirectoryin afilelistforthedeletearchiveordeletebackup command, thedirectoryisnotdeleted.Fileliststhatyouusewith thedelete archiveordeletebackupcommandshouldnotincludedirectories.
The entriesinthelistareprocessedintheorderthey appearinthefilelist.For optimal processingperformance,pre-sortthefilelistbyfilespacenameandpath.
Note: TivoliStorageManagermightbackupa directorytwiceif thefollowing conditionsexist:
v
Thefilelistcontainsanentryforthedirectory
v Thefilelistcontainsoneormore entriesforfileswithin thatdirectory v Nobackupof thedirectory exists
Forexample,your filelistincludestheentries/Users/van/proj/myfileand /Users/van/proj.Iftheprojdirectory doesnotexist ontheserver,the /Users/van/projdirectoryissent totheservera secondtime.
Syntax
FILEList =
filelistspec
Parameters
filelistspec
Specifiesthelocationandnameofthefilethatcontains thelistoffiles to process withthecommand.
Note: Whenyouspecifythefilelistoption onthecommandline,thesubdir optionisignored.
Examples
Commandline:
selective -filelist=/Users/avi/Documents/filelist.txt
Filename
Use thefilename optionwiththequerysysteminfocommandtospecifyafile nameinwhichtostoreinformationgatheredfromoneormoreofthefollowing items:
v DSMOPTFILE-ThecontentsofTSM UserPreferencefile.
v DSMSYSFILE-Thecontentsofthedsm.sysfile.
v ENV-Environmentvariables.
v
ERRORLOG-TheTivoliStorageManagererrorlogfile.
v FILE-Attributesforthefilenamethatyouspecify.
v INCLEXCL-Compilesa listofinclude-excludein theorderinwhichtheyare processedduring backupand archiveoperations.
v OPTIONS-Compiledoptions.
v OSINFO-Nameandversionof theclientoperatingsystem v POLICY-Policysetdump.
v SCHEDLOG-ThecontentsoftheTivoliStorageManagerschedulelog(usually dsmsched.log.
Note: ThequerysysteminfocommandisintendedprimarilyasanaidforIBM supporttoassistindiagnosingproblems,althoughuserswho arefamiliar withtheconceptsaddressedbythisinformationmightalso findituseful.If youusetheconsoleoption,nospecial formattingoftheoutputisperformed toaccommodatescreenheightorwidth.Therefore,theconsoleoutputmight bedifficult toreaddue tolengthandline-wrapping.Inthis case,itis recommendedthatyouusethefilenameoption withthequerysysteminfo commandto allowtheoutputtobe writtentoafilethatcansubsequently besubmitted toIBMsupport.See“Console”onpage145formore
information.
Syntax
FILEName =
outputfilename
Parameters
outputfilename
Specifiesa filenameinwhichtostoretheinformation.Ifyoudo notspecifya filename, bydefaulttheinformationisstored inthedsminfo.txtfile.
Examples
Commandline:
query systeminfo dsmoptfile errorlog -filename=tsminfo.txt
Filesonly
The filesonlyoptionrestrictsbackup, restore,retrieve, orqueryprocessingtofiles only. YoucannotrestoreorretrievedirectoriesfromtheTivoliStorageManager serverwhenusingthefilesonlyoptionwith therestoreorretrieve commands.
However, directorieswithdefaultattributesare created,if required,asplaceholders for filesthatyourestoreorretrieve.
Youcanalsousethefilesonlyoptionwith thefollowingcommands:
v
archive v incremental v queryarchive v querybackup v restore
v restorebackupset v retrieve
v selective
Syntax
FILESOnly
Parameters
Thereare noparametersforthisoption.
Examples
Commandline:
dsmc incremental -filesonly
Fromdate
Use thefromdate optionwiththefromtimeoption tospecifya dateandtimefrom whichyouwanttosearchforbackups orarchivesduring arestore,retrieve, or queryoperation.Filesthatwere backeduporarchivedbefore thisdateandtime are notincluded, althougholderdirectoriesmightbe included,ifnecessary, to restoreor retrievethefiles.
Use thefromdate optionwiththefollowingcommands:
v
deletebackup v queryarchive v querybackup v restore v retrieve
Syntax
FROMDate =
date
Parameters
date
Specifiesthedatefromwhichyouwanttosearchforbackupcopiesor archivedfiles.Enterthedateintheformatyouselectedwiththedateformat option.
Whenyouinclude dateformatwitha command,itmust precedethefromdate, pitdate,and todateoptions.
Examples
Commandline:
dsmc query backup -fromdate=12/11/2003 "/Users/van/Documents/*"
Fromnode
The fromnodeoption permitsonenodetoperformcommandsforanothernode.A user onanothernodemustusethesetaccesscommandtopermityoutoquery, restore,orretrievefilesfortheothernode.
Use thefromnodeoption withthefollowingcommands:
v
queryarchive v
querybackup v
queryfilespace v querymgmtclass v restore
v retrieve
Syntax
FROMNode =
node
Parameters
node
Specifiesthenodenameonaworkstationorafileserverwhosebackupcopies orarchivedfilesyouwanttoaccess.
Examples
Commandline:
dsmc query archive -fromnode=bob -subdir=yes "/Users/van/
Documents/*"