Hitachi

Job Management Partner 1 Version 10 Job Management Partner 1/Data Highway - Automatic Job Executor Operation manual


3.3.1 How to change settings of JP1/DH - AJE (Job Definition)

In JP1/DH - AJE (Job Definition), you can change settings about operation log file by using environmental configuration file (config.xml).

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

  1. Language that JP1/DH - AJE (Job Definition) will use.

  2. 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.

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

Note:
  • If you specified invalid value to config.xml, DH Custom Job definition window doesn't be displayed.

  • The character code of config.xml is UTF-8. Do not save config.xml as other character codes. If you do so, the DH Custom Job definition window may not be displayed.

  • 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 Definition) in a cluster system, use the same environment settings file of JP1/DH - AJE (Job Definition) 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 Definition)

The detail of Environmental configuration file is as follows:

  1. File path

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

  2. 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\AJED\log</LogOutDir>
        <InfoLogLevel>info</InfoLogLevel>
        <InfoLogSize>5</InfoLogSize>
        <InfoLogBackCount>3</InfoLogBackCount>
    </config>
  3. Details of definition items

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

    Table 3‒3: Definition items of the environmental configuration file of JP1/DH - AJE (Job Definition)

    Tag name

    Definition items

    Default value

    MessageLanguage

    Specify language that JP1/DH - AJE (Job Definition) will use.

    Specify MessageLanguage as follows:

    • ja

      JP1/DH - AJE (Job Definition) will use Japanese.

    • en

      JP1/DH - AJE (Job Definition) 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 Definition) will use Japanese.

    #1

    LogOutDir

    Specify the destination folder of outputting operation log files.

    The maximum length of the destination 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 window isn't displayed.

    • A folder that doesn't exist.

    • A folder that can't read or write by OS user who uses DH Custom Job window.

    You should make the LogOutDir folder before you use DH Custom Job window.

    In addition, you should add read/write permissions to the folder for OS users who uses DH Custom Job window.

    #2

    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 window isn't displayed.

    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 window isn't displayed.

    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 window isn't displayed.

    The name of operation log file is as follows:

    • dhajed_information[x].log ([x] is an integer number.)

    3

    #1:

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

    - 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.

    #2:

    The default value is different depending on the OS.

    • For Windows XP:

    <Installation folder of JP1/DH >\log\

    • For other than Windows XP:

    %ALLUsersProfile%\Hitachi\jp1\jp1_default\JP1DH\AJE\AJED\log

    %AllUsersProfile% shows the environment variable of the Windows (Common data storage folder for all users).