Environment variables
Generally, setting the environment variables is an optional task. Setting them makes it more convenient for you to use the command line.
About this task
You must set the environment variables if you need to run in either of the following environments:
- You want to invoke Tivoli® Storage Manager from a directory other than the directory where Tivoli Storage Manager is installed.
- You want to specify a different options file for the backup-archive client, the administrative client, or both.
Note: You can also specify an alternate client options file for
the command-line client (not the administrative client) using the optfile option.
You
need to set four environment variables:
- PATH
- This is the default search path the operating system uses to locate executable files. Set this to include the fully qualified paths of the client installation directories.
- DSM_CONFIG
- Set this environment variable to the fully qualified path and file name of the client options file.
- DSM_DIR
- Set this environment variable to the directory where the client message file dsc*.txt is located.
- DSM_LOG
- Set this environment variable to the directory where the log files should reside.
Ensure that the environment variables meet the following guidelines:
- Include the directory where the executable files (for example,
dsm.exe) reside in the current PATH environment variable. If you accepted
the default installation directory using the C: drive, you can set
this from a command prompt by typing:
SET PATH=C:\Program Files\Tivoli\TSM\baclient
- Specify the fully-qualified path name of your client options file
(dsm.opt) using the DSM_CONFIG environment variable:
SET DSM_CONFIG=C:\Program Files\Tivoli\TSM\baclient\dsm.opt
- Define the DSM_DIR environment variable to point to the directory
where the Tivoli Storage Manager client
message file dsc*.txt is located:
SET DSM_DIR=C:\Program Files\Tivoli\TSM\baclient