A.2 Notes on defining an environment variable file
Before attempting to define an environment variable name in an environment variable file used for job execution, make sure that the name is valid in the operating system running on the target host.
If the target host does not support the environment variable name you define, the specification of the variable in the environment variable file will not take effect. In such a case, the environment variable is not set on the host.
The following gives precautions about syntax you must follow when defining environment variables in an environment variable file used for job execution:
- Organization of this subsection
(1) Notes on defining an environment variable file in a Windows environment
-
Code an environment variable name from the beginning of a line.
-
When specifying multiple environment variables, insert a line feed character between pairs of environment-variable-name=value.
- Example:
-
environment-variable-name-1=ABCD <return>
environment-variable-name-2=EFGH <return>
-
Make sure that you specify all entries in the environment-variable-name=value format. If you specify an entry that is not in this format, the job could terminate abnormally depending on the OS of the host on which the job is executed.
-
A sequence of characters between "=" and the line feed code is assumed to be a single value.
-
You cannot use environment variables that start with AJS (for example, AJSxxxx, where xxxx is any string) regardless of whether you specify them in uppercase or lowercase. These variables are reserved in the system.
-
You cannot use environment variables that start with JP1 (for example, JP1xxxx, where xxxx is any string) regardless of whether you specify them in uppercase or lowercase. These variables are reserved in the system.
-
Avoid using the environment variables (those shown in Table 1-6 in 1.4.2 Environment variables set when a job is executed from JP1/AJS3) because their values are set in JP1/AJS3.
-
You cannot use a reference to an environment variable as shown in the following example.
In the following example, the xyz variable is assigned the character string %abc%, and not the value of the abc environment variable.
- Example:
-
abc=1
xyz=%abc%
If you want to use a reference to an environment variable, specify the reference in the batch file for the job to be executed.
(2) Notes on defining an environment variable file in a UNIX environment
-
Code an environment variable name from the beginning of a line.
-
When specifying multiple environment variables, insert a line feed character between pairs of environment-variable-name=value.
- Example:
-
environment-variable-name-1=ABCD <return>
environment-variable-name-2=EFGH <return>
-
Make sure that you specify all entries in the environment-variable-name=value format. If you specify an entry that is not in this format, the job could terminate abnormally depending on the OS of the host on which the job is executed.
-
A sequence of characters between "=" and the line feed code is assumed to be a single value.
-
You cannot use environment variables that start with AJS (for example, AJSxxxx, where xxxx is any string) regardless of whether you specify them in uppercase or lowercase. These variables are reserved in the system.
-
You cannot use environment variables that start with JP1 (for example, JP1xxxx, where xxxx is any string) regardless of whether you specify them in uppercase or lowercase. These variables are reserved in the system.
-
Avoid using the environment variables (those shown in Table 1-6 in 1.4.2 Environment variables set when a job is executed from JP1/AJS3) because their values are set in JP1/AJS3.
-
You cannot use a reference to an environment variable as shown in the following example.
In the following example, the xyz variable is assigned the character string $abc, and not the value of the abc environment variable.
- Example:
-
abc=1
xyz=$abc
If you want to use a reference to an environment variable, specify the reference in the script file for the job to be executed.