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

file. This value remains in effect for the entire interactive session unless overriddenby a different value on a given interactive command. For example, if you set thesubdir option to yes in your client user options file (dsm.opt), and you specify-subdir=no on the initial command line, the -subdir=no setting remains in effect forthe entire interactive session unless overridden by the -subdir=yes value on a giveninteractive command. However, the subdir=yes value specified within theinteractive session only affects the command on which it is entered. When thatcommand completes, the value reverts back to -subdir=no, the value at thebeginning of the interactive session.ParametersCommands can have required parameters, optional parameters, or no parametersat all. Required parameters provide information to perform a task. The mostcommonly required parameter is a file specification. For example, if you want toarchive a file named budget.fin from the /project directory, you would enter:dsmc archive /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 specifies thepath and file name in storage that you want to restore. The optional parameter,destinationfilespec, specifies the path and file name where you want to place therestored files. If you do not specify the destinationfilespec, by default Tivoli StorageManager restores the files to the original source path. If you want to restore thefiles to a different directory, enter a value for destinationfilespec. For example, torestore the /project/budget.fin file to /newproj/newbudg.fin, enter:dsmc restore /project/budget.fin /newproj/newbudg.finEnter parameters in the order indicated in the command syntax diagram.File specification syntaxUse the following syntax rules when entering file specification parameters, such asfilespec, sourcefilespec, and destinationfilespec:v Do not use national language characters within the Tivoli Storage Managercommand line client interactive mode. If a file specification contains nationalcharacters, process the command in batch mode, preceding it with the executableprogram name dsmc.v If a file specification does not begin with a file space name (an opening directorydelimiter), the file specification is assumed to be a subdirectory of the currentworking directory and Tivoli Storage Manager builds the fully qualified filespecification. For example, if the current working directory is /home/me, thenthe destinationfilespec would be /home/me/mydir in the following command:dsmc restore "/fs/dir1/*" mydir/v The only command that accepts a simple file space name is the incrementalcommand. The following example is valid:dsmc i /fsThe following example is not valid:dsmc sel /fsv When entering the sourcefilespec, if the directory name ends with /, then /* isimplied.When entering a destinationfilespec, if the name ends with /, then it is considereda directory, otherwise it is considered a file.398 IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User’s Guide