VAR_ENV_NAME_LOWERCASE parameter (specifies whether environment variable names in lowercase letters are supported) (Windows only)

Organization of this page

Format
Description
Operands
Notes
Examples

Format

VAR_ENV_NAME_LOWERCASE {ENABLE|DISABLE}

To Page Top

Description

This parameter specifies whether environment variable names in lowercase letters are supported.

To Page Top

Operands

ENABLE

Specifies that environment variable names in lowercase letters are supported.

Environment variable names with the same spelling but different capitalization are not identified as different environment variables in Windows, but they are recognized as separate shell variables. To avoid confusion, we recommend that you use the same capitalization for shell variables that have the same spelling.

DISABLE

Specifies that environment variable names in lowercase letters are not supported.

To Page Top

Notes

If this parameter is defined in both the system environment file and the job environment file, the definition in the job environment file takes effect.

To Page Top

Examples

This example defines shell variable names SAMPLE01 and sample01 in the job definition script and a batch file, as shown in the following.

Contents of job definition script envsample.ash

export SAMPLE01=large
export sample01=small
.\\envsample.bat | "${ADSH_DIR_CMD}grep" -i "SAMPLE01" 1>&2
echo "*** Shell variables ***" >&2
echo "SAMPLE01=$SAMPLE01" >&2
echo "sample01=$sample01" >&2

Contents of batch file envsample.bat

set

Specifying DISABLE (environment variable names in lowercase letters are not supported)

Contents of the environment variable:

#-adsh_conf VAR_ENV_NAME_LOWERCASE DISABLE
#-adsh_conf OUTPUT_MODE_ROOT  SIMPLE
#-adsh_conf OUTPUT_MODE_CHILD SIMPLE

Execution results

D:\home>"C:\Program Files\HITACHI\JP1AS\JP1ASE\bin\adshexec" envsample.ash
KNAX6712-E Specified variable "sample01" cannot be exported because the name is not in all capital letters on the current platform. filename="D:\home\envsample.ash" line=2
KNAX6521-E Command export(line=2) failed. rc=1 E-Time=0.005s C-Time=0.000s
KNAX0101-E ADSH001002 An error occurred during execution of job.
 
D:\home>

In this example, the export operation for sample01 that was executed after SAMPLE01 has failed.

Specifying ENABLE (environment variable names in lowercase letters are supported)

Contents of the environment variable:
```
#-adsh_conf VAR_ENV_NAME_LOWERCASE ENABLE
#-adsh_conf OUTPUT_MODE_ROOT  SIMPLE
#-adsh_conf OUTPUT_MODE_CHILD SIMPLE
```
Execution results
```
D:\home>"C:\Program Files\HITACHI\JP1AS\JP1ASE\bin\adshexec" envsample.ash
sample01=small
*** Shell variables ***
SAMPLE01=large
sample01=small
 
D:\home>
```
In this example, shell variables whose names are in lowercase letters can be exported. As a result, sample01, the last shell variable exported, is exported to the environment variable. Shell variables SAMPLE01 and sample01 have different values.

To Page Top