Manage scheduled tasks

Home

Manage scheduled tasks

Use the CommunitiesSchedulerService commands to administer the community event tasks performed by the IBM WebSphere Application Server scheduler. Changes to Communities administrative settings do not require a server restart to take effect, and no file checkout is necessary.

To use administrative commands, use wsadmin. See Start wsadmin for details.

Communities uses the WebSphere Application Server scheduler to run the following scheduled tasks relating to community events:

LifecycleRetryQueuedEvents

Automatically retries sending life-cycle events to other features when event processing fails, for example, when another feature server is down. For more information about life-cycle events, see Administering remote applications.

ForumPurgeTrash

Removes deleted data from the discussion forum database. For more information on the ForumPurgeTrash task, see Purging forum trash.

EventLogCleanup

Removes old entries from the event log. For more information on the EventLogCleanup task, see Configuring news event log clean-up.

You can use the CommunitiesSchedulerService commands to retrieve details about these tasks, and manually pause and resume the tasks as needed.
To administer the tasks performed by the WebSphere Application Server scheduler...

Start wsadmin so that you can access Communities configuration files.

Access the Communities configuration files:

Stand-alone deployment:
execfile("communitiesAdmin.py")

Network deployment:
execfile("WAS_HOME/communities/Dmgr01/config/bin_lc_admin/communitiesAdmin.py")

If you are asked to select a server, you can select any server.

Use the commands in the following table to administer the Communities scheduler service.

Commands for managing the scheduler service

Option Description
CommunitiesSchedulerService.getTaskDetails(String taskName) Returns information about the scheduled task specified by taskName. The task names are LifecycleRetryQueuedEvents, ForumPurgeTrash, and EventLogCleanup.
The values returned in the HashMap are the next scheduled fire time, server time, status (SCHEDULED, RUNNING, SUSPENDED), and task name. SUSPENDED means that the task is not scheduled to run.
CommunitiesSchedulerService.pauseSchedulingTask(String taskName) Puts the task in the suspended state. When you pause a scheduled task, that task remains in the suspended state even after you stop and restart Communities or the WebSphere Application Server. You need to run the CommunitiesSchedulerService.resumeSchedulingTask command to get the scheduled task running again.
If the task is currently running when you use this command, the task continues to run but is not scheduled to run again. If the task is already suspended, this command has no effect.
The return value is either 1 or 0. 1 indicates success; 0 indicates failure.
CommunitiesSchedulerService.resumeSchedulingTask(String taskName) If the task is suspended, puts the task in the scheduled stated. If the task is not suspended, this command has no effect.
The return value is either 1 or 0. 1 indicates success; 0 indicates failure.

Administer Communities

Administer remote applications

Related tasks

Purge forum trash
Administer community queued events
Configure news event log clean-up

+
Search Tips | Advanced Search

Option	Description
CommunitiesSchedulerService.getTaskDetails(String taskName)	Returns information about the scheduled task specified by taskName. The task names are LifecycleRetryQueuedEvents, ForumPurgeTrash, and EventLogCleanup. The values returned in the HashMap are the next scheduled fire time, server time, status (SCHEDULED, RUNNING, SUSPENDED), and task name. SUSPENDED means that the task is not scheduled to run.
CommunitiesSchedulerService.pauseSchedulingTask(String taskName)	Puts the task in the suspended state. When you pause a scheduled task, that task remains in the suspended state even after you stop and restart Communities or the WebSphere Application Server. You need to run the CommunitiesSchedulerService.resumeSchedulingTask command to get the scheduled task running again. If the task is currently running when you use this command, the task continues to run but is not scheduled to run again. If the task is already suspended, this command has no effect. The return value is either 1 or 0. 1 indicates success; 0 indicates failure.
CommunitiesSchedulerService.resumeSchedulingTask(String taskName)	If the task is suspended, puts the task in the scheduled stated. If the task is not suspended, this command has no effect. The return value is either 1 or 0. 1 indicates success; 0 indicates failure.