Managing jobs in progress

The Tasks in Progress view lets you see and manage jobs that are currently executing irrespective of the fact whether they were executed manually or automatically. All jobs execute in the background. While they are executing, you can use the Tasks in Progress view to view, obtain information about, and cancel or abort jobs. If a job fails, the Tasks in Progress view shows the failed job until you delete it. Double-clicking on the job shows any error messages.

Information in the Task in Progress view

The Tasks in Progress view provides various information about the jobs that are executing in the background. The following table presents the information provided in the Tasks in Progress view for each task in progress.

Column	Description
Progress	Progress bar shows how much of the job or task has executed.
Activity	Status of the job or task. This column provides values such as Running, Cancel Pending, Completed Successfully, Completed With Errors, and Completed With Warnings.
Start Time	Time when the job began.
Name	Name of the job that is executing.
Type	Type of job.
User	User who executed the job.
Role	Name of the role of the user who executed the job.
Priority	Job execution priority level (available priority levels are Critical, High, Normal, Low, and Lowest).
MAC Address	(Provision Job only) Media Access Control address (MAC address) is a unique identifier assigned to most network adapters or network interface cards by the manufacturer.
Waiting for approval	When you submit a job that requires BMC Remedy ITSM approval, the job is blocked until approval notification is received from BMC Remedy ITSM. The job displays a status of Waiting for Approval. Additional statuses are possible if TrueSight Server Automation is configured to integrate with BMC Remedy ITSM.
Host Name	(Provision Job only) Name of the host on which the job is executing.
Device Type	(Provision Job only) The provisioning technology being used to provision the server — PXE, JumpStart, or NIM.
Device Description	(Provision Job only) Description of the device being provisioned.

To refresh the Task in Progress view

The Tasks in Progress view is automatically refreshed after the interval defined in the Job Polling Interval parameter. The Auto Refresh option displays the interval.

You can manually refresh the view by using the Refresh icon .

Important

Starting from version 22.2, the option to manually refresh () is disabled until the previous manual refresh action completes.

To cancel or abort jobs in progress

To cancel any job, a role must be granted both Read and Cancel permissions for that type of job. For example, to cancel a Deploy Job, your role must be granted DeployJob.Cancel and DeployJob.Read.

Select one or more jobs listed in the Tasks in Progress view. Use Shift-click or Control-click to select multiple tasks.

If you cancel a virtual machine deployment job, the job fails, however, the virtual machines are deployed to the targets. This behavior is expected.

Do the following:

Click Cancel .
In the displayed message, click either Cancel after tasks finish or End tasks now. The Cancel after tasks finish option sends out requests to cancel tasks and allows time for threads to shut down. The End tasks now option triggers a more forceful and immediate termination of tasks.

Note

When you try to abort a compliance job by clicking End tasks now, the results are not saved. But when you select a long-running compliance job and click Cancel after tasks finish, the results of the finished components are saved and the remaining job execution is aborted.

For a Batch job, the Cancel option waits for child jobs to be cancelled and only then cancels the parent job, while the Abort option terminates the parent job first and then also terminates the child jobs. When you cancel or abort an executing Workflow Job, a request to cancel the associated workflow process is sent to TrueSight Orchestration, and process termination messages (with a status of either CANCELLED or COMPENSATED) are returned to the Workflow Job run log. A child job cannot be cancelled if it has already started executing.

To pause and resume jobs in progress

You can pause a running job, or group of jobs, to enable resources to be used by more critical jobs, or to modify the runtime execution priority of a job.

For example, consider the following scenario. The default priority for Deploy Jobs in your environment is Normal, yet you have a Deploy Job which needs to be executing immediately. There are a lot of other jobs running at this time, so to ensure that your Deploy Job is executed as efficiently and quickly as possible, you do the following:

Pause the other non-critical jobs
Pause your Deploy Job and change the runtime priority to HIGH
Resume your Deploy Job
Resume the other jobs after your job has completed

Note

To pause and resume any job, a role must be granted both Read and PauseResumeExecution permissions for that type of job. For example, to pause and resume a Deploy Job, your role must be granted DeployJob.PauseResumeExecution and DeployJob.Read.

To pause and resume a job in progress, complete the following steps:

Select one or more jobs listed in the Tasks in Progress view. Use Shift-click or Control-click to select multiple tasks.
Click Pause .
If desirable, click Modify Runtime Priority to change the execution priority for the job.
When ready, click Resume Execution to resume the job.

To enable caching for the Task in Progress view

You can get the details of the currently executing jobs from a cache instead of fetching them in real time from the database. Caching improves performance in large environments as it reduces the number of queries executed on the database to update details of executing jobs in the Tasks in Progress view.

When caching is enabled, the Application Server maintains a cache of the currently executing tasks. It returns the data from the cache whenever the TrueSight Server Automation Console requests for it, for both automatic as well as manual refresh of the Task In Progress view. The Application Server cache is refreshed after a predefined interval of 10 seconds or if a job is cancelled, paused or the priority of the job changes.

When caching is disabled (default), for each refresh from the Tasks in Progress view, the Application Server fetches the required data from the database.

To enable caching, complete the following steps:

Start the Application Server Administration console, as described in Starting-the-Application-Server-Administration-console.
Execute below set command:
set AppServer EnableTaskInProgressCache true
Restart the Application Servers (any Application Server instance which has config deployment) for the changes to take effect.

To disable caching, complete the following steps:

Start the Application Server Administration console, as described in Starting-the-Application-Server-Administration-console.
Execute below set command:
set AppServer EnableTaskInProgressCache false
Restart the Application Servers (any Application Server instance which has config deployment) for the changes to take effect.

To close the Tasks in Progress view

Choose Close on the tab or right-click the Task in Progress view tab and choose Close . If a job begins when the Tasks in Progress view is hidden, a dialog informs you that the job has started running in the background.