3.3.2 How to change settings of JP1/DH - AJE (Job Execution)

In JP1/DH - AJE (Job Execution), you can change the following settings by using environmental configuration file (config.xml):

Language that JP1/DH - AJE (Job Execution) will use.
Settings of the operation log file.

You can change the output folder, the log output level, the log file size, and the number of log backup files for the operation log file.
The location of outputting of files that is used by system.
Setting about operation of the system.
The location of work folder that is used by running of DH Custom Job.

If you use JP1/DH - AJE (Job Execution) by using default value, changing config.xml is unnecessary.

Note:

If you specified invalid value to config.xml, DH Custom Job is not executed.
The character code of config.xml is UTF-8. Do not save config.xml as other character codes. If you do so, DH Custom Job may not be executed.
If you change InfoLogSize and InfoLogBackCount, remove mmap folder that is created under the log output folder. If you don't so, those changes aren't effective.
Do not specify path name that includes multi-byte code to LogOutDir.
Language of the operation logs is decided by the system locale of OS. If you change Language that this program uses, change system locale of OS also.

Supplementary note:

If you use JP1/DH - AJE (Job Execution) in a cluster system, use the same environment settings file of JP1/DH - AJE (Job Execution) for the active node and for the standby node. In addition, specify the shared folder on the shared disk as the output log folder.

Organization of this subsection

(1) Environmental configuration file for JP1/DH - AJE (Job Execution)

(1) Environmental configuration file for JP1/DH - AJE (Job Execution)

The detail of Environmental configuration file is as follows:

(a) In Windows

File Path

<Installation folder of JP1/DH - AJE (Job Execution)>\settings\config.xml

Format of the environmental configuration file

The format of the environmental configuration file is as follows:

<?xml version="1.0" encoding="UTF-8" ?>
<config>
    <MessageLanguage>en</MessageLanguage>
    <LogOutDir>C:\ProgramData\Hitachi\jp1\jp1_default\JP1DH\AJE\AJEE\log</LogOutDir>
    <InfoLogLevel>info</InfoLogLevel>
    <InfoLogSize>5</InfoLogSize>
    <InfoLogBackCount>3</InfoLogBackCount>
    <RecvListDir>C:\Program Files\HITACHI\JP1DH\AJE\AJEE\recvlist</RecvListDir>
    <CmdJreHome>C:\Program Files\HITACHI\JP1DH\AJE\AJEE\csmi\jdk\jre</CmdJreHome>
    <SendRecvTemp>C:\ProgramData\Hitachi\jp1\jp1_default\JP1DH\AJE\AJEE\work</SendRecvTemp>
    <ResumeCount>12</ResumeCount>
    <ResumeWaitTime>300</ResumeWaitTime>
    <SuspendResumeCount>24</SuspendResumeCount>
    <SuspendResumeWaitTime>3600</SuspendResumeWaitTime>
</config>

Details of definition items

The tag name, definition item, and default value of the environmental configuration file is as follows:

Table 3‒4: Definition items of the environmental configuration file of JP1/DH - AJE (Job Execution) (In Windows)
Tag name	Definition items	Default value
MessageLanguage	Specify language that JP1/DH - AJE (Job Execution) will use. Specify MessageLanguage as follows: ja JP1/DH - AJE (Job Execution) will use Japanese. en JP1/DH - AJE (Job Execution) will use English. You can specify the above values by using lowercase and uppercase. If you didn't specify any value as MessageLanguage, JP1/DH - AJE (Job Execution) will use Japanese.	#1
LogOutDir	Specify the destination folder of outputting operation log files. The maximum length of the folder name depends on OS. The total of length of folder name and length of log file name must be less than the limit of file name length of OS. Specify suitable value to LogOutDir. If you specified the following folder to LogOutDir, the DH Custom Job isn't executed. A folder that doesn't exist. A folder that can't read by OS user who executes DH Custom Job. You should make the LogOutDir folder before you execute DH Custom Job. In addition, you should add read/write permissions to the folder for OS users who executes DH Custom Job.	`%ALLUsersProfile%\Hitachi\jp1\jp1_default\JP1DH\AJE\AJEE\log` %AllUsersProfile% shows the environment variable of the Windows (Common data storage folder for all users).
InfoLogLevel	Specify the output level of the operation log as follows: error Outputs only the error level (E). warn Outputs the error level (E) and the warning level (W). info Outputs the error level (E), the warning level (W), and the information level (I). When you specify other value to InfoLogLevel, the DH Custom Job isn't executed.	info
InfoLogSize	Specify the maximum size of the operation log file by an integer number. The minimum of InfoLogSize is 5(MB), and the maximum is 16(MB). When you specify the value outside the above range, the DH Custom Job isn't executed.	5
InfoLogBackCount	Specify the number of the backup files of operation log file by an integer number. The minimum of InfoLogBackCount is 3, and the maximum is 64. When you specify the value outside the above range, the DH Custom Job isn't executed. The name of operation log file is as follows: dhajee_information[`x`].log ([`x`] is an integer number.)	3
RecvListDir	Specify the storage folder of files that is used by system. The maximum length of the folder name depends on OS. The length of folder name + 49 must be less than the limit of file name length of OS. Specify suitable value to RecvListDir. If you specified the following folder to RecvListDir, the DH Custom Job isn't executed. A folder that doesn't exist. A folder that can't read or write by OS user who executes DH Custom Job. You should make the RecvListDir folder before you execute DH Custom Job. In addition, you should add read/write permissions to the folder for OS users who executes DH Custom Job. If you changed the value of RecvListDir, you should make a folder that is named "list", and add the same permissions of RecvListDir.	`<Installation folder of JP1/DH - AJE (Job Execution)>`\`recvlist`
CmdJreHome	This is the install destination folder of library that is used by JP1/DH -AJE (Job Execution). This item is set at the time of installation automatically. Do not change this item. When designation of the install destination folder of library includes an error, the DH Custom Job isn't executed.	`<Installation folder of JP1/DH - AJE (Job Execution)>\csmi\jdk\jre`
SendRecvTemp	Specify work folder that is used by running of DH Custom Job. If you specified the following folder to SendRecvTemp, the DH Custom Job isn't executed. A folder that doesn't exist. A folder that can't read or write by OS user who executes DH Custom Job.	`%ALLUsersProfile%\Hitachi\jp1\jp1_default\JP1DH\AJE\AJEE\work` %AllUsersProfile% shows the environment variable of the Windows (Common data storage folder for all users).
ResumeCount	When the disorder that can reopen during data transmission and reception occurs, set the maximum number of times (ResumeCount) of retry of the reopening. The minimum of ResumeCount is 0, and the maximum is 2147483647. When you specify the value outside the above range, the DH Custom Job isn't executed.	`12`
ResumeWaitTime	When the disorder that can reopen during data transmission and reception occurs, set waiting time (ResumeWaitTime) until the reopening in seconds. The minimum of ResumeWaitTime is 0(second), and the maximum is 3600(second). When you specify the value outside the above range, the DH Custom Job isn't executed.	`300`
SuspendResumeCount	When the suspended state during data transmission and reception occurs, set the maximum number of times (SuspendResumeCount) of retry of the reopening. The minimum of SuspendResumeCount is 0, and the maximum is 2147483647. When you specify the value outside the above range, the DH Custom Job isn't executed.	`24`
SuspendResumeWaitTime	When the suspended state during data transmission and reception occurs, set waiting time (SuspendResumeWaitTime) until the reopening in seconds. The minimum of SuspendResumeWaitTime is 0(second), and the maximum is 2147483647(second). When you specify the value outside the above range, the DH Custom Job isn't executed.	`3600`

#1:

The default value is decided by the system locale of OS that is defined at the installation of JP1/DH - AJE (Job Execution).

- System locale is English (or other language except for Japanese): en

- System locale is Japanese: empty or jp

If you want to change the language of JP1/DH - AJE, see 3.3.3.

(b) In Linux

File Path

/opt/jp1dh/aje/ajee/settings/config.xml

Format of the environmental configuration file

The format of the environmental configuration file is as follows:

<?xml version="1.0" encoding="UTF-8" ?>
<config>
    <MessageLanguage>en</MessageLanguage>
    <LogOutDir>/var/opt/jp1dh/aje/ajee/log</LogOutDir>
    <InfoLogLevel>info</InfoLogLevel>
    <InfoLogSize>5</InfoLogSize>
    <InfoLogBackCount>3</InfoLogBackCount>
    <RecvListDir>/opt/jp1dh/aje/ajee/recvlist</RecvListDir>
    <CmdJreHome>/opt/jp1dh/aje/ajee/csmi/jdk/jre</CmdJreHome>
    <SendRecvTemp>/var/opt/jp1dh/aje/ajee/work</SendRecvTemp>
    <ResumeCount>12</ResumeCount>
    <ResumeWaitTime>300</ResumeWaitTime>
    <SuspendResumeCount>24</SuspendResumeCount>
    <SuspendResumeWaitTime>3600</SuspendResumeWaitTime>
</config>

Details of definition items

The tag name, definition item, and default value of the environmental configuration file is as follows:

Table 3‒5: Definition items of the environmental configuration file of JP1/DH - AJE (Job Execution) (In Linux)
Tag name	Definition items	Default value
MessageLanguage	Specify language that JP1/DH - AJE (Job Execution) will use. Specify MessageLanguage as follows: ja JP1/DH - AJE (Job Execution) will use Japanese. en JP1/DH - AJE (Job Execution) will use English. You can specify the above values by using lowercase and uppercase. If you didn't specify any value as MessageLanguage, JP1/DH - AJE (Job Execution) will use Japanese.	en^(#1)
LogOutDir	Specify the destination folder of outputting operation log files. The maximum length of the folder name depends on OS. The total of length of folder name and length of log file name must be less than the limit of file name length of OS. Specify suitable value to LogOutDir. If you specified the following folder to LogOutDir, the DH Custom Job isn't executed. A folder that doesn't exist. A folder that can't read by OS user who executes DH Custom Job. You should make the LogOutDir folder before you execute DH Custom Job. In addition, you should add read/write permissions to the folder for OS users who executes DH Custom Job.	`/var/opt/jp1dh/aje/ajee/log`
InfoLogLevel	Specify the output level of the operation log as follows: error Outputs only the error level (E). warn Outputs the error level (E) and the warning level (W). info Outputs the error level (E), the warning level (W), and the information level (I). When you specify other value to InfoLogLevel, the DH Custom Job isn't executed.	info
InfoLogSize	Specify the maximum size of the operation log file by an integer number. The minimum of InfoLogSize is 5(MB), and the maximum is 16(MB). When you specify the value outside the above range, the DH Custom Job isn't executed.	5
InfoLogBackCount	Specify the number of the backup files of operation log file by an integer number. The minimum of InfoLogBackCount is 3, and the maximum is 64. When you specify the value outside the above range, the DH Custom Job isn't executed. The name of operation log file is as follows: dhajee_information[`x`].log ([`x`] is an integer number.)	3
RecvListDir	Specify the storage folder of files that is used by system. The maximum length of the folder name depends on OS. The length of folder name + 49 must be less than the limit of file name length of OS. Specify suitable value to RecvListDir. If you specified the following folder to RecvListDir, the DH Custom Job isn't executed. A folder that doesn't exist. A folder that can't read or write by OS user who executes DH Custom Job. You should make the RecvListDir folder before you execute DH Custom Job. In addition, you should add read/write permissions to the folder for OS users who executes DH Custom Job. If you changed the value of RecvListDir, you should make a folder that is named "list", and add the same permissions of RecvListDir.	`/opt/jp1dh/aje/ajee/recvlist`
CmdJreHome	This is the install destination folder of library that is used by JP1/DH -AJE (Job Execution). This item is set at the time of installation automatically. Do not change this item. When designation of the install destination folder of library includes an error, the DH Custom Job isn't executed.	`/opt/jp1dh/aje/ajee/csmi/jdk/jre`
SendRecvTemp	Specify work folder that is used by running of DH Custom Job. If you specified the following folder to SendRecvTemp, the DH Custom Job isn't executed. A folder that doesn't exist. A folder that can't read or write by OS user who executes DH Custom Job.	`/opt/jp1dh/aje/ajee/work`
ResumeCount	When the disorder that can reopen during data transmission and reception occurs, set the maximum number of times (ResumeCount) of retry of the reopening. The minimum of ResumeCount is 0, and the maximum is 2147483647. When you specify the value outside the above range, the DH Custom Job isn't executed.	`12`
ResumeWaitTime	When the disorder that can reopen during data transmission and reception occurs, set waiting time (ResumeWaitTime) until the reopening in seconds. The minimum of ResumeWaitTime is 0(second), and the maximum is 3600(second). When you specify the value outside the above range, the DH Custom Job isn't executed.	`300`
SuspendResumeCount	When the suspended state during data transmission and reception occurs, set the maximum number of times (SuspendResumeCount) of retry of the reopening. The minimum of SuspendResumeCount is 0, and the maximum is 2147483647. When you specify the value outside the above range, the DH Custom Job isn't executed.	`24`
SuspendResumeWaitTime	When the suspended state during data transmission and reception occurs, set waiting time (SuspendResumeWaitTime) until the reopening in seconds. The minimum of SuspendResumeWaitTime is 0(second), and the maximum is 2147483647(second). When you specify the value outside the above range, the DH Custom Job isn't executed.	`3600`

#1:: The default value of language which is used by JP1/DH - AJE (Job Execution) is set up en (English). If you want to change the language of JP1/DH - AJE, see 3.3.3.

To Page Top