Jobs system values: Maximum time for immediate end
The Maximum time for immediate end system value is also known as QENDJOBLMT. You can use this system value to specify the amount of time for application cleanup during the immediate ending of a job.
| Quick reference | |
|---|---|
| Location | From IBM® Navigator for i, select . Right-click on Jobs and click Properties, then select the Cleanup tab. |
| Special authority | None. |
| Default value | 120. |
| Changes take effect | Immediately. |
| Lockable | No. |
What can I do with this system value?
This system value specifies the maximum amount of time (in seconds) for application cleanup during the immediate ending of a job. This is both a maximum cleanup time and a minimum amount of time needed to conclude that the signal handling procedure (SIGTERM) has encountered a problem. The signal handling procedure is set up by the application in the job and indicates how to process the incoming signals. Only jobs running applications that use signal handling procedures use this system value.
When a job being ended has a signal handling procedure for the asynchronous signal SIGTERM, the SIGTERM signal is generated for that job. When the signal handling procedure for the SIGTERM signal is given control, the procedure can take the appropriate actions to avoid undesirable results such as application data that has been partially updated. If the SIGTERM signal handler has not completed in the specified amount of time, the system ends the job.
If a job is ended in an immediate manner, the maximum time for the signal handler is specified by this system value. This system value's time limit is used when ending one job, when ending all the jobs in a subsystem, or when ending all jobs in all subsystems. After two minutes from the initial end request, the system operator can use the End Job (ENDJOB) command with OPTION(*IMMED) to override the QENDJOBLMT value and end individual jobs immediately. Only use this command if a job is unable to perform its cleanup due to lock or wait conditions.
To allow enough time for both application cleanup and system end-of-job processing, you might need to adjust the Maximum time for immediate shutdown (QPWRDWNLMT) system value in the Restart category of system values. If you set the Maximum time for immediate end system value to a value greater than the Maximum time for immediate shut down system value, a warning message is displayed. When a power down occurs, all jobs must end within the time frame specified by the Maximum time for immediate shut down system value in order for the power down to complete in a controlled manner.
Possible values are from 30 to 3600 seconds (1 hour).