Manage Communities scheduled tasks
Use the CommunitiesScheduler commands to administer the community event tasks performed by the IBM WAS scheduler. These administrative commands do not require a server restart to take effect, and no file checkout is necessary.
Before starting
To use administrative commands, use the wsadmin client. See Starting the wsadmin client for details.
About this task
Communities uses the WAS scheduler to run the following scheduled tasks relating to community events. For more information about the scheduler, see Scheduling tasks.LifecycleRetryQueuedEvents
Automatically retries sending life-cycle events to other applications when event processing fails, for example, when another application server is down. For more information about life-cycle events, see Administer widgets and remote applications.
EventLogCleanup
Removes old entries from the event log. For more information on the EventLogCleanup task, see Configure news event log clean-up.
You can use the CommunitiesScheduler commands to retrieve details about these tasks, and manually pause and resume the tasks as needed.
Procedure
To administer the tasks performed by the WAS scheduler...
- From the dmgr host:
cd $DMGR_PROFILE/bin
./wsadmin.sh -jython
execfile("communitiesAdmin.py")
If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.
- Use the commands in the following table to administer the Communities scheduler service.
CommunitiesScheduler.getTaskDetails(String taskName)
Returns information about the scheduled task specified by taskName. The task names are LifecycleRetryQueuedEvents 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.
CommunitiesScheduler.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 WAS. The task names are LifecycleRetryQueuedEvents and EventLogCleanup. Run the CommunitiesScheduler.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.
CommunitiesScheduler.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 task names are LifecycleRetryQueuedEvents and EventLogCleanup.
The return value is either 1 or 0. 1 indicates success; 0 indicates failure.
Parent topic
Administer CommunitiesRelated concepts
Administer widgets and remote applications
Scheduling tasks
Related tasks
Administer community queued events
Configure news event log clean-up
});