20.9.2 Details of the environment setting parameters for the flexible-job execution environment
This subsection describes details of the environment setting parameters for the flexible-job 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) FXJOB_MONITOR_TIMEOUT
Use this parameter to specify the timeout period to stop monitoring of the execution status of a flexible job. When the monitoring stops, the status of the flexible job changes to Ended abnormally.
If execution of a flexible job takes a long time, change the setting of this parameter as needed.
- Format
-
"FXJOB_MONITOR_TIMEOUT"=dword:timeout-period-to-stop-monitoring-of-flexible-job-execution-status
- Specifiable values
-
A hexadecimal value (in minutes) from 00000001 to 000005A0 (1 to 1,440 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 a Flexible job is executed)
- Supplementary note
-
When a relay agent is used to execute the flexible job, read the parameter setting in the relay agent. When no relay agent is used, read the parameter setting in the manager. In addition, when broadcast execution is used, read the parameter setting on the broadcast agent.
(2) FXJOB_START_TIMEOUT
Use this parameter to specify the timeout period to stop monitoring of the start of a flexible job. On the destination agent or the broadcast agent of the flexible job, if the start of the flexible job cannot be confirmed within the time specified here, the status monitoring stops, and the status of the flexible job changes to Ended abnormally.
- Format
-
"FXJOB_START_TIMEOUT" = dword:timeout-period-to-stop-monitoring-of-start-of-flexible-jobs
- Specifiable values
-
A hexadecimal value (in minutes) from 00000000 to 000005A0 (0 to 1,440 in decimal)
If 0 is specified, the start of the flexible job is not monitored.
- Default value
-
dword:00000002 (2 in decimal)
- Recommended value
-
Default value.
- When the setting takes effect
-
Immediately (the next time a Flexible job is executed)
- Supplementary note
-
When a relay agent is used to execute the flexible job, read the parameter setting in the relay agent. When no relay agent is used, read the parameter setting in the manager. In addition, when broadcast execution is used, read the parameter setting on the broadcast agent.
When the value of the environment setting parameter FXJOB_MONITOR_TIMEOUT is smaller than the value of this parameter, even if the time specified for this parameter has not been exceeded, the status of the flexible job becomes Ended abnormally when the time specified for FXJOB_MONITOR_TIMEOUT is exceeded.
The timing at which the status of flexible jobs becomes Ended abnormally depends on whether sync mode or async mode is used as the broadcast execution method.
-
If sync mode is used:
If the broadcast agent is unable to obtain confirmation that the execution of jobs has started from one or more destination agents within the amount of time specified for FXJOB_START_TIMEOUT, the statuses of flexible jobs change to Ended abnormally.
-
If async mode is used:
If the broadcast agent is unable to obtain confirmation that the execution of jobs has started from all destination agents within the amount of time specified for FXJOB_START_TIMEOUT, the statuses of flexible jobs change to Ended abnormally.
-
(3) FXREQ_LOGSIZE
Use this parameter to specify the size of the log file (ajsfxreq{1|2}.log) that is output from the source (relay agent or manager) of a flexible-job execution request.
- Format
-
"FXREQ_LOGSIZE"=dword:size-of-the-log-file-output-from-the-source-of-flexible-job-execution-request
- Specifiable values
-
A hexadecimal value (in kilobytes) from 00000000 to 001E8480 (0 to 2,000,000 in decimal)
Note that, if a value from 0 to 3 is specified, a log is not output.
- Default value
-
dword:00002800 (10,240 in decimal)
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
Immediately (the next time a flexible job is executed)
- Supplementary note
-
When a relay agent is used to execute the flexible job, read the parameter setting in the physical host of the relay agent. When no relay agent is used, read the parameter setting in the physical host of the manager.
(4) FXEXEC_LOGSIZE
Use this parameter to specify the size of the log file that is output from the target (destination agent) of a flexible-job execution.
- Format
-
"FXEXEC_LOGSIZE"=dword:size-of-the-log-file-output-from-the-target-of-flexible-job-execution
- Specifiable values
-
A hexadecimal value (in kilobytes) from 00000000 to 001E8480 (0 to 2,000,000 in decimal)
Note that, if a value from 0 to 3 is specified, a log is not output.
- Default value
-
dword:00002800 (10,240 in decimal)
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
Immediately (the next time a flexible job is executed)
- Supplementary note
-
Read the parameter setting in the destination agent.
(5) FXDSTR_LOGSIZE
Use this parameter to specify the size of the log file (ajsfxdstr{1|2}.log) output by the broadcast agent.
- Format
-
"FXDSTR_LOGSIZE" = dword:size-of-log-file-output-by-broadcast-agent
- Specifiable values
-
A hexadecimal value (in kilobytes) from 00000000 to 001E8480 (0 to 2,000,000 in decimal)
Note that, if a value from 0 to 3 is specified, a log is not output.
- Default value
-
dword:00005000 (20,480 in decimal)
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
Immediately (the next time a flexible job is executed by broadcast execution)
- Supplementary note
-
This parameter only takes effect on hosts that are set up as broadcast agents.
(6) FXBCCTL_LOGSIZE
Use this parameter to specify the size of the log file (ajsfxbcctl{1|2}.log) output by the broadcast agent and destination agents.
- Format
-
"FXBCCTL_LOGSIZE" = dword:size-of-log-file-output-by-broadcast-agent-and-destination-agents
- Specifiable values
-
A hexadecimal value (in kilobytes) from 00000000 to 001E8480 (0 to 2,000,000 in decimal)
Note that, if a value from 0 to 3 is specified, a log is not output.
- Default value
-
dword:00002800 (10,240 in decimal)
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
Immediately
- Supplementary note
-
This parameter takes effect only on hosts that are set up as broadcast agents or broadcast-execution destination agents.
(7) FXBC_MANAGEDAGT_REMOVEDTIME
Use this parameter to specify the time before the broadcast agent decides to remove a destination agent from management if the broadcast agent does not receive a heartbeat from the destination agent. If the broadcast agent decides to remove a destination agent, the destination agent is removed from management the next time a flexible job is executed by broadcast execution.
- Format
-
"FXBC_MANAGEDAGT_REMOVEDTIME" = dword:time-before-broadcast-agent-decides-to-remove-destination-agent-from-management
- Specifiable values
-
A hexadecimal value (in minutes) from 00000005 to 000005A0 (5 to1,440 in decimal)
- Default value
-
dword:0000003C (60 in decimal)
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
The next time the broadcast agent checks for a heartbeat
(8) FXBC_JP1EVSEND_AGENT_TRIGGER
Use this parameter to specify whether to issue a JP1 event each time a flexible job finishes on a broadcast-execution destination agent. If you want JP1 events to be issued, specify when a JP1 event is to be issued.
Note that this JP1 event is issued by the broadcast agent.
- Format
-
"FXBC_JP1EVSEND_AGENT_TRIGGER" = "JP1-event-generation-mode"
- Specifiable values
-
- none
-
A JP1 event is not issued.
- finished
-
A JP1 event is issued when a flexible job finishes on a broadcast-execution destination agent.
- on_warn_error
-
A JP1 event is issued when a flexible job ends with warning or ends abnormally on a broadcast-execution destination agent.
- on_error
-
A JP1 event is issued when a flexible job ends abnormally on a broadcast-execution destination agent.
- Default value
-
none
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
The next time a flexible job is executed by broadcast execution
(9) FXBC_JP1EVSEND_JOB_TRIGGER
Use this parameter to specify whether to issue a JP1 event when execution of a flexible job finishes on all broadcast-execution destination agents. If you want JP1 events to be issued, specify when a JP1 event is to be issued.
Note that this JP1 event is issued by the broadcast agent.
- Format
-
"FXBC_JP1EVSEND_JOB_TRIGGER" = "JP1-event-generation-mode"
- Specifiable values
-
- none
-
A JP1 event is not issued.
- finished
-
A JP1 event is issued when a flexible job finishes on all destination agents.
- on_warn_error
-
A JP1 event is issued when a flexible job that finishes on all destination agents ends with a warning, or ends abnormally on some or all of the destination agents.
- on_error
-
A JP1 event is issued when a flexible job that finishes on all destination agents ends abnormally on some or all of the destination agents.
- Default value
-
none
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
The next time a flexible job is executed by broadcast execution
(10) FXBC_DBDIR
Use this parameter to specify the directory that stores information about the broadcast-execution destination agents managed by the broadcast agent.
- Format
-
"FXBC_DBDIR" = "path-to-directory-to-store-information-about-broadcast-execution-destination-agents"
- Specifiable values
-
A character string of 200 or fewer bytes that is encoded in ASCII
- Default value
-
-
In Windows:
data-directory#\sys\fxbc
-
In UNIX:
/var/opt/jp1ajs2/sys/fxbc
- #:
-
The path to the data directory differs depending on the JP1/AJS3 installation folder.
If the installation folder is the default installation folder or is in a folder protected by the system
%ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2
If the installation folder is other than the above
JP1/AJS3-Manager-installation-folder
-
By default, JP1/AJS3 is installed in the following folder: system-drive\Program Files (x86)\HITACHI\jp1ajs2
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)
-
The default value for %ALLUSERSPROFILE% is system-drive\ProgramData.
-
-
- Recommended value
-
Set the value appropriate for the operating environment.
- When the setting takes effect
-
The next time the broadcast agent checks for a heartbeat or executes a flexible job by broadcast execution