20.11.2 Details of the environment setting parameters for JP1/AJS3 shared information
This subsection describes the environment setting parameters for JP1/AJS3 shared information.
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) LARGEFILEUSE
Use this parameter to specify whether the file monitoring job monitors large files.
For details, see 6.3.16 Enabling monitoring of a large file.
- Format
-
"LARGEFILEUSE" = "{yes|no}"
- Specifiable values
-
- yes
-
The file monitoring job monitors files larger than 2 GB.
- no
-
The file monitoring job cannot monitor files that are larger than 2 GB. If you specify no, but specify a file larger than 2 GB as a monitoring target, an error message is output to the integrated trace log when execution of the file monitoring job terminates abnormally. For this reason, do not specify a file larger than 2 GB as a monitoring target.
- Default value
-
no
If the OS is Windows, yes is set when a new installation of JP1/AJS3 is performed.
- Recommended value
-
yes
- When the setting takes effect
-
After JP1/AJS3 is restarted
- Cautionary note
-
If you are using version 11-10 or later of JP1/AJS3 for UNIX, you do not need to set this environment setting parameter.The system operates by assuming yes regardless of the actual value of this environment setting parameter setting.
(2) SYSLOGJOBMSG
Use this parameter to specify whether to also output error messages appearing during the execution of jobs to syslog.
For details, see 15.6.1 Settings for outputting error messages for jobs to syslog.
- Format
-
"SYSLOGJOBMSG" = "{none|error}"
- Specifiable values
-
- none
-
Error messages appearing during the execution of jobs are not output to syslog. The status of JP1/AJS3 is monitored by the integrated trace log.
- error
-
Error messages appearing during the execution of jobs are output to the syslog file, which is used to monitor the error status of JP1/AJS3. However. even if you specify this value, you must not stop the integrated trace log process.
If you specify error for this parameter, a message reporting abnormal job termination (KAVS0265-E) is output to syslog, regardless of whether the scheduler service setting contains JOBSYSLOG (outputs, to syslog, messages related to starting and ending a job).
The following table lists the messages that are output based on the values specified for the SYSLOGJOBMSG and JOBSYSLOG environment setting parameters.
- Legend:
-
--: Not applicable
- Default value
-
none
- Recommended value
-
Default value
- When the setting takes effect
-
After JP1/AJS3 is restarted
(3) MACROCHANGEFAIL
Use this parameter to specify whether to set Failed to start as the status if expansion of the passing information in a macro variable fails when a job is executed.
For details, see 6.2.10 Setting the action to be taken if the value of a macro variable cannot be passed (for Windows) or 15.2.10 Setting the action to be taken if the value of a macro variable cannot be passed (for UNIX).
- Format
-
"MACROCHANGEFAIL" = "{yes|no}"
- Specifiable values
-
- yes
-
If the expansion of the passing information in a macro variable fails when a job is executed, the status set is Failed to start, and an error message is output to the integrated trace log and as execution result details so that you can check the macro variable that could not be expanded.
- no
-
Even if the expansion of the passing information in a macro variable fails when a job is executed, the system treats the information defined in the macro variable as a character string and continues processing.
- Default value
-
no
- Recommended value
-
Default value
- When the setting takes effect
-
After JP1/AJS3 is restarted
(4) ADMACLIMIT
Use this parameter to set the operation permission for units for JP1 users mapped to OS users with administrator permissions or superuser permissions.
- Format
-
"ADMACLIMIT" = "{yes|no}"
- Specifiable values
-
- yes
-
Access is controlled according to the permission level set for a JP1 user irrespective of the OS user to whom the JP1 user is mapped.
- no
-
A JP1 user mapped to an OS user with administrator permissions or superuser permissions can perform all operations irrespective of the permission level.
- Default value
-
no
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
After JP1/AJS3 is restarted
(5) CONNECTIONRESTRICTION
Use this parameter to specify whether the connection source restriction function for restricting connection to JP1/AJS3 is to be enabled or disabled.
- Format
-
"CONNECTIONRESTRICTION" = "{none|manager|agent|all}"
- Specifiable values
-
- none
-
The setting in the manager connection permission configuration file and the setting in the agent connection permission configuration file are disabled.
- manager
-
The setting in the manager connection permission configuration file is enabled, and the setting in the agent connection permission configuration file is disabled.
This value cannot be specified in JP1/AJS3 - Agent.
- agent
-
In JP1/AJS3 - Manager, the setting in the agent connection permission configuration file is enabled, and the setting in the manager connection permission configuration file is disabled.
In JP1/AJS3 - Agent, the setting in the agent connection permission configuration file is enabled.
- all
-
In JP1/AJS3 - Manager, the setting in the manager connection permission configuration file and the setting in the agent connection permission configuration file are enabled.
In JP1/AJS3 - Agent, the setting in the agent connection permission configuration file is enabled.
- Default value
-
none
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
If both the JP1/AJS3 service and the JP1/AJS3 Queueless Agent service have stopped, when either service restarts
- Cautionary notes
-
-
Change this environment setting parameter if both the JP1/AJS3 service and the JP1/AJS3 Queueless Agent service have stopped, and then, after making the change, start the services.
If you changed this environment setting parameter while either the JP1/AJS3 service or the JP1/AJS3 Queueless Agent service was running, stop both services and then start them.
-
If you specify a value other than none for this environment setting parameter, and the environment settings file storage folder does not contain the connection permission configuration file corresponding to the specified value, or the connection permission configuration file cannot be read, the JP1/AJS3 service or the JP1/AJS3 Queueless Agent service terminates abnormally.
-
(6) AJS3SSL
Use this parameter to specify the range of the encryption of communications by JP1/AJS3.
- Format
-
"AJS3SSL"="{ALL|INETD}"
- Specifiable values
-
- ALL
-
All communications performed by JP1/AJS3 are encrypted.
- INETD
-
Only the following communications performed by JP1/AJS3 are encrypted:
-
Communication between JP1/AJS3 - View and JP1/AJS3 - Manager
-
Communication between JP1/AJS3 - Web Console and JP1/AJS3 - Manager
-
Communication between JP1/AJS3 - Definition Assistant and JP1/AJS3 - Manager
-
Communications for remote execution of commands
-
- Default value
-
ALL
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
After JP1/AJS3 is restarted
(7) AJSI18N
Use this parameter to specify whether to use Chinese in JP1/AJS3.
- Format
-
"AJSI18N"="{yes|no}"
- Specifiable values
-
- yes
-
Chinese is to be used.
- no
-
Chinese is not to be used.
- Default value
-
no
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
After JP1/AJS3 is restarted
(8) LOGIPV6INFOALL
Use this parameter to specify whether to add IPv6 addresses to the messages output to logs such as the integrated trace log, event log, and syslog and to messages detailing execution results.
The IPv6 addresses are added to the messages shown below. For details about messages, see the manual JP1/Automatic Job Management System 3 Messages.
KAVT0009-E, KAVT0145-E, KAVT0268-W, KAVT0293-W, KAVT0559-E, KAVT0606-W, KAVT0612-W, KAVT0613-W, KAVT8343-W
- Format
-
"LOGIPV6INFOALL" = "{yes|no}"
- Specifiable values
-
- yes
-
IPv6 addresses are added to the messages.
- no
-
IPv6 addresses are not added to the messages.
- Default value
-
no
- Recommended value
-
Default value
- When the setting takes effect
-
After JP1/AJS3 is restarted