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 you begin

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

EventLogCleanup

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...

  1. 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.

  2. 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 Communities

Related concepts
Administer widgets and remote applications
Scheduling tasks


Related tasks


Administer community queued events
Configure news event log clean-up


   

 

});