Installation and User's Guide

ParametersCommands can have required parameters, optional parameters, or no parametersat all.Required parameters provide information to perform a task. The most commonlyrequired parameter is a file specification.For example, if you want to archive a file named budget.fin from the projectdirectory, you would enter the following:dsmc archive c:\project\budget.finSome commands have optional parameters. If you do not enter a value for anoptional parameter, Tivoli Storage Manager uses the default value. For example,the restore command includes a required parameter, sourcefilespec, that specifiesthe path and file name in storage that you want to restore. The optional parameter,destinationfilespec, specifies the path where you want to place the restored files. Ifyou do not specify the destinationfilespec, by default Tivoli Storage Managerrestores the files to the original source path. If you want to restore the files to adifferent directory, enter a value for destinationfilespec.Example: Restore the file c:\project\budget.fin to the new pathc:\newproj\newbudg.findsmc restore c:\project\budget.fin c:\newproj\newbudg.finEnter parameters in the order indicated in the command syntax diagram.File specification syntaxThere are some syntax rules that you need to know about when entering filespecification parameters, such as filespec, sourcefilespec, and destinationfilespec.The following are the syntax rules:v Do not use wildcards as part of the file space name or anywhere in thedestinationfilespec. The one exception to this rule is the set access commandwhere wildcards are permitted in the two lowest levels of the file spec.|||||||||||vvExample: Allow access to all files in all directories in and below the d:\testdirectory:set access backup d:\test\* * *set access backup d:\test\*\* * *There is a maximum number of file specifications per command:– The Query commands can accept only one file specification.– The restore and retrieve commands can accept a source file specification anda destination file specification.The length of a file specification is limited.– The maximum number of bytes for a file name and file path combined is6255. However, the file name itself cannot exceed 255 bytes Furthermore,directory names (including the directory delimiter) within a path are limitedto 255 bytes. The Unicode representation of a character can occupy severalbytes, so the maximum number of characters that a file name might containcan vary.When using the open file support feature with either VSS or LVSA, the TivoliStorage Manager client adds the snapshot volume name to the path of theobjects being processed. The resulting path (snapshot volume name plusobject path) must adhere to the limits above. The snapshot volume name canbe up to 1024 bytes.526 IBM Tivoli Storage Manager for Windows Backup-Archive Clients: Installation and User's Guide