Tivoli Header

Quick Start


Defining Environment Variables

An environment variable describes the operating environment of a process, such as the home directory or terminal in use. To run the server from a directory other than the default directory (/usr/tivoli/tsm/server/bin), you may have to define environment variables. For example, to define the DSMSERV_DIR environment variable to point to the /usr/tivoli/tsm/server/bin directory so that the server can find files, enter:

+--------------------------------------------------------------------------------+
|export DSMSERV_DIR=/usr/tivoli/tsm/server/bin                                   |
+--------------------------------------------------------------------------------+

You can define an environment variable to point to the server options file (dsmserv.opt). This allows two TSM servers running on the same machine to share the same options file. For example, to define the DSMSERV_CONFIG environment variable to point to dsmserv.opt, enter:

+--------------------------------------------------------------------------------+
|export DSMSERV_CONFIG=/usr/tivoli/tsm/server/bin/dsmserv.opt                    |
+--------------------------------------------------------------------------------+

You can define an environment variable to point to the accounting log file.

Accounting records are stored in the dsmaccnt.log file. The DSMSERV_ACCOUNTING_DIR environment variable specifies the directory where the accounting file is opened. If this variable is not set when the server is started, the dsmaccnt.log file is placed in the current directory when the server starts.

For example, to set the environment variable to place the accounting records in the /home/engineering directory, enter this command:

+--------------------------------------------------------------------------------+
|export DSMSERV_ACCOUNTING_DIR=/home/engineering                                 |
+--------------------------------------------------------------------------------+

The DSMLABEL utility, a standalone utility for labeling sequential access volumes, must read the dsmserv.opt file to pick up the language option. Therefore, DSMLABEL must be issued from the /usr/tivoli/tsm/server/bin/ directory, or the DSMSERV_DIR and DSMSERV_CONFIG environment variables must be set.

Notes:

  1. You can also use the -o parameter of the DSMSERV command to specify an options file name.

  2. Use the following command if your shell is in the csh family:
    +--------------------------------------------------------------------------------+
    |setenv DSMSERV_DIR /usr/tivoli/tsm/server/bin                                   |
    +--------------------------------------------------------------------------------+

  3. Use the following command if your shell is in the ksh family:
    +--------------------------------------------------------------------------------+
    |export DSMSERV_DIR=/usr/tivoli/tsm/server/bin                                   |
    +--------------------------------------------------------------------------------+

  4. To save this environment, save these entries in the .cshrc or .kshrc file of your $HOME directory.

  5. The dsmserv.dsk is always read from the directory in which the server is started.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]