Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Configuration Guide


15.2.16 Setting the timeout value for receiving notification from the job process that execution is ready

A job that uses a queue (PC job other than a queueless job, Unix job other than a queueless job, flexible job#, HTTP connection job, queue job running on JP1/AJS3, action job other than a queueless job, or custom job) is started as a job process from the job execution control agent process. When the job is started, the agent process uses pipe communication to wait for a notification from the job process that execution is ready. During the wait, if, for example, the CPU is busy or the job priority is low, the job process might not be able to send the notification to the agent process for a long time. Because the agent process changes the status of a job to Now running when it receives the notification from the job process, the job status might remain Now queuing if no notification is received. If you set a timeout for receiving the notification, you can detect this problem early from the following message output to the integrated log:

#:

For a flexible job, replace agent with relay agent.

KAVU3589-E A pipe timeout error occurred in a job execution process (timeout value(second): seconds)

The following describes how to set the timeout value for receiving notification from the job process that execution is ready.

Note that if you use the queueless job execution functionality, the procedure described below is not needed because the functionality does not use pipe communication.

Organization of this subsection

(1) Definition procedure

  1. Stop the JP1/AJS3 service.

    Execute the following commands to confirm that all processes have stopped:

    # /etc/opt/jp1ajs2/jajs_stop#1
    # /opt/jp1ajs2/bin/jajs_spmd_status
    #1:

    Confirm that automatic termination has been set.

  2. Execute the following command to set the environment setting parameter described in (2) below:

    jajs_config -k "definition-key" "parameter-name"=value
  3. Restart JP1/AJS3.

    The new settings are applied.

(2) Environment setting parameter

Table 15‒34: Environment setting parameter used to set the timeout value for receiving notification from the job process that execution is ready

Definition key

Environment setting parameter

Explanation

[{JP1_DEFAULT|logical-host}\JP1NBQAGENT\Job]#

"AfterForkPipeTimeout"=

Specifies the timeout value for receiving notification from the job process that execution is ready.

#:

The specification of the {JP1_DEFAULT|logical-host} part depends on whether the host is a physical host or a logical host. For a physical host, specify JP1_DEFAULT. For a logical host, specify the logical host name.

For details about the definition of this environment setting parameter, see 20.5.2(60) AfterForkPipeTimeout.