7.20.1 Environment Variable Configuration File for the Job Execution Control

File name

Any

Description

This is called by the -env environment variable configuration file name option of the qsub command and specifies environment variables to be given to a job.

File Location

Any

File Format

Multiple patterns of environment variables can be defined within each environment variable configuration file.

Delimit the patterns by putting [JOBn] starting at the first character of the first line. n is a number between 1 and 255.

It is recommended to start from [JOB1] and add in ascending order to reduce the chance of mistakes and to make maintenance easier.

Environment variable definitions are made up of a line with the environment variable name and a line with the environment variable value.

An example is shown below:

[JOB1]
ENVNAME1=DATA1                     -+                          -+
ENVVALUE1=/export/200401/data001-+2 lines make the set    |
ENVNAME2=DATA2                                                     |Pattern 1
ENVVALUE2=/export/200401/data002                              -+
[JOB2]
ENVNAME1=DATA1
ENVVALUE1=/export/200402/data001
ENVNAME2=DATA2
ENVVALUE2=/export/200402/data002

Parameters

[JOBn]: Must be included at the beginning of each pattern.

Start at the first character.
n is a number between 1 and 255. There is no restriction on the order.
If the pattern number specified by the -jo option of the qsub command cannot be found, the -jo option is omitted, and if [JOB1] does not exist, an error occurs.
If two patterns have the same number, the environment variable information in the pattern found first when searching from the beginning of the file is used.
Not all the formats in the environment variable configuration file are checked when the qsub command is submitted. Only the necessary environment variable information with the specified pattern number is loaded. So if the n in [JOBn] is not a number between 1 and 255, or not a number at all, or omitted, an error will not occur.

ENVNAMEm= environmental variable name: Specify the name for the environment variable.

ENVNAME must be used as is, with the m being a number, starting from 1 and increasing. The maximum value for m is 32.
The number inserted in place of m is searched, starting at 1. The search stops at the point where the next consecutive number cannot be found, and environment variable information found up until that point is effective. For example, if the numbers 1, 2, 3, and 5 are in place of m, the information in 1, 2, and 3 are effective, but the information in 5 is not.
An error occurs if "ENVNAME1" cannot be found.
Environment variable names and environment variable values are merged by matching the m for ENVVALUE, mentioned below.
Up to 64 bytes can be specified for environment variable names.
Any characters may be used for environment variable names.
Make sure that the environment variable names do not duplicate the environment variables set on the operating system or any other "ENVNAMEm" values.

ENVVALUEm= environment variable value: Specify the environment variable values set in the environment variables specified with ENVNAMEm.

ENVVALUE must be used as is, with the m being a number matching the m in ENVNAMEm. The maximum value for m is 32.
An error occurs if an ENVVALUEm matching the ENVNAMEm cannot be found.
Up to 256 bytes can be specified for environment variable values.
Any characters may be used for environment variable values.

Example

To set the environment variable value /export/200401/data001 in the environment variable DATA1, write as follows:

ENVNAME1=DATA1
ENVVALUE1=/export/200401/data001