7.3.53 VAR_ENV_NAME_LOWERCASE parameter (specifies whether environment variable names in lowercase letters are supported) (Windows only)
Syntax
VAR_ENV_NAME_LOWERCASE {ENABLE|DISABLE}
Description
This parameter specifies whether environment variable names in lowercase letters are supported.
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.
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.
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.