Followthese generalrulestoenteroptionswitha command:
v Entera command,a dash(–), theoption name,anequalsign(=),andtheoption valueorparameter.Thereshouldbenospacesoneithersideofthe=sign.For example,
dsmc archive -description="year end 2002" /Users/agordon/Documents/proj1.rtf v Foroptionsthatdonotincludeparameters,entera command,adash(–)and the
optionname.For example,
dsmc incremental -quiet
Note: Usea leadingdash(-)toindicatethatthefollowingtextisthenameofan option.Ifanobjectnamebegins witha dash,youmust surrounditin eithersingle quotes(’) orquotationmarks(″).Mostoperatingsystem command-lineprocessorsstripthequotesbefore submittingthe
command-lineargumentstotheTivoliStorageManagerclientapplication.
Insuchcases,usingescapecharactersordoublingthequotesallowsthe clienttoreceivethequotedobjectname.Inloopmode,surroundsuch objectsineithersingle quotes(’) orquotationmarks(″).
v Entereither theoption name,oranabbreviationfortheoptionname. For example,toenterthelatestoption,entereither-lator-latest.Thecapital lettersinthesyntax ofeachoptionindicatetheminimum abbreviationforthat optionname.For informationabouthow toreadthesyntaxdiagrams,see
“Readingsyntax diagrams”onpagex.
v
Enteroptionsbeforeor aftercommandparameters. Forexample,youcanenter theoption beforeorafter afilespecification:
dsmc selective -subdir=yes "/Users/user1/Documents/*"
dsmc selective "/Users/user1/Documents/*" -subdir=yes
v Whenenteringseveraloptionsonacommand, separatethemwitha blank space.
v Enclosethevalue inquotes(" ")if theoptionvalue thatyouentercontainsa blankspace.For example:
dsmc archive -description="Project A" "/Users/user1/Documents/*"
v Mostoptionsthatyouenteronthecommandlineoverridethevalueset inthe preferencesfile.However,whenyouusethedomainoptionwith the
incrementalcommand,it addstothedomainspecifiedinyourpreferencesfile ratherthanoverridingthecurrentvalue.
v Themaximumnumberofcharacters forafilenameis256.Themaximum combinedlengthof thefilenameandpathnameischaracters.TheUnicode representationofa charactercanoccupyseveralbytes,sothemaximumnumber ofcharactersthatafilenamemightcontaincanvary.Long filenamesupportis providedwhilerunningTivoliStorageManageronMac OSX.
Table39lists clientcommandoptionsthatyoucanenteronlyonthecommandline with specificcommands.
Table39.Clientcommandoptions
Commandoption Description Commands Page
archmc Usethearchmcoptionwiththearchivecommandto specifytheavailablemanagementclassforyour policydomaintowhichyouwanttobindyour archivedfiles.
archive 128
console Usetheconsoleoptionwiththequerysysteminfo commandtooutputsysteminformationtothe console.
querysysteminfo 145
deletefiles Deletesthelocalcopyoffilesfromyourworkstation aftertheyarearchivedontheserver.
archive 149
description Assignsorspecifiesadescriptionforfileswhen performingarchive,delete,retrieve,orqueryarchive operations.
detail Displaysmanagementclass,filespace,backup,and archiveinformationdependingonthecommand withwhichitisused.
delete filespace
dirsonly Backsup,restores,archives,retrieves,orqueries directoriesonly.
filelist Specifiesalistoffilestobeprocessedforthe command.TivoliStorageManageropensthe designatedfilelistandprocessesthefileslisted withinaccordingtothecommand.
archive
filename Usethefilenameoptionwiththequerysysteminfo commandtospecifyafilenameinwhichtostore thesysteminformation.
querysysteminfo 173
Table39.Clientcommandoptions (continued)
Commandoption Description Commands Page
filesonly Backsup,restores,retrieves,orqueriesfilesonly. archive incremental
fromdate Usethefromdateoptionwiththefromtimeoption tospecifyadateandtimefromwhichyouwantto searchforbackupsorarchivesduringarestore, retrieve,orqueryoperation.
fromnode Permitsonenodetoperformcommandsforanother node.Auseronanothernodemustusetheset accesscommandtopermityoutoquery,restore,or retrievefilesfortheothernode.
query archive
fromowner Displaysfilespacesforanalternateowner.Also specifiesanalternateownerfromwhichtorestore orretrievefiles.
fromtime Specifiesabeginningtimeonthespecifieddate.Use withthefromdateoption.Thisoptionisignoredif thefromdateoptionisabsent.
query archive query backup restore retrieve
178
ifnewer Replacesexistingfileswiththelatestbackupversion onlyifthebackupversionisnewerthantheexisting version.
restore
restore backupset retrieve
182
inactive Displaysalistofactiveandinactivefileswhenused withthepickoption.
query backup restore
183
incrbydate Requestsanincrementalbackupbydate. incremental 190
latest Restoresthemostrecentbackupversionofafile whetheritisactiveorinactive.
restore 192
location SpecifieswhetherTivoliStorageManagersearches forabackupsetontheduringaqueryorrestore operation.
query backupset restore backupset
194
noprompt suppressestheconfirmationpromptthatis presentedbythedeletegroup,deletearchive, expire,restoreimage,andseteventcommands.
delete archive delete backup expire
203
optfile Specifiestheyouwanttousewhenyoustarta TivoliStorageManagersession.
205
pick Createsalistofbackupversionsorarchivecopies thatmatchthefilespecificationyouenter.Fromthe list,youcanselecttheversionstoprocess.Include theinactiveoptiontoviewbothactiveandinactive objects.
pitdate Usethepitdateoptionwiththepittimeoptionto establishapointintimeforwhichyouwantto displayorrestorethelatestversionofyourbackups.
query backup restore
211
Table39.Clientcommandoptions (continued)
Commandoption Description Commands Page
pittime Usethepittimeoptionwiththepitdateoptionto establishapointintimeforwhichyouwantto displayorrestorethelatestversionofyourbackups.
query backup restore
212
preservepath Specifieshowmuchofthesourcepathtoreproduce aspartofthetargetdirectorypathwhenyourestore orretrievefilestoanewlocation.
restore
restore backupset retrieve
217
removeoperandlimit SpecifiesthatTivoliStorageManagerremovesthe 20-operandlimitfortheMacOSXplatform.Ifyou specifytheremoveoperandlimitoptionwiththe incremental,selective,orarchivecommands,the 20-operandlimitisnotenforcedandisrestricted onlybyavailableresourcesorotheroperating systemlimits.
incremental selective archive
222
todate Usethetodateoptionwiththetotimeoptionto specifyanendingdateandtimetowhichyouwant tosearchforbackupsorarchivesduringarestore, retrieve,orqueryoperation.
totime Usethetotimeoptionwiththetodateoptionto specifyanendingdateandtimetowhichyouwant tosearchforbackupsorarchivesduringarestore, retrieve,orqueryoperation.
type Usethetypeoptionwiththequerynodecommand tospecifythetypeofnodetoquery.
querynode 264
v2archive Usethev2archiveoptionwiththearchivecommand toarchiveonlyfilestotheserver.TivoliStorage Managerwillnotprocessdirectoriesthatexistinthe pathofthesourcefilespecification.
archive 266