2.6.1 Specifying the environment files
The two types of environment files are system environment files and job environment files. The supported parameters are the same. The following table explains each type of file.
|
Type of environment file |
Description |
|---|---|
|
An environment file of this type is common to all systems and is specified by the system administrator. Services and daemons use the settings in a system environment file. This environment file is used automatically when it is stored in the predefined directory. |
|
|
This environment file is specified for each job by the developer. It includes the following:
|
JP1/Advanced Shell services and daemons use the information defined in system environment files. The information defined in system environment files takes effect at the time a JP1/Advanced Shell service or daemon starts.
Job controllers use the information defined in system environment files and job environment files.
For details about the parameters that can be specified in the environment files, see 7. Parameters Specified in the Environment Files.
All directories specified in parameters in a system environment file must exist. If you wish to change the default directories, you must create the new directories beforehand.
If you have edited a system environment file in a UNIX environment, check that there are no errors by executing the adshmdctl command with the conftest option specified.
The following subsections explain how to specify each environment file.
- Organization of this subsection
(1) Specifying the system environment files
The system administrator creates and specifies the system environment files. The created system environment files take effect when they are stored on the file paths specified in the following table.
|
Environment |
File name of system environment file |
|---|---|
|
Windows (development environment) |
common-application-data-folder\HITACHI\JP1AS\JP1ASD\conf\adshrc.ase |
|
Windows (execution environment) |
common-application-data-folder\HITACHI\JP1AS\JP1ASE\conf\adshrc.ase |
|
UNIX |
/opt/jp1as/conf/adshrc.ase |
(2) Specifying the job environment files
To use a job environment file to execute batch jobs, specify the file path in the ADSH_ENV environment variable. Use the procedure described below to create and specify a job environment file.
In JP1/Advanced Shell Editor, you can specify the path for a job environment file in the Runtime Environment Settings dialog box. When you define a JP1/Advanced Shell custom job, you can specify the path for the job environment file that is to be used.
To create and specify a job environment file:
-
Copy the sample.ase environment file sample data from the following directory to a desired directory and file:#
-
Windows execution environment
installation-folder\JP1ASE\sample\sample.ase
-
Windows development environment
installation-folder\JP1ASD\sample\sample.ase
-
UNIX execution environment
/opt/jp1as/sample/sample.ase
-
-
Specify the required parameters in the copy of the job environment file.
For details about the parameters that are required in a job environment file, see 7. Parameters Specified in the Environment Files. Make sure that the encoding of the job environment file matches the value of the LANG environment variable in the environment in which job definition scripts are to be run. For details about the encoding of job environment files and the LANG environment variable, see 2.2.4 Encoding used in JP1/Advanced Shell.
-
Specify the path of the created job environment file in the ADSH_ENV environment variable so that the job environment file can be used during batch job execution.
Use one of the following methods to specify the ADSH_ENV environment variable:
-
OS setting (Windows only)
-
System profile /etc/profile (UNIX only)
-
User profile ($HOME/.profile) (UNIX only)
-
- #
-
Do not use any of the following characters in a job environment file directory or file name: & ( ) [ ] { } ^ = ; ! ' + , ` ~ # %. If any of these characters is used, JP1/Advanced Shell will not function normally.