Using the Task Manager

Caché System Administration Guide

[Home] [Back] [Next]

InterSystems: The power behind what matters

Caché System Administration > Caché System Administration Guide > Managing Caché > Using the Task Manager

Class Reference

Search:

Using the Task Manager

To use the Task Manager, select System Operation > Task Manager) to display the following menu options:

New Task (schedule a new task)
On-demand Task(execute a task on demand)
Upcoming Tasks (view tasks scheduled to run in the next 24 hours)
Task Schedule (view all scheduled tasks)
Task History (view completed tasks)
Import Tasks (import tasks previously exported to files, possibly by another Caché instance

Note:

The Task Manager polls every 60 seconds to see if there are any Tasks to be run. When you click Perform Action Now to schedule a Task, there may be a delay of up to 60 seconds before the newly scheduled Task actually runs.

New Task

The New Task option starts the Task Scheduler Wizard.

The first page of the wizard asks for the following information:
- Task name
- Description
- Namespace to run task in — choose from the list of defined namespaces in which to run the task
- Task type — choose from among the listed tasks (the list varies with the namespace you select at the previous prompt)
  
  Note:
  Depending on the task type selected, you may be presented with a form in which to specify additional information; for example, if you are scheduling an IntegrityCheck, the form prompts you for Directory, Filename, and KeepDays (number of days to keep the file).
  - CheckLogging — creates an alert or turns off ^%ISCLOG or ^ISCSOAP logging if it has been running too long (by default, 2 days)
  - CleanSQLIndex— cleans up stale SQL Statemne tIndex entries
  - CumuIncrDBList — a cumulative backup of databases in the defined list
  - DiagnosticReport — collects and delivers diagnostic reports to the WRC
  - FullAllDatabases — a full backup of all databases
  - FullDBList — a full backup of databases in the defined list
  - IncrementalDBList — an incremental backup of databases in the defined list
  - IntegrityCheck — an integrity check of databases in the namespace. The Integrity Check task only appears when the %SYS namespace is selected.
  - InventoryScan — compiles an inventory scan of the instance
  - PurgeAudit — purge the audit database after a specified time following a journal switch
  - PurgeBackupLog — purge the backup log after a specified time following a database backup
  - PurgeErrorsAndLogs — purge error globals and cconsole.log based on settings in the cache.cpf file (see ErrorPurge and MaxConsoleLogSize parameters in the Startup section of the “Introduction to the Caché Parameter File” chapter of the Caché Parameter File Reference)
    
    Note:
    When System Monitor is running, it monitors and limits the size of the console log.
  - PurgeJournal — purge journal files that meet the purging criteria
  - PurgeTaskHistory — purge task manager history files
  - RunLegacyTask — run a legacy task, that is, your own programmatic task; the line you enter in the text box, for example do ^MyCode, must be executable in Terminal
    
    Note:
    Do not use the local variable Status in RunLegacyTask code. Caché uses this variable, and if it is modified by RunLegacyTask code, the task is likely to end with an error status.
    
    A legacy task that fails to complete due to an error is marked Suspended due to error and is not scheduled to run until the error is corrected and you resume the task.
  - SecurityScan — disables expired user accounts, and expires user passwords and CSP session tokens
  - ShadowPurge — purge shadow files
  - SuspendOnError — determines what happens if the Task returns an error %Status from the OnTask() method. Errors encountered by the Task Manager trying to execute the task (login error or no such Task found) do not check this flag.
  - SwitchJournal — switch to a new journal file
  - UpdateSQLStats— updates the information on SQL query statistics
  Note:
  You can define your own task types using the %SYS.Task.Definition API; see the class documentation in the InterSystems Class Reference.
- Task priority — Choose from Priority Normal > Priority Low, or Priority High.
- Run task as this user — Choose from the list of defined users. To choose a different user than the one you are logged in as, you must have the %Admin_Secure:Use privilege.
  
  Note:
  Each task consumes a license unit, with the license user ID based on the Caché username you select; see License Login Special Considerations in the “Caché Licensing” chapter of this guide for more information.
- Open output file when task is running and Output file — If the task creates output, the log file is written to the directory specified.
- Suspend task on error? — Specify whether the task will be rescheduled and continue to run after an error, or suspended. The default is No, to reschedule and run the task after an error.
- Reschedule task after system restart? — Specify whether you want to reschedule the task when the system restarts (that is, if the system is down when the task is scheduled to run):
  - No specifies that the task should run when the system restarts.
  - Yes specifies that the task should be rescheduled for the next logical time after the system restarts.
- Send completion email notification to — If you have configured email settings for the Task Manager (see Configuring Task Manager Email Settings in the “Configuring Caché” chapter of this guide), enter a comma-separated list of email addresses to which a notification should be sent when the task ends successfully.
- Send error email notification to — If you have configured email settings for the Task Manager, enter a comma-separated list of email addresses to which a notification should be sent when the task ends in error.
- How should task run for Mirror — If this instance is a mirror member, specify the type of member the task can be run on:
  - run on primary failover member only
  - run on backup failover member and async members only (all except primary)
  - run on all mirror members (primary, backup, and asyncs)
  Note:
  When the status of a failover member is in transition, for example when the backup is in the process of taking over as primary, the Task Manager does not run any tasks on that member until its status as primary or backup is established.
Click Next to specify when you want the task to run.
Click Finish to schedule the task.

All tasks are configured to expire by default. To change this:

Open Terminal.
Enter zn “%SYS” to change to the %SYS namespace.
Enter do ^TASKMGR.
Select option 2.
Enter the task number you want to edit.
Press Enter to save the defaults of each option until you reach Task Expires?
Enter No.

The selected task will no longer expire.

There are three additional expiration fields that control when a task expires. These are controlled by days, hours, and minutes. To adjust when a specific task expires:

Open Terminal.
Enter zn “%SYS” to change to the %SYS namespace.
Enter do ^TASKMGR.
Select option 2.
Enter the task number you want to edit.
Press Enter to save the defaults of each option until you reach Expires in how many days?, Expires in how many hours?, or Expires in how many minutes?
To edit the expiration times of this task, enter the days, hour, or minutes you would like to schedule.

The values for this expiration are now saved.

For details on the information necessary to schedule or edit a task, see the %SYS.TaskSuper class documentation in the InterSystems Class Reference.

On-demand Task

The On-demand Task page (System Operation > Task Manager > On-demand Task) lists the tasks you have scheduled as on-demand. The list includes the task name, a description, and an option to Run the task from this page. You can sort the information in the table by clicking any column heading. When you click Run, the Run Task Wizard page displays the task name and ID, and the date and time the task will run; click Perform Action Now to confirm the information and schedule the task.

Upcoming Tasks

The Upcoming Tasks page (System Operation > Task Manager > Upcoming Tasks)lists the tasks scheduled to run within a certain interval. To select an interval, click an option in the Scheduled to run: search pane to the left of the task list. If you select the To a date option, you can either enter a date in yyyy-mm-dd format or click the calendar icon to select a date from the calendar.

You can sort the information in the task list by clicking any column heading. You can Suspend or Resume the scheduling of each task by clicking the appropriate option:

Suspend — Lets you suspend the task; a do you want to reschedule task when task is supposed to run? drop-down list lets you specify:
- No to suspend it indefinitely.
- Yes to suspend it now, and resume it when it is normally scheduled to run.
Resume — Lets you resume a suspended task.

Task Schedule

The Task Schedule page (System Operation > Task Manager > Task Schedule) lists all scheduled tasks. You can sort the information in the table by clicking any column heading. You can view Details or History, as well as Run, a scheduled task by clicking the appropriate option:

taskname — Lets you view details about the task and perform operations on it.
History — Displays the task’s history.
Run — Lets you run the task. A Run Task wizard displays the task name and ID, and the date and time the task will run; click Perform Action Now to confirm the information and schedule the task.

Task Details

To display detailed information about a scheduled task and perform one of several operations on it, click the task’s name in the Task Name column. The Task Details page displays information and execution details about the selected task. You can perform one of the following operations on the task by clicking the appropriate button:

Edit — Lets you change the task definition and schedule using the Task Scheduler Wizard.
History — Lets you view the task’s history.
Resume > Suspend— Let you suspend a task or resume a suspended task, as on the Upcoming Tasks page.
Delete — Lets you permanently delete the task.
Export — Lets you export a task to a file that can later be imported, including by another Caché instance.
Run — Lets you schedule the task. When you click Run, the Run Task Wizard page displays the task name and ID, and the date and time the task will run; click Perform Action Now to confirm the information and schedule the task.

Note:

Some of the actions options described are unavailable while a task is running.

Scheduled Task History

To display history information about an individual scheduled task, click the History link in the row of the item. The Task History page displays detailed history for the selected task. The Result column indicates the outcome the last time the task was run, showing either Success or an error message. You can sort the information in the table by clicking any column heading.

The Details link at the top of the page displays the Task Details page for the selected task.

Task History

The Task History page (System Operation > Task Manager > Task History) lists the history of all tasks executed by the Task Manager. You can sort the information in the table by clicking any column heading.

Import Tasks

The Import Tasks page (System Operation > Task Manager > Import Tasks) lets you import and run a task by browsing to a previously-exported task file, then clicking Perform Action Now. For information about exporting tasks to a file, see Task Details in this section.