2.1.2 Details of the environment setting parameters for the system management

Organization of this subsection

(1) "SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT" = dword:Whether-to-issue-a-JP1-event-when-a-process-terminates-abnormally-or-times-out-at-startup
(2) "SEND_PROCESS_RESTART_EVENT" = dword:whether-to-issue-a-JP1-event-when-a-process-is-restarted
(3) "SEND_SYSTEM_STARTSTOP_EVENT" = dword:whether-to-issue-a-JP1-event-when-JP1/AJS3-is-started-or-stops
(4) "SEND_SYSTEM_CHILD_STARTSTOP_EVENT" = dword:Whether-to-issue-a-JP1-event-when-a-process-is-started-or-stops
(5) "SEND_SYSTEM_TERMINATED_ABNORMALLY_EVENT" = dword:Whether-to-issue-a-JP1-event-when-a-process-terminates-abnormally-or-times-out-at-startup
(6) "SEND_SYSTEM_RESTART_EVENT" = dword:Whether-to-issue-a-JP1-event-when-a-process-is-restarted
(7) "AJSSYSDIR" = "name-of-system-directory"
(8) "AJSLOGDIR" = "directory-name-for-log"
(9) "HOSTLOGSIZE" = dword:size-of-scheduler-log-file-for-a-host
(10) "HOSTLOGFILE1" = "name-of-scheduler-log-file-1-for-a-host"
(11) "HOSTLOGFILE2" = "name-of-scheduler-log-file-2-for-a-host"
(12) "HOSTLOGOUTPUTYEAR" = "{yes|no}"
(13) "HOSTLOGHEADER" = "{none|PID}"
(14) "HLOGDLOG" = "{none|all}"
(15) "HLOGDSYSLOG" = "{none|all}"
(16) "LOGSIZE" = dword:size-of-the-system-management-log
(17) "LOGFILENUM" = dword:Number-of-system-management-log-files

(1) "SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT" = dword:Whether-to-issue-a-JP1-event-when-a-process-terminates-abnormally-or-times-out-at-startup

Use this parameter to specify whether to issue a JP1 event when a process terminates abnormally or times out at startup.

This parameter ensures compatibility when you upgrade from an old version. In an upgrade, the parameter setting is inherited.

Specifiable values

0: A JP1 event is not issued.
1: A JP1 event is issued.

Default value

dword:00000000 (0 in decimal)

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts

To Page Top

(2) "SEND_PROCESS_RESTART_EVENT" = dword:whether-to-issue-a-JP1-event-when-a-process-is-restarted

Use this parameter to specify whether to issue a JP1 event when the process is restarted.

This parameter ensures compatibility when you upgrade from an old version. In an upgrade, the parameter setting is inherited.

Specifiable values

0: A JP1 event is not issued.
1: A JP1 event is issued.

Default value

dword:00000000 (0 in decimal)

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts

To Page Top

(3) "SEND_SYSTEM_STARTSTOP_EVENT" = dword:whether-to-issue-a-JP1-event-when-JP1/AJS3-is-started-or-stops

Use this parameter to specify whether to issue a JP1 event when the JP1/AJS3 service starts or stops.

Specifiable values

0: A JP1 event is not issued.
1: A JP1 event is issued.

Default value

dword:00000000 (0 in decimal)

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts

To Page Top

(4) "SEND_SYSTEM_CHILD_STARTSTOP_EVENT" = dword:Whether-to-issue-a-JP1-event-when-a-process-is-started-or-stops

Use this parameter to specify whether to issue a JP1 event when a process starts or stops.

The applicable processes are as follows:

In Windows:

Child process of jajs_spmd.exe
Child process of jajs_dbmd.exe, jajs_hstd.exe, jajs_agtd.exe, and jajs_schd.exe

In UNIX:

Child process of jajs_spmd
Child process of jajs_dbmd, jajs_hstd, jajs_agtd, and jajs_schd

For details about processes, see the B.2 Processes (for Windows) in the manual Job Management Partner 1/Automatic Job Management System 3 Troubleshooting or B.3 Processes (for UNIX) in the manual Job Management Partner 1/Automatic Job Management System 3 Troubleshooting.

Specifiable values

0: A JP1 event is not issued.
1: A JP1 event is issued.

Default value

dword:00000000 (0 in decimal)

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts

To Page Top

(5) "SEND_SYSTEM_TERMINATED_ABNORMALLY_EVENT" = dword:Whether-to-issue-a-JP1-event-when-a-process-terminates-abnormally-or-times-out-at-startup

Use this parameter to specify whether to issue a JP1 event when a process terminates abnormally or times out at startup.

The applicable processes are as follows:

In Windows:

Child process of jajs_spmd.exe
Child process of jajs_dbmd.exe, jajs_hstd.exe, jajs_agtd.exe, and jajs_schd.exe

In UNIX:

Child process of jajs_spmd
Child process of jajs_dbmd, jajs_hstd, jajs_agtd, and jajs_schd

For details about the processes, see B.2 Processes (for Windows) in the manual Job Management Partner 1/Automatic Job Management System 3 Troubleshooting or B.3 Processes (for UNIX) in the manual Job Management Partner 1/Automatic Job Management System 3 Troubleshooting.

This environment setting parameter has the same functionality as the SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT environment setting parameter. In an environment configured by a new installation, specify the SEND_SYSTEM_TERMINATED_ABNORMALLY_EVENT environment setting parameter.

Do not specify this parameter together with the SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT environment setting parameter. If you specify these parameters concurrently with 1 specified for either parameter, a JP1 event will be issued.

Specifiable values

0: A JP1 event is not issued.
1: A JP1 event is issued.

Default value

dword:00000000 (0 in decimal)

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts

To Page Top

(6) "SEND_SYSTEM_RESTART_EVENT" = dword:Whether-to-issue-a-JP1-event-when-a-process-is-restarted

Use this parameter to specify whether to issue a JP1 event when a process is restarted.

This environment setting parameter has the same functionality as the SEND_PROCESS_RESTART_EVENT environment setting parameter. In an environment configured by a new installation, specify the SEND_SYSTEM_RESTART_EVENT environment setting parameter.

Do not specify this parameter together with the SEND_PROCESS_RESTART_EVENT environment setting parameter. If you specify these parameters concurrently with 1 specified for either parameter, a JP1 event will be issued.

Specifiable values

0: A JP1 event is not issued.
1: A JP1 event is issued.

Default value

dword:00000000 (0 in decimal)

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts

To Page Top

(7) "AJSSYSDIR" = "name-of-system-directory"

Use this parameter to specify the name of the directory in which the JP1/AJS3 system files are to be created. Specify a full path name.

Determine the name based on operating requirements and an estimate of required disk space.

For users with administrator permissions or superuser permissions, set the update permission (rwx for UNIX) for this directory. For all users, set the operation permission (rx for UNIX).

Specifiable values

In Windows:

A character string of no more than 180 bytes
In UNIX:

A character string of no more than 191 bytes

Do not use either semicolons (;) or spaces.

Default value

For Windows Server 2012 or Windows Server 2008, if the installation folder is in the default folder or a folder protected by the system:

%ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\sys

The default value of %ALLUSERSPROFILE% is system-drive\ProgramData.

A folder protected by the system is the path to a folder in any of the following:

- system-drive\Windows

- system-drive\Program Files

- system-drive\Program Files (x86) (for 64-bit Windows)
For Windows Server 2012 or Windows Server 2008 in which an installation folder other than the above is used:

JP1/AJS3-Manager-installation-folder\sys
For Windows Server 2003:

JP1/AJS3-Manager-installation-folder\sys
In UNIX:

/var/opt/jp1ajs2/sys/

Recommended value

For a physical host:

Default value
For a logical host:

The value set at the time of setup.

When the setting takes effect

The next time the JP1/AJS3 service starts

Cautionary notes

The default folders and directories also have uses that are not related to this environment setting parameter. Do not delete the default folders or directories even if you have changed the environment setting parameter.
Specify different paths for the physical and logical hosts.
Specify a path on the shared disk for logical hosts in a cluster configuration.

To Page Top

(8) "AJSLOGDIR" = "directory-name-for-log"

Use this parameter to specify the name of the directory in which JP1/AJS3 log files are to be created. Specify a full path name.

Determine the name based on operating requirements and an estimate of the required disk space.

For all users, set the update permission (rwx for UNIX) for this directory.

Specifiable values

In Windows:

A character string of no more than 180 bytes
In UNIX:

A character string of no more than 191 bytes

Do not use either semicolons (;) or spaces.

Default value

For Windows Server 2012 or Windows Server 2008, if the installation folder is in the default folder or a folder protected by the system:

%ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\log

The default value of %ALLUSERSPROFILE% is system-drive\ProgramData.

A folder protected by the system is the path to a folder in any of the following:

- system-drive\Windows

- system-drive\Program Files

- system-drive\Program Files (x86) (for 64-bit Windows)
For Windows Server 2012 or Windows Server 2008 in which an installation folder other than the above is used:

JP1/AJS3-Manager-installation-folder\log
For Windows Server 2003:

JP1/AJS3-Manager-installation-folder\log
In UNIX:

/var/opt/jp1ajs2/log

Recommended value

For a physical host:

Default value
For a logical host:

The value set at the time of setup.

When the setting takes effect

The next time the JP1/AJS3 service starts

Cautionary notes

The default folders and directories also have uses that are not related to this environment setting parameter. Do not delete the default folders or directories even if you have changed the environment setting parameter.
Specify different paths for the physical and logical hosts.
Specify a path on the shared disk for logical hosts in a cluster configuration.

To Page Top

(9) "HOSTLOGSIZE" = dword:size-of-scheduler-log-file-for-a-host

Use this parameter to specify the size of log files.

The ajsinetd authentication error log (KAVS1009-W) and the log data when ajshlogd starts (KAVS0220-I) and when it stops (KAVS0221-I), are output to log files. However, if host is output to AJSLOGOUTPUTDEST, which is an environment setting parameter in scheduler service environment settings, the scheduler log of the appropriate scheduler service is output. Accordingly, specify a size sufficient for storing the data of at least one day so that you can check the execution status of a job or jobnet.

For details about how to estimate the log file size when specifying the settings for outputting the scheduler log of a scheduler service, see 3.4.1 Estimating the size of scheduler log files in the Job Management Partner 1/Automatic Job Management System 3 System Design (Configuration) Guide.

Specifiable values

A hexadecimal value (in kilobytes) from 0 to 1E8480 (0 to 2,000,000 in decimal).

If you specify dword:00000000, the system does not create a log file.

Default value

dword:00000000 (0 in decimal)

During a new installation of JP1/AJS3 or upgrade installation from version 8 or earlier, and during setup of cluster operation, dword:00002800 (10,240 in decimal) is set.

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts

To Page Top

(10) "HOSTLOGFILE1" = "name-of-scheduler-log-file-1-for-a-host"

Use this parameter to specify a log file name. Specify a full path name.

Specify a file name that is different from the name of the scheduler log file 2 on any other host.

When the amount of information written to this log file equals or is greater than the specified size, the system writes subsequent information to log file 2.

Specify different paths for the physical and logical hosts.

In UNIX, you cannot omit this parameter if you use a scheduler log file for a host.

Specifiable values

A character string of no more than 255 bytes

Default value

For Windows Server 2012 or Windows Server 2008, if the installation folder is in the default folder or a folder protected by the system:

%ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\log\ajs-host-log1.log

The default value of %ALLUSERSPROFILE% is system-drive\ProgramData.

A folder protected by the system is the path to a folder in any of the following:

- system-drive\Windows

- system-drive\Program Files

- system-drive\Program Files (x86) (for 64-bit Windows)
For Windows Server 2012 or Windows Server 2008 in which an installation folder other than the above is used:

JP1/AJS3-Manager-installation-folder\log\ajs-host-log1.log
For Windows Server 2003:

JP1/AJS3-Manager-installation-folder\log\ajs-host-log1.log
In UNIX:

/var/opt/jp1ajs2/log/ajs-host-log1.log

Recommended value

For a physical host:

Default value
For a logical host:

The value set at the time of setup.

When the setting takes effect

The next time the JP1/AJS3 service starts

To Page Top

(11) "HOSTLOGFILE2" = "name-of-scheduler-log-file-2-for-a-host"

Use this parameter to specify a log file name. Specify a full path name.

Specify different paths for the physical and logical hosts.

In UNIX, you cannot omit this parameter when you use a scheduler log file for a host.

Specifiable values

A character string of no more than 255 bytes

Default value

For Windows Server 2012 or Windows Server 2008, if the installation folder is in the default folder or a folder protected by the system:

%ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\log\ajs-host-log2.log

The default value of %ALLUSERSPROFILE% is system-drive\ProgramData.

A folder protected by the system is the path to a folder in any of the following:

- system-drive\Windows

- system-drive\Program Files

- system-drive\Program Files (x86) (for 64-bit Windows)
For Windows Server 2012 or Windows Server 2008 in which an installation folder other than the above is used:

JP1/AJS3-Manager-installation-folder\log\ajs-host-log2.log
For Windows Server 2003:

JP1/AJS3-Manager-installation-folder\log\ajs-host-log2.log
In UNIX:

/var/opt/jp1ajs2/log/ajs-host-log2.log

Recommended value

For a physical host:

Default value
For a logical host:

The value set at the time of setup.

When the setting takes effect

The next time the JP1/AJS3 service starts

To Page Top

(12) "HOSTLOGOUTPUTYEAR" = "{yes|no}"

Use this parameter to specify whether to output the year as part of the date of a host's scheduler log. The scheduler log is specified when you specify the HOSTLOGFILE1 and HOSTLOGFILE2 environment setting parameters.

Change the parameter value if you use the year to manage scheduler log information.

Specifiable values

yes: The year is output. The system outputs the year, month, and day in the date section.
no: The year is not output. The system outputs only the month and day in the date section.

Default value

no

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts

To Page Top

(13) "HOSTLOGHEADER" = "{none|PID}"

Use this parameter value to specify whether to output the history information with the process ID added in a host's scheduler log file.

Change the parameter value to output history information without adding process ID information.

Specifiable values

none: A process ID is not added to the history information to be output.
PID: A process ID is added to the history information to be output.

Default value

none

During a new installation of JP1/AJS3 or upgrade installation from version 8 or earlier, and during setup of cluster operation, PID is set.

Recommended value

PID

When the setting takes effect

The next time the JP1/AJS3 service starts

To Page Top

(14) "HLOGDLOG" = "{none|all}"

Use this parameter value to specify whether to output the start and stop messages related to the scheduler-log output process (ajshlogd.exe in Windows, or ajshlogd in UNIX) to the scheduler log for hosts.

Specifiable values

none: Does not output messages related to starting and stopping the scheduler-log output process for hosts.
all: Outputs messages KAVS0220-I and KAVS0221-I, which are the messages related to starting and stopping the scheduler-log output process for hosts.

Default value

none

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts or stops

To Page Top

(15) "HLOGDSYSLOG" = "{none|all}"

In Windows:

Use this parameter value to specify whether to output the start and stop messages related to the scheduler-log output process ajshlogd.exe to the Windows event log and the integrated trace log for hosts.

In UNIX:

Use this parameter value to specify whether to output the start and stop messages related to the scheduler-log output process ajshlogd to the syslog and the integrated trace log for hosts.

Specifiable values

none: Does not output messages related to starting and stopping the scheduler-log output process for hosts.
all: Outputs messages KAVS0220-I and KAVS0221-I, which are the messages related to starting and stopping the scheduler-log output process for hosts.

Default value

none

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts or stops

To Page Top

(16) "LOGSIZE" = dword:size-of-the-system-management-log

Use this parameter to specify the size of the system management log.

For details about the log files, see 1.2.4 List of log files and directories in the manual Job Management Partner 1/Automatic Job Management System 3 Troubleshooting.

Specifiable values: A hexadecimal value (in bytes) from 1000 to 7FFFFFFF (4,096 to 2,147,483,647 in decimal)
Default value: dword:1F400 (128,000 in decimal)
Recommended value: Default value
When the setting takes effect: The next time the JP1/AJS3 service starts
Cautionary note: If the value specified for the log file size and the number of log files are too small, you might not be able to identify the cause of an error. When you change the log file size, do not specify a log file size smaller than the default value.

To Page Top

(17) "LOGFILENUM" = dword:Number-of-system-management-log-files

Use this parameter to specify the number of system management log files.

For details about the log files, see 1.2.4 List of log files and directories in the manual Job Management Partner 1/Automatic Job Management System 3 Troubleshooting.

Specifiable values: A hexadecimal value from 1 to 10 (1 to 16 in decimal)
Default value: dword:00000003 (3 in decimal)
Recommended value: Default value
When the setting takes effect: The next time the JP1/AJS3 service starts
Cautionary note: If the value specified for the log file size and the number of log files are too small, you might not be able to identify the cause of an error. When you change the number of log files, do not specify a value smaller than the default value.

To Page Top