Task Manager

From Documentation
Jump to: navigation, search

Task Manager is a part of the software and servers almost the same purpose as a well-known Windows Task Manager in Microsoft Windows, and it also has some extra useful features. Task Manager is needed because the software supports multhi-threading, meaning that it is able to run multiple tasks at the same time. You can find more information on multi-threading in this article.

Here is a summary of what our Task Manager is capable of:

  • Shows tasks that are currently running
  • Shows what exactly each task is doing at the moment
  • Shows when the task was started and how much time it has been running
  • Shows scheduled tasks and when they are to be started
  • Allows to access the history of finished tasks
  • Allows to see detailed log of actions for each task
  • Allows to stop tasks that are currently running
  • Allows to re-play Web-based tasks

Task groups

All tasks are arranged in thematic groups for convenience. Once you click on the Task Manager tab in the software, you will see a list of available task groups. It is possible to customize behavior of the tasks in certain group. If you right-click on any group and select "Properties", the following options will be available:

  • Set title of the group - you can customize that if you do not like the default name
  • Set number of threads allowed for this group. Please read this this article carefully before making changes here!
  • Set number of tasks to keep in history. When the task is finished, it is possible to keep it in the software database for some time, along with the associated resources (logs, web recordings, etc). It may be useful if you would like to go back to a certain task that has executed in the past and examine why it failed. By default, only the 10 latest tasks are kept in history for every task group. Whenever new task has finished execution, it is placed on top of the list, while the last item in the list gets removed, so the list always contains 10 tasks.
  • Set the policy towards unfinished tasks. It often happens that you exit the software while certain tasks are still running. It is possible to specify what exactly should be done do with such unfinished tasks when you start the software again. The options are:
    • Determine automatically - the software will attempt to select the best way to handle such tasks automatically.
    • Start when software starts - unfinished tasks will be started immediately after you start the software.
    • Suspend on software start - unfinished tasks will be made suspended, that is, you will be able to review them and either cancel or resume.

Task lifecycle

Each task can be in one of the following states at each given point in time:

  • Queued - the task has been placed on the execution queue and will be started as soon as possible. A flavor of this state is Waiting for a free thread, which means that there is a limit on the maximum allowed number of simultaneously running threads for the particular task group, and right now all threads are occupied.
  • Running - the task is running.
  • Finished - the task has finished execution, either successfully or with the error
  • Suspended - the task has not finished execution on the last run of the software, and is now pending your review. You can either cancel such task or resume it.
  • Cancelled - the task was cancelled by the user.
  • Scheduled - the task will be executed some time in the future, according to the schedule set for this task. This article explains scheduling in great detail.
  • Missed - the task was scheduled to be executed at the certain time, but for whatever reason it was not possible to run it at that time

To help you manage the tasks conveniently, we arranged them in 4 different tabs that you can see under the Task Manager tab in the software:

  • Running and Queued tab. This is where you see tasks that are either running right now, or are about to start shortly. The tasks with the states Queued, Waiting for a free thread, Running and Suspended are shown here.
  • Scheduled tab. This tab is only for the scheduled tasks. You can see the schedule for each task here and when is the next scheduled time for it to start. You can also manually force the task to start right now, by right-clicking the task and selecting Run now
  • Finished tab. This tab contains tasks that have been run in the past, with the status Finished. You can examine task logs here or re-play the task.
  • Cancelled and Missed tab. The tasks with the corresponding states are shown under this tab.

Bulk tasks

There is one more tab under the Task Manager - Bulk tasks.

Bulk task is a special type of task that acts upon multiple objects at the same time. The simplest example of the bulk task is E-mail forwarding. When you need to forward, let's say, 100 E-mail accounts to a single E-mail address, you can do so in just a few clicks by using Bulk tasks. Each bulk task has a list of items in it. In our example, the list would contain 100 E-mail accounts that need to be forwarded. Once bulk task is started, it creates many singular tasks (that you can see under the Running and Queued tab). For example, to forward 100 E-mail accounts, a bulk task will create 100 singular tasks, and each one will be working to forward corresponding E-mail account, in parallel with the other tasks.

You cannot create new tasks from the Bulk tasks tab, it only contains information about the existing ones. New bulk tasks are started from the corresponding wizards, available from the Main menu->Wizards.

It is also possible to re-start bulk tasks that have already finished. It may be useful if there were errors on the previous run, or you just want to quickly launch the task again, instead of setting it up through the wizards. To do this, right-click on the bulk task and select Restart in the drop down menu. It is possible to apply Restart feature to a group of selected bulk tasks.

Bulk tasks can also be scheduled to run at certain times or at the specified time intervals, using the Scheduling feature. It is possible to change the schedule using the corresponding item of the context menu invoked by right-clicking the task.

Completed bulk tasks will be automatically removed by the system cleanup services, usually every day.