umsTaskCfg - configuration of scripting applications
|
UmsTaskCfg lets you to controll applications (tasks) run inside UMS.TaskManager envinronment. There are
two types of tasks:
- "startup", which are processed only once when UMS.TaskManager starts
- "normal", which are divided into 2 subtypes:
- "always running" - which are checked by UMS.TaskManager and kept running
- "scheduled" - which are started at exact time by UMS.Taskmanager
Using umsTaskCfg is the same for both startup and normal tasks, so detailed description you can find
bellow at "normal" tasks.
"Startup" tasks
This is "startup" tasks view. Disabled applications are marked by red icon.
When you doubleclick by left button on the application name, dialog with application
settings will be displayed:
Description of individual options you can find bellow, see "normal" tasks.
"Normal" tasks - always running
Switch to the "normal" applications using menu or icon on the toolbar.
Disabled applications are marked by red icon.
Distinguishing mark between always running and scheduled task is one of these options in task settings:
Run constantly - for always running tasks
Run at time - for scheduled tasks
If you rightclick by mouse on any item, context menu appears with commands for making some task settings. Commands are
described bellow at dialog options description.
Also shorcut keys work here. All of them are available from main menu; some basic are:
- space key - enables/disables selected task
- R - sets Restart for selected task
- F5 - refreshes values, reads actual status of tasks
- Enter - shows dialog for task settings
"Last run" column contains time when task was started last time.
Actual task status is described in "Status" column - "Running", "Stopped" or "Will start at ..." (what means tasks is stopped,
of course). To discover actual status of all tasks you must press F5 key to read current data from the server!!
If there is "1" value in "Restart" or "Run once" columns it means that task is requested to restart or to be run once
(see bellow in task settings). When this request if fulfilled, "0" value is set back (you must refresh current status by F5 pressing,
of course).
When you doubleclick by left button on the application name, dialog with application
settings will be displayed.
You can set if application is Enabled or not, and its various parameters also:
- Timeout is maximum amount of time, during which application doesn't respond to
UMS.TaskManager messages. When application doesn't respond for a longer time, it will be restarted.
- Working directory is folder, where application will be run.
- Command line describes what application will be run and its parameters.
- Comment - description for administrative purposes, is displayed im umsTaskCfg window. It has no effect to application.
- Restart - time period in seconds. When this time expires, task will be restarted
automatically. For example if you set 3600, application will be stopped and run again every hour. 0 = don't restart.
- Run period determines time period from the last launch to the new launch (if tasks stops). 0 = keep continuosly running
(launch again immediately). This option is used for tasks, which must be running only sometimes (once a hour etc.). It is also
usefull if tasks can not be started for any reason - instead of continuous launching (which takes many server resources) task
will be launched for example once per 15 seconds.
- Last run item shows when task was started last time
- Dependecy item - you can put name of one normal task here, which must be executed and stopped before this task can be started
- If Share console is checked, task output is routed to the UMS.TaskManager window. If it is unchecked, task has its own
output window.
- If you check Restart option, task will be restarted; stop request will be sent to the task (if it doesn't stop during some
time, it will be killed) and after stopping it starts again.
- Run once option is intended for disabled tasks. If "Run once" is checked for disabled task, it will be started no matter
on "Enabled" option, but when it terminates, it will not be started again.
"Normal" tasks - scheduled
There are tasks between normal tasks, which are started at regulat time intervals.
Task settings are the same in common properties as for always running tasks. They differ in extended settings, where you can set
these options:
- Run at time
- Daily at - set time when task will be started
- Monthly - set day in the month when task will be started
- Run immediately when delayed - this means that if UMS.TaskManager was busy at time when task should be started, then it will be
started immediately when TaskManager is free.
- Last run item shows when task was started last time
- Dependecy item - you can put name of one normal task here, which must be executed and stopped before this task can be started.
For example:
Daily statistics are created in this way - task for calculating statistics is started at specified time, but it depends on task which
creates statistics of cost centers. And this task depends on task for group statistics. So first is run group statistic task and log
is preserved. Cost centers statistic follows and log is preserved again. Finally, individual statistic is run and log is deleted.
If you want administer applications on the remote server using UmsTaskCfg, you must be logged on
using administrative account from the remote server, or you must map network drive from this
server using such account (use Connect As function).
Details about UMS.Taskmanager work you can get from application log. Setting of the logging level is
described here.
There is "TaskManager" submenu in main menu. It contains commands for controlling UMS.TaskManager service on the server - service
can be started, stopped or restarted.
back to top of page