20.3.2 Details of the environment setting parameters for the system management
This subsection describes details of the environment setting parameters for system management.
Note that the default of an environment setting parameter means the value that is assumed when the environment setting parameter is omitted.
- Organization of this subsection
-
(1) SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT
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.
- Format
-
"SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT" = dword:Whether-to-issue-a-JP1-event-when-a-process-terminates-abnormally-or-times-out-at-startup
- 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
(2) SEND_PROCESS_RESTART_EVENT
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.
- Format
-
"SEND_PROCESS_RESTART_EVENT" = dword:whether-to-issue-a-JP1-event-when-a-process-is-restarted
- 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
(3) SEND_SYSTEM_STARTSTOP_EVENT
Use this parameter to specify whether to issue a JP1 event when the JP1/AJS3 service starts or stops.
- Format
-
"SEND_SYSTEM_STARTSTOP_EVENT" = dword: whether-to-issue-a-JP1-event-when-JP1/AJS3-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
(4) SEND_SYSTEM_CHILD_STARTSTOP_EVENT
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 JP1/Automatic Job Management System 3 Troubleshooting or B.3 Processes (for UNIX) in the manual JP1/Automatic Job Management System 3 Troubleshooting.
- Format
-
"SEND_SYSTEM_CHILD_STARTSTOP_EVENT" = dword: whether-to-issue-a-JP1-event-when-a-process-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
(5) SEND_SYSTEM_TERMINATED_ABNORMALLY_EVENT
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 JP1/Automatic Job Management System 3 Troubleshooting or B.3 Processes (for UNIX) in the manual JP1/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.
- Format
-
"SEND_SYSTEM_TERMINATED_ABNORMALLY_EVENT" = dword:Whether-to-issue-a-JP1-event-when-a-process-terminates-abnormally-or-times-out-at-startup
- 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
(6) SEND_SYSTEM_RESTART_EVENT
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.
- Format
-
"SEND_SYSTEM_RESTART_EVENT" = dword:Whether-to-issue-a-JP1-event-when-a-process-is-restarted
- 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
(7) AJSSYSDIR (for system management)
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).
- Format
-
"AJSSYSDIR" = "name-of-system-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
-
-
In Windows, if the installation folder is the default installation folder or is in 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)
-
In Windows, if the installation folder is other than the above:
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.
-
(8) AJSLOGDIR (for system management)
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.
- Format
-
"AJSLOGDIR" = "directory-name-for-log"
- 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
-
-
In Windows, if the installation folder is the default installation folder or is in 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)
-
In Windows, if the installation folder is other than the above:
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.
-
(9) HOSTLOGSIZE
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 JP1/Automatic Job Management System 3 System Design (Configuration) Guide.
- Format
-
"HOSTLOGSIZE" = dword:size-of-scheduler-log-file-for-a-host
- 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
(10) HOSTLOGFILE1
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.
- Format
-
"HOSTLOGFILE1" = "name-of-scheduler-log-file-1-for-a-host"
- Specifiable values
-
A character string of no more than 255 bytes
- Default value
-
-
In Windows, if the installation folder is the default installation folder or is in 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)
-
In Windows, if the installation folder is other than the above:
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
(11) HOSTLOGFILE2
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.
- Format
-
"HOSTLOGFILE2" = "name-of-scheduler-log-file-2-for-a-host"
- Specifiable values
-
A character string of no more than 255 bytes
- Default value
-
-
In Windows, if the installation folder is the default installation folder or is in 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)
-
In Windows, if the installation folder is other than the above:
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
(12) HOSTLOGOUTPUTYEAR
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.
- Format
-
"HOSTLOGOUTPUTYEAR" = "{yes|no}"
- 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
(13) HOSTLOGHEADER
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.
- Format
-
"HOSTLOGHEADER" = "{none|PID}"
- 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
(14) HLOGDLOG
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.
- Format
-
"HLOGDLOG" = "{none|all}"
- 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
(15) HLOGDSYSLOG
- 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.
- Format
-
"HLOGDSYSLOG" = "{none|all}"
- 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
(16) AGENTLIMITEXTEND
Use this parameter to specify whether to increase the maximum number of execution agents that can be registered in a manager host.
For details, see 6.2.28 Setting to increase the maximum number of execution agents that can be registered in a manager host (for Windows) or 15.2.25 Setting to increase the maximum number of execution agents that can be registered in a manager host (for UNIX).
- Format
-
"AGENTLIMITEXTEND"=dword:whether-to-increase-the-number-of-execution-agents-that-can-be-registered-in-a-manager-host
- Specifiable values
-
- dword:00000001
-
The maximum number of execution agents that can be registered in a manager host is set to 1,024.
- dword:00000002
-
The maximum number of execution agents that can be registered in a manager host is set to 2,048.
- Default value
-
dword:00000001
During a new installation of JP1/AJS3, dword:00000002 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
- Cautionary note
-
If you cancel the increase of the maximum number of execution agents later, you will have to re-create the embedded database. Therefore, give due consideration before changing the setting of the maximum number.
(17) DBAUTOMAINTENANCE
Use this parameter to specify whether to use the automatic maintenance function for embedded databases.
- Format
-
"DBAUTOMAINTENANCE" = "{yes|no}"
- Specifiable values
-
- yes
-
The automatic maintenance function for embedded databases is used.
- no
-
The automatic maintenance function for embedded databases is not used.
- Default value
-
no
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
Immediately
- Cautionary notes
-
-
In the case of maintenance of an embedded database by using the automatic maintenance function, make sure that maintenance is not performed by using any other methods.
-
If you want to temporarily stop the automatic maintenance of an embedded database because, for example, a failure occurred, specify no for this environment setting parameter. If you want to resume automatic maintenance after it was temporarily stopped, specify yes for this environment setting parameter.
-
(18) DBAUTOMAINTENANCETIME
Use this parameter to specify the automatic maintenance time for an embedded database. This environment setting parameter is based on the system time.
- Format
-
"DBAUTOMAINTENANCETIME" = "Automatic maintenance time for an embedded database"
- Specifiable values
-
A 5-byte character string from 00:00 to 23:59.
Specify the start time of automatic maintenance of the embedded database in hh:mm format.
For hh, specify the hour as a number in the range from 00 to 23. For example, specify 01 for 1 o'clock.
For mm, specify the minute as a number in the range from 00 to 59. For example, specify 01 for 1 minute past the hour.
- Default value
-
00:00
- Recommended value
-
A time when the execution of jobs and jobnets does not put a heavy load on the system and when commands and JP1/AJS3 - View are not operating on any units
- When the setting takes effect
-
Immediately
- Cautionary notes
-
If the automatic maintenance of the embedded database starts at any of the following times, a timeout error might result:
-
When the execution of jobs and jobnets creates a heavy load on the system
-
When a command or JP1/AJS3 - View is operating on a unit
If a timeout error occurs, specify the time when the execution of jobs and jobnets does not put a heavy load on the system and when commands and JP1/AJS3 - View are not operating on any units.
-
(19) LOGSIZE (system management log)
Use this parameter to specify the size of the system management log.
For details about the log files, see 1.2.5 List of log files and directories in the manual JP1/Automatic Job Management System 3 Troubleshooting.
- Format
-
"LOGSIZE" = dword:size-of-the-system-management-log
- 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.
(20) LOGFILENUM
Use this parameter to specify the number of system management log files.
For details about the log files, see 1.2.5 List of log files and directories in the manual JP1/Automatic Job Management System 3 Troubleshooting.
- Format
-
"LOGFILENUM" = dword:number-of-system-management-log-files
- 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.
(21) CONTAINER_HOST
Use this parameter to set whether the host on which JP1/AJS3 operates is a container host machine.
- Format
-
"CONTAINER_HOST"="{yes|no}"
- Specifiable values
-
- yes
-
Set this value if the host on which JP1/AJS3 operates is a container host machine.
- no
-
Set this value if the host on which JP1/AJS3 operates is not a container host machine.
- Default value
-
no
- Recommended value
-
To install JP1/AJS3 both on a container host machine and in containers, set this environment setting parameter to yes on the container host machine.
- When the setting takes effect
-
Immediately
- Cautionary notes
-
-
Do not set this environment setting parameter to yes on a machine that is not a container host machine.
-
When you set this environment setting parameter, make sure that the following services are stopped:
- JP1/AJS3 Check Agent service
- JP1/AJS3 Autonomous Agent service
-