com.sapportals.wcm.service.scheduler
Interface ISchedulerEntry

[contained in: com.sap.netweaver.bc.sf.service.par - bc.sf.service.scheduler_api.jar]

All Superinterfaces:

IComponent

public interface ISchedulerEntry

extends IComponent

Scheduler entries contain data for scheduler tasks.

An ISchedulerEntry represents an entry in the IScheduler's internal list. Each entry has a unique id, specifies the task to execute and a timetable, which specifies the scheduling timetable (when to execute the task). In addition, there might be some (String-)parameters for the task, passed as properties.

Copyright 2004 SAP AG

See Also:

ISchedulerService

Method Summary

java.lang.String	getID() Get the unique id of the entry.
int	getPriority() Get the priority of the entry.
java.util.Properties	getProperties() Get the properties to pass to the task of the entry.
ISystemList	getSystemList() Gets the ID of the CM system where to run the ISchedulerTask physically.
ISchedulerTask	getTask() Get the task for the entry.
ISchedulerTimeTable	getTimeTable() Get the timetable for the entry.
boolean	isRunning() Check if the entry is running(currently being executed).
boolean	isSuspended() Check if the entry is suspended (currently inactive and not waiting).
boolean	isWaiting() Check if the entry is not suspended and not active.
void	setPriority(int priority) Set the priority of the entry.
void	setProperties(java.util.Properties properties) Set the entry's properties to pass to the task.
void	setSystemList(ISystemList systemList) Sets the ID of the CM system where to run the ISchedulerTask physically.
void	setTask(ISchedulerTask task) Set the entry's task.
void	setTimeTable(ISchedulerTimeTable timetable) Set the entry's timetable.

Method Detail

getID

public java.lang.String getID()

Get the unique id of the entry.

Returns:

a String with the entry's id.

getPriority

public int getPriority()

Get the priority of the entry.

Returns:

an int with the entry's priority (a higher value is a higher priority).

setPriority

public void setPriority(int priority)
                 throws WcmException

Set the priority of the entry.

Parameters:

priority - an int with the entry's priority (a higher value is a higher priority).

isRunning

public boolean isRunning()
                  throws WcmException

Check if the entry is running(currently being executed).

Returns:

a boolean true, if the entry's task is currently being executed, false if not.

Throws:

WcmException - if the state could not be determined.

isSuspended

public boolean isSuspended()
                    throws WcmException

Check if the entry is suspended (currently inactive and not waiting).

Returns:

a boolean true, if the entry's task is suspended, false if not.

Throws:

WcmException - if the state could not be determined.

isWaiting

public boolean isWaiting()
                  throws WcmException

Check if the entry is not suspended and not active.

Returns:

a boolean true, if the entry's task is currently neither being executed nor suspended, false if not.

Throws:

WcmException - if the state could not be determined.

getTask

public ISchedulerTask getTask()
                       throws WcmException

Get the task for the entry.

Returns:

an ISchedulerTask with the task.

Throws:

WcmException - if the task could not be retrieved.

setTask

public void setTask(ISchedulerTask task)
             throws WcmException

Set the entry's task.

Parameters:

task - an ISchedulerTask with the task to execute.

Throws:

WcmException - if the scheduler entry could not be updated.

getTimeTable

public ISchedulerTimeTable getTimeTable()
                                 throws WcmException

Get the timetable for the entry.

Returns:

an ISchedulerTimeTable with the timetable.

Throws:

WcmException - if the timetable could not be retrieved.

setTimeTable

public void setTimeTable(ISchedulerTimeTable timetable)
                  throws WcmException

Set the entry's timetable.

Parameters:

timetable - an ISchedulerTimeTable with the timetable to use.

Throws:

WcmException - if the timetable could not be set

getProperties

public java.util.Properties getProperties()
                                   throws WcmException

Get the properties to pass to the task of the entry.

Returns:

the Properties for the task.

Throws:

WcmException - if the properties could not be retrieved.

setProperties

public void setProperties(java.util.Properties properties)
                   throws WcmException

Set the entry's properties to pass to the task.

Parameters:

properties - the Properties for the task.

Throws:

WcmException - if the properties could not be set.

getSystemList

public ISystemList getSystemList()

Gets the ID of the CM system where to run the ISchedulerTask physically.

Returns:

the ID of the CM system where to run the ISchedulerTask physically.

setSystemList

public void setSystemList(ISystemList systemList)
                   throws WcmException

Sets the ID of the CM system where to run the ISchedulerTask physically.

Parameters:

systemList - The new systemList value

Throws:

WcmException - if the system list could not be set.