Distributed Operating Environment › Environmental Variables

Environmental Variables

Environmental variables are dynamic values that affect the way jobs execute on the operating environment. With CA WA Agents, these variables are set up on three levels: Agent-wide, scheduling manager (CA WA CA 7 Edition) specific, and user specific. When searching for the environmental variable, the agent looks for the user-specific environmental file and then uses the applicable manager-specific file, and lastly the agent-wide file.

To set up these files, define a .txt file with each environmental variable on a separate line, with format variable=value. On Windows, the file cannot exceed 16 KB.

Next, code the following parameters in the agentparm.txt file to invoke these environmental variables at the agent, manager, and user ID levels. The fully qualified path name to the .txt file that holds the environmental variable values follows each.

oscomponent.environment.variable=path
oscomponent.environment.variable_manager_mmmm=path
oscomponent.environment.variable_user_uuuu=path

mmmm

Indicates the manager name to which these values apply.

uuuu

Indicates the specific user ID.

For example, the agentparm.txt file may code the following:

oscomponent.environment.variable=C:\Program Files\CA\WA Agent Rvv.r\agentvars.txt 
oscomponent.environment.variable_manager_CA71SYSPLEXA=C:\Program Files\CA\WA Agent Rvv.r\ca71plexa.txt
oscomponent.environment.variable_manager_CA75SYSPLEXA=C:\Program Files\CA\WA Agent Rvv.r\ca75plexa.txt
oscomponent.environment.variable_user_user1=C:\Program Files\CA\WA Agent Rvv.r\user1vars.txt 

Note: If you place the environmental variable files in the agent directory, and you perform a CA WA Agent upgrade, save off the variable files before performing the upgrade.

Select job types can define their own environmental variable variables using the ENVAR parameter coded in the parameters that are used to execute the job.