Jobs system values: Maximum time for immediate end

Specifies the maximum amount of time for application cleanup during the immediate ending of a job. (QENDJOBLMT)

Maximum time for immediate end, also known as QENDJOBLMT, is a member of the jobs category of i5/OS™ system values. You can use this system value to specify the amount of time for application cleanup during the immediate ending of a job. To learn more, keep reading.

Quick reference
Location In iSeries™ Navigator, select your system, > Configuration and Service > System Values > Jobs > Cleanup
Special authority None
Default value 120
Changes take effect Immediately
Lockable No

What can I do with 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.

In order to allow enough time for both application cleanup and system end-of-job processing, you may need to adjust the Maximum time for immediate shutdown (QPWRDWNLMT) system value in the Restart category of system values. If you set this system value, Maximum time for immediate end, to a value greater than Maximum time for immediate shut down, a warning message will be 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).

Where can I get more information about this system value?

To learn more, go to the jobs system values overview topic. If you are looking for a specific system value or category of system values, try using the i5/OS system value finder.

Related concepts
System values: Jobs overview
Restart system values: Maximum time for immediate shutdown
Related information
System value finder