20.15.2 Details of the environment setting parameters for Management Portal execution environment
This subsection describes details of the environment setting parameters for management portal execution environment.
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) AUTHSYSLOG
- In Windows:
-
This parameter sets whether to output messages regarding user authentication to the Windows event log and the integrated trace log.
- In Linux:
-
This parameter sets whether to output messages regarding user authentication to the syslog and the integrated trace log.
- Format
-
"AUTHSYSLOG"="{none|all}"
- Specifiable values
-
- none
-
Messages related to user authentication are not output.
- all
-
Messages related to user authentication are output.
In Windows, if authentication is denied for the ajssysctlmd or ajssysctlad process, the KAVS1009-W message is output to the event log and the integrated trace log. In UNIX, that message is output to the syslog and the integrated trace log.
- Default value
-
none
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
Immediately (the next time a user authentication request is received)
(2) SYSLOGCODE
Use this parameter to specify the language type of the messages that are output by the JP1/AJS3 System Control Manager service and JP1/AJS3 System Control Agent service to the syslog file.
- Format
-
"SYSLOGCODE"="{C|en_US.UTF-8|en_US.utf8|LANG-environment-variable-value}"
- Specifiable values (when the language type of JP1/AJS3 is Japanese or English)
-
- C, en_US.UTF-8, or en_US.utf8
-
The messages are output encoded with the English ASCII character set.
- LANG-environment-variable-value (character string other than C)
-
Operation depends on the settings of the LANG environment variable at the time the JP1/AJS3 System Control Manager service and JP1/AJS3 System Control Agent service starts. However, in some systems, a message in the language type corresponding to the LANG environment variable at the time the JP1/AJS3 System Control Manager service and JP1/AJS3 System Control Agent service starts might not be output to syslog. In such a system, make sure that this parameter is set to C. Check whether Japanese can be output in the system you are using by executing the logger command to output a message in Japanese and then confirming that the message is correctly output to syslog.
The LANG environment variable value differs depending on the OS.
The following table describes the values that can be specified for the LANG environment variable.
- Specifiable values (when the language type of JP1/AJS3 is Chinese)
-
- C
-
The messages are output encoded with the English ASCII character set.
- Default value
-
C
- Recommended value
-
Default value
- When the setting takes effect
-
After restarting the JP1/AJS3 System Control Manager service and JP1/AJS3 System Control Agent service
(3) CONRESTRICTSYSLOG
- In Windows:
-
This parameter sets whether to output messages regarding connection source restrictions to the Windows event log.
- In UNIX:
-
This parameter sets whether to output messages regarding connection source restrictions to the syslog.
- Format
-
"CONRESTRICTSYSLOG"="{none|all}"
- Specifiable values
-
- none
-
Does not output messages regarding connection source restrictions.
- all
-
Outputs messages regarding connection source restrictions.
In Windows, if connection is denied by the connection source restriction function for the ajssysctlmd or ajssysctlad process, the KAVS8040-E message is output to the event log. In UNIX, that message is output to the syslog.
- Default value
-
none
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
After restarting the JP1/AJS3 System Control Manager service
(4) AJSSYSCTLDLOGSIZE (for manager process)
Use this parameter to specify the size of the ajssysctlmd internal log file.
- Format
-
"AJSSYSCTLDLOGSIZE"=dword:size-of-ajssysctlmd-internal-log-file
- Specifiable values
-
00000000 or a value in kilobytes from 00000004 to 001E8480 in hexadecimal (in decimal 0 or a value from 4 to 2,000,000)
If you specify dword:00000000, the system does not create a log file.
- Default value
-
dword:00001000 (4,096 in decimal)
- Recommended value
-
Default value
- When the setting takes effect
-
After restarting the JP1/AJS3 System Control Manager service
(5) LOGSIZE (for manager process)
Use this parameter to specify the size of the ajssysctlmd log file.
- Format
-
"LOGSIZE"=dword:size-of-ajssysctlmd-log-file
- Specifiable values
-
00000000 or a value in kilobytes from 00000004 to 001E8480 in hexadecimal (in decimal 0 or a value from 4 to 2,000,000)
If you specify dword:00000000, the system does not create a log file.
- Default value
-
dword:00002800 (10,240 in decimal)
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
After restarting the JP1/AJS3 System Control Manager service
(6) MAXOPEEXEC (for manager process)
Use this parameter to specify the maximum number of on-screen operations that can be performed concurrently for the manager host from the management portal for JP1/AJS3 - Web Console. Change this if operations are concentrated from multiple Web Console servers to a specific manager host and the message "KNAK3290-E The number of operation requests from the management portal to the connection-destination manager has exceeded the maximum number of operations that can be concurrently run." is displayed frequently.
The value specified for this parameter is the maximum value for the total number of operations on all physical and logical hosts that exist on the same machine. If the number of concurrent on-screen operations exceeds this value, attempts to perform more on-screen operations fail.
- Format
-
"MAXOPEEXEC"=dword:maximum-number-of-operations-that-can-be-performed-concurrently
- Specifiable values
-
A hexadecimal value from 0 to 64 (0 to 100 in decimal)
- Default value
-
dword:00000005 (5 in decimal)
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
After restarting the JP1/AJS3 System Control Manager service
(7) MAXAGGEXEC
Use this parameter to specify the maximum number of threads that can run concurrently to perform aggregation on the manager host.
Aggregation is performed for each scheduler service on the manager host if aggregation is started from the Usage Status of the Scheduler Service or Details on the Retention Status of Jobnets with Start Conditions dialog box of the Web GUI (Management Portal).
While multiple scheduler services are concurrently performing aggregation, if the KAVS8521-E message, which reports a failure in starting aggregation because the maximum number of concurrent threads is exceeded, is displayed frequently, you must increase the value of this parameter.
- Format
-
"MAXAGGEXEC"=dword:maximum-number-of-threads-to-perform-aggregation-concurrently
- Specifiable values
-
A hexadecimal value from 1 to 14 (1 to 20 in decimal)
- Default value
-
dword:00000005 (5 in decimal)
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
After restarting the JP1/AJS3 System Control Manager service
- Cautionary note
-
The value specified for this parameter is used as the maximum number of threads that are used to perform aggregation by the scheduler services on all physical and logical hosts on the same machine.
(8) JOBAGGTIMEOUT
Use this parameter to specify the time for which the system waits before starting aggregation of the number of job executions.
Aggregation of the number of job executions can be performed for only one scheduler service on one machine. Therefore, while the aggregation process for a scheduler service is in progress, if the aggregation process for another scheduler service occurs, the latter process waits for the current aggregation to end.
If an aggregation process is not performed, the KAVS8604-E message is output to the job execution count aggregation log. If this message is output, increase the value of this parameter or change the value of the PERIODICJOBAGG environment setting parameter so that multiple aggregation processes do not occur concurrently.
- Format
-
"JOBAGGTIMEOUT"=dword:timeout-of-a-wait-for-the-number-of-job-executions-to-be-aggregated
- Specifiable values
-
A hexadecimal value (in minutes) from 1 to 564 (1 to 1,380 in decimal)
- Default value
-
dword:0000003C (60 in decimal)
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
Immediately (the next time aggregation is started)
(9) AJSSYSCTLDLOGSIZE (for agent process)
Use this parameter to specify the size of the ajssysctlad internal log file.
- Format
-
"AJSSYSCTLDLOGSIZE"=dword:size-of-ajssysctlad-internal-log-file
- Specifiable values
-
00000000 or a value in kilobytes from 00000004 to 001E8480 in hexadecimal (in decimal 0 or a value from 4 to 2,000,000)
If you specify dword:00000000, the system does not create a log file.
- Default value
-
dword:00001000 (4,096 in decimal)
- Recommended value
-
Default value
- When the setting takes effect
-
After restarting the JP1/AJS3 System Control Agent service
(10) LOGSIZE (for agent process)
Use this parameter to specify the size of the ajssysctlad log file.
- Format
-
"LOGSIZE"=dword:size-of-ajssysctlad-log-file
- Specifiable values
-
00000000 or a value in kilobytes from 00000004 to 001E8480 in hexadecimal (in decimal 0 or a value from 4 to 2,000,000)
If you specify dword:00000000, the system does not create a log file.
- Default value
-
dword:00002800 (10,240 in decimal)
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
After restarting the JP1/AJS3 System Control Agent service
(11) MAXOPEEXEC (for agent process)
Use this parameter to specify the maximum number of on-screen operations that can be performed concurrently for the agent host from the management portal for JP1/AJS3 - Web Console. Change this if operations are concentrated from multiple Web Console servers to a specific agent host and the message "KAVS8510-E The operation cannot be executed, because the maximum number of concurrent operations has been exceeded. maintenance-information" is displayed frequently.
The value specified for this parameter is the maximum value for the total number of operations on all physical and logical hosts that exist on the same machine. If the number of concurrent on-screen operations exceeds this value, attempts to perform more on-screen operations fail.
- Format
-
"MAXOPEEXEC"=dword:maximum-number-of-operations-that-can-be-performed-concurrently
- Specifiable values
-
A hexadecimal value from 0 to 64 (0 to 100 in decimal)
- Default value
-
dword:00000005 (5 in decimal)
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
After restarting the JP1/AJS3 System Control Agent service
(12) PERIODICJOBAGG
Use this parameter to specify whether the number of jobs executed by scheduler services is to be automatically aggregated every day.
Set yes for this parameter if you want to check the number of jobs executed by scheduler services in the Number of job executions or Number of job executions in a day dialog box of the Web GUI (Management Portal).
- Format
-
"PERIODICJOBAGG"="{yes|no}"
- Specifiable values
-
- yes
-
Aggregation is automatically performed every day.
- no
-
Aggregation is not performed.
- Default value
-
no
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
After restarting the JP1/AJS3 System Control Manager service
(13) JOBAGGSTARTTIME
Use this parameter to specify the aggregation start time if the number of jobs executed by scheduler services is aggregated automatically every day.
This parameter must be set if yes is set for the PERIODICJOBAGG environment setting parameter.
- Format
-
"JOBAGGSTARTTIME"=the-time-at-which-aggregation-of-the-number-of-job-executions-starts
- Specifiable values
-
A 5-byte character string from 00:00 to 23:59.
Specify the time at which aggregation of the number of job executions starts 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
-
After restarting the JP1/AJS3 System Control Manager service
- Cautionary note
-
The setting of this parameter is ignored if no is specified for the PERIODICJOBAGG environment setting parameter.
(14) JOBAGGLOGDIR
Use this parameter to specify the directory for containing job execution count aggregation log files.
If the scheduler service automatically counts the number of executed jobs every day, you can check the job execution history in the job execution count aggregation log files.
This parameter must be set if yes is set for the PERIODICJOBAGG environment setting parameter.
- Format
-
"JOBAGGLOGDIR"="the-name-of-the-directory-for-containing-job-execution-count-aggregation-log-files"
- Specifiable values
-
A character string of no more than 233 bytes
Do not use a semicolon (;) 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\schedule\scheduler-service-name
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\schedule\scheduler-service-name
-
In UNIX:
/var/opt/jp1ajs2/log/schedule/scheduler-service-name
-
- Recommended value
-
Default value
- When the setting takes effect
-
After restarting the JP1/AJS3 System Control Manager service
- Cautionary note
-
The setting of this parameter is ignored if no is specified for the PERIODICJOBAGG environment setting parameter.
(15) JOBAGGRESULTSSTOREDAYPERIOD
Use this parameter to specify the number of days for which to store the aggregation results of the number of jobs executed by scheduler services. This parameter must be set if yes is set for the PERIODICJOBAGG environment setting parameter.
- Format
-
"JOBAGGRESULTSSTOREDAYPERIOD"=dword:the-number-of-days-for-which-the-aggregation-results-of-the-number-of-job-executions-are-stored
- Specifiable values
-
A hexadecimal value from 1E to 16D (30 to 365 in decimal)
- Default value
-
dword:0000001E (30 in decimal)
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
Immediately (the next time aggregation is started)
- Cautionary note
-
If you set a smaller value for this parameter, the aggregation results for the differential days will be lost.
(16) JOBAGGJP1USERNAME
Use this parameter to specify the name of the JP1 user who aggregates the number of job executions for a scheduler service.
This parameter must be set if yes is set for the PERIODICJOBAGG environment setting parameter.
- Format
-
"JOBAGGJP1USERNAME"="the-name-of-the-JP1-user-who-aggregates-the-number-of-job-executions"
- Specifiable values
-
A character string of no more than 31 bytes
- Default value
-
jp1admin
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
After restarting the JP1/AJS3 System Control Manager service
- Cautionary note
-
The setting of this parameter is ignored if no is specified for the PERIODICJOBAGG environment setting parameter.