Installing the Clients

Setting Environment Variables (Optional)

There are three environment variables that you can set to point to files that ADSM uses:

DSM_DIR

Points to the executable files dsmtca and dsmstat, the resource files, and the dsm.sys file.

DSM_CONFIG

Points to the client user options file for users who create their own personalized file.

DSM_LOG

Points to the directory where you want the dsmerror.log file to reside. The error log file contains information about any errors that occur during processing.

The error log is intended for IBM service personnel to help you diagnose severe errors.

If you define DSM_LOG, ADSM writes messages to dsmerror.log in the directory you specify. If ADSM cannot write in that directory, it writes messages to dsmerror.log in the current directory.

If you do not define DSM_LOG, ADSM writes messages to dsmerror.log in the current directory.

If ADSM attempts to write to the current directory and cannot, it issues a warning message that it cannot write to the log file and continues processing.

Setting Bourne and Korn Shell Variables

For the Bourne or Korn shell, enter the environment variables in the .profile file in your $HOME directory. For example:

   DSM_DIR=/home/davehil
   DSM_CONFIG=/home/davehil/dsm.opt
   DSM_LOG=/home/davehil
   export DSM_DIR DSM_CONFIG DSM_LOG

where /home/davehil/dsm.opt is the path and file name for your client user options file, and /home/davehil is the directory where you want to store the dsmerror.log file, the executable file, the resource files, and the dsm.sys file.

Setting C Shell Variables

For the C shell, add the DSM_CONFIG and DSM_LOG variables to .cshrc in your $HOME directory. For example:

   setenv DSM_CONFIG /home/davehil/dsm.opt
   setenv DSM_LOG /home/davehil

where /home/davehil/dsm.opt is the path and file name for your client user options file, and /home/davehil is the directory where you want to store the dsmerror.log file.

Setting API Environmental Variables

If you have installed the API, set the following environmental variables:

DSMI_DIR

Points to your installation directory. In particular, the files dsmapitca, dsm.sys, and dscameng.txt must reside in the directory pointed to by DSMI_DIR. This environment variable must be present.

DSMI_CONFIG

Points to your own client user options file (dsm.opt).

DSMI_LOG

Path for dsierror.log.