HCL Workload Automation, Version 9.4

Setting the environment variables

About this task

Before you configure your HCL Workload Automation components, you must set the environment variables using the tws_env script.

Starting with Version 9.4, the upgrade installation process for a master domain manager and for agents installs a new version of the tws_env script in the directory <TWA_HOME>/TWS, where <TWA_HOME> is the HCL Workload Automation installation directory. A backup copy of your original version is created in a backup directory. After the upgrade process, merge the content of the new version with the content of the original version to carry your customized content into the new version.

The script is copied into the backup instance as follows:
Master domain manager upgrade
If you performed the upgrade installation using the wizard installation panels, then you specified the backup directory during the procedure.

If you performed the upgrade using the silent installation, then the backup directory is specified using the key: user.backupDir

Agent upgrade
The backup directory used when upgrading the agent is: /<working_dir>/TWA_<user_name_of_installation_user>
On Windows operating systems, run the tws_env.cmd shell script to set up both the PATH and TWS_TISDIR variables. For example, if HCL Workload Automation is installed in the %ProgramFiles%\HCL\TWA\TWS directory, the PATH variable is set as follows:
c:\Program Files\HCL\TWA\TWS;c:\Program Files\HCL\TWA\TWS\bin
Note: If you have more than one version of HCL Workload Automation installed on your computer, make sure TWS_TISDIR points to the latest one. This ensures that the most recent character set conversion tables are used.
On UNIX and Linux operating systems, source the tws_env shell script to set up both the PATH and TWS_TISDIR variables. For example, if HCL Workload Automation is installed in the default directory /opt/HCL/TWA/TWS directory, tws_env.sh sets the variables as follows:
PATH=/opt/HCL/TWA/TWS:/opt/HCL/TWA/TWS/bin:$PATH
      export PATH

TWS_TISDIR=/opt//opt/HCL/TWA/TWS
     export TWS_TISDIR
The tws_env script has two versions:
  • tws_env.sh for Bourne and Korn shell environments
  • tws_env.csh for C Shell environments