2.2 Troubleshooting problems related to the job execution environment
This section describes how to troubleshoot problems related to the job execution environment.
If an error has occurred on the existing agent host or if an agent host whose configuration definition can be changed is a remote host, take the following action:
Create an execution agent by using the ajsagtadd command. If you are using QUEUE jobs and submit jobs, use the jpqimport command to define the configuration of the execution environment for QUEUE jobs and submit jobs. Then use the jpqagtadd command or the jpqqueopen command to enable the new agent to be used.
If you specify 1 for the AutoCreate environment setting parameter at setup, an alternate execution agent or agent is automatically added when a job is submitted. You also can use the added alternate execution agent or agent to execute the job.
System administrators must specify the automatic definition of agents at setup to be ready for potential emergencies such as an agent host failure. If jobs are to be executed with the automatic definition of agents enabled, the user executing the jobs must be a JP1 user with JP1_JPQ_User permission and JP1_JPQ_Admin permission. Because an error could occur if any of the following conditions exists, make sure beforehand that they will not arise:
-
Memory becomes insufficient.
-
Disk space becomes insufficient.
-
Access to the database fails.
-
An existing queue is already using the same name.
-
The number of agents reaches the maximum number that has been defined.
-
A communication error that disables connection to the manager host occurs.
-
The event/action control manager process is no longer running.
-
Access permission for adding an execution agent or an agent has not been granted.
Use the following procedure to set the automatic definition of agents and to execute a job.
To set the automatic definition of agents:
-
Configure the AutoCreate environment setting parameter.
Specify the value for the AutoCreate environment setting parameter as follows:
"AutoCreate"=dword:1
If a failure occurs on the agent host, perform the following step:
-
Execute a job.
- For JP1/AJS3 - View (for Windows):
-
Specify the name of the agent host to be automatically defined in Exec-agent in the Define Details dialog box for the job, and register the job for execution.
- For the jpqjobsub command:
-
Specify the name of the agent host to be automatically defined in the -ah option and execute the command.
- Cautionary notes
-
-
An execution agent is added when a job is registered for execution. If the job fails, the execution agent will remain. If you want to delete the execution agent, use the ajsagtdel command.
-
An agent is added when a job is submitted. If the job fails, the agent will remain. If you want to delete the agent, use the jpqagtdel command.
-
If you want to enable the automatic definition of agents while JP1/AJS3 is running, you need to restart JP1/AJS3.
-
- Supplementary note
-
The setting values for an automatically added execution agent and the setting values for the default queue for an agent are the same as the default setting values specified at setup. The following table lists the default setting values.
Table 2‒1: Setting items and default values for an added execution agent Setting item for the execution agent
Default value
Execution host name
Same as the execution agent name
Maximum number of concurrently executable jobs
00:00-00:00=5 (maximum of five concurrent jobs, 24 hours a day)
Job transfer restriction status
Enabled
Explanation
None
Use the ajsagtalt command to change the setting values of execution agents. For details about this command, see ajsagtalt in 3. Commands Used for Normal Operations in the manual JP1/Automatic Job Management System 3 Command Reference.
Table 2‒2: Setting items and default values for an added agent and the default queue of the agent Setting item for the default queue
Default value
Period for changing the concurrently executable job limit and the value of the limit
00:00-00:00=5 (maximum of five concurrent jobs, 24 hours a day)
Maximum number of jobs
100
Warning level for the number of jobs
80
Status of the job entrance
open
Status of the job exit
open
Agent to be connected
Local agent host
Priority level of the agent
1
You can use the following commands to change the setting values for an added agent and the default queue of the agent:
-
jpqagtalt
-
jpqquealt
-
jpqqueopen
-
jpqqueclose
-
jpqagtlink
-
jpqagtunlink
For details about the commands, see 4. Commands Used for Special Operation in the manual JP1/Automatic Job Management System 3 Command Reference.
-