HCL Workload Automation, Version 9.4

Specifying local variables and passwords in the job definitions

After defining a variable and its value with the param command, to add it within a job definition so that it is resolved locally on the agent at runtime, use the following syntax:
${agent:variable_name}
After defining a password with the param command, to add it within a job definition so that it is resolved locally on the agent at runtime, use the following syntax:
${agent:password.user_name}
You can nest variables within passwords. If you used a variable to define a user, enter the password as follows within the job definition:
${agent:password.${agent:variable_name}} 
where variable_name was previously defined as having value user_name with the param command.

Example

An HCL Workload Automation administrator needs to define a file transfer job that downloads a file from a remote server to one of the dynamic agents making up a pool of agents. The administrator wants to parametrize in the job definition:
  • The name with which the remote file will be saved locally
  • The remote user name and its password
The administrator proceeds in the following way on one of the agents:
  1. Defines a variable named localfile. The variable is given a value equal to ./npp.5.1.1.Installer.DW.exe and is created in a new variables file named FTPvars (no section). The command to do this is:
    E:\IBM\TWA\TWS\CLI\bin>param -c FTPvars..localfile ./npp.5.1.1.Installer.DW.exe
  2. Defines a variable named remoteUser. The variable is given a value equal to FTPuser and is created in the FTPvars file (no section). The command to do this is:
    E:\HCL\TWA\TWS\CLI\bin>param -c FTPvars..remoteUser FTPuser
  3. Defines the password for FTPuser. The password value is tdwb8nxt and is created in the password section of the FTPvars file. The command to do this is:
    E:\HCL\TWA\TWS\CLI\bin>param -c FTPvars.password.FTPuser tdwb8nxt
  4. With a text editor opens file
    E:\HCL\TWA\TWS\ITA\cpa\config\jm_variables_files\FTPvars
    and checks its contents:
    localfile = ./npp.5.1.1.Installer.DW.exe
    remoteuser = FTPuser
    
    [password]
    FTPuser = {aes}XMMYMY2zBHvDEDBo5DdZVmwOJao60pX1K6x2HhRcovA= 
  5. Copies file FTPvars in the agent_installation_path\TWA\TWS\ITA\cpa\config\jm_variables_files> path of every other agent defined in the pool.
  6. Starts defining the new file transfer job in the Workload Designer panel of Dynamic Workload Console. In the FileTransfer window:
    1. Enters ${agent:FTPvars..localfile} in the Local file field.
    2. Enters ${agent:FTPvars..remoteuser} in the Remote CredentialsUser Name field.
    3. Clicks the ... button next to the Remote CredentialsPassword field. The Password type window pops up and the administrator selects Agent User.
    4. After the administrator clicks the OK button for confirmation in the popup window, the Remote CredentialsPassword field is filled with the ${agent:password.${agent:FTPvars..remoteuser}} value.
  7. Fills in all the other fields to complete the job definition.
When the job is run, the entities and the password entered as variables are resolved with the values defined in the FTPvars file.