org.rhq.enterprise.server.operation

Interface OperationManagerLocal

All Superinterfaces:

OperationManagerRemote

All Known Implementing Classes:

OperationManagerBean

public interface OperationManagerLocal
extends OperationManagerRemote

Method Summary

Methods

Modifier and Type	Method and Description
void	checkForCompletedGroupOperation(int historyId) This is, for all intents and purposes, and internal method.
void	checkForTimedOutOperations(org.rhq.core.domain.auth.Subject whoami) Will check to see if any in progress operation jobs are taking too long to finish and if so marks their histories as failed.
void	deleteOperationScheduleEntity(org.rhq.core.domain.operation.ScheduleJobId jobId) This will delete an operation schedule entity identified with the given job ID.
org.rhq.core.domain.util.PageList<org.rhq.core.domain.operation.GroupOperationHistory>	findCompletedGroupOperationHistories(org.rhq.core.domain.auth.Subject subject, int groupId, org.rhq.core.domain.util.PageControl pc) Returns the list of completed operation histories for the group resource.
org.rhq.core.domain.util.PageList<org.rhq.core.domain.operation.ResourceOperationHistory>	findCompletedResourceOperationHistories(org.rhq.core.domain.auth.Subject subject, int resourceId, Long startDate, Long endDate, org.rhq.core.domain.util.PageControl pc) Returns the list of completed operation histories for the given resource.
org.rhq.core.domain.util.PageList<org.rhq.core.domain.operation.composite.GroupOperationScheduleComposite>	findCurrentlyScheduledGroupOperations(org.rhq.core.domain.auth.Subject subject, org.rhq.core.domain.util.PageControl pc) Gets a list of all currently scheduled group operations (that is, scheduled but not yet invoked and/or completed).
org.rhq.core.domain.util.PageList<org.rhq.core.domain.operation.composite.ResourceOperationScheduleComposite>	findCurrentlyScheduledResourceOperations(org.rhq.core.domain.auth.Subject subject, org.rhq.core.domain.util.PageControl pc) Gets a list of all currently scheduled resource operations (that is, scheduled but not yet invoked and/or completed).
org.rhq.core.domain.util.PageList<org.rhq.core.domain.operation.GroupOperationHistory>	findPendingGroupOperationHistories(org.rhq.core.domain.auth.Subject subject, int groupId, org.rhq.core.domain.util.PageControl pc) Returns the list of pending operation histories for the group resource.
org.rhq.core.domain.util.PageList<org.rhq.core.domain.operation.ResourceOperationHistory>	findPendingResourceOperationHistories(org.rhq.core.domain.auth.Subject subject, int resourceId, org.rhq.core.domain.util.PageControl pc) Returns the list of pending operation histories for the given resource.
org.rhq.core.domain.util.PageList<org.rhq.core.domain.operation.composite.GroupOperationLastCompletedComposite>	findRecentlyCompletedGroupOperations(org.rhq.core.domain.auth.Subject subject, org.rhq.core.domain.util.PageControl pc) Gets a list of all recently completed group operations.
org.rhq.core.domain.util.PageList<org.rhq.core.domain.operation.composite.ResourceOperationLastCompletedComposite>	findRecentlyCompletedResourceOperations(org.rhq.core.domain.auth.Subject subject, Integer resourceId, org.rhq.core.domain.util.PageControl pc) Gets a list of all recently completed resource operations.
org.rhq.core.domain.util.PageList<org.rhq.core.domain.operation.ResourceOperationHistory>	findResourceOperationHistoriesByGroupHistoryId(org.rhq.core.domain.auth.Subject subject, int historyId, org.rhq.core.domain.util.PageControl pc) Get the paged resource operation histories for a given group history.
List<org.rhq.core.domain.operation.OperationDefinition>	findSupportedGroupOperations(org.rhq.core.domain.auth.Subject subject, int compatibleGroupId, boolean eagerLoaded) Returns the definitions of all the operations supported by the given group.
List<org.rhq.core.domain.operation.OperationDefinition>	findSupportedResourceOperations(org.rhq.core.domain.auth.Subject subject, int resourceId, boolean eagerLoaded) Returns the definitions of all the operations supported by the given resource.
List<org.rhq.core.domain.operation.OperationDefinition>	findSupportedResourceTypeOperations(org.rhq.core.domain.auth.Subject subject, int resourceTypeId, boolean eagerLoaded) Returns the definitions of all the operations supported by the given resource type.
org.rhq.core.domain.operation.bean.GroupOperationSchedule	getGroupOperationSchedule(org.rhq.core.domain.auth.Subject whoami, int scheduleId) TODO
org.rhq.core.domain.operation.bean.GroupOperationSchedule	getGroupOperationSchedule(org.rhq.core.domain.auth.Subject subject, org.quartz.JobDetail jobDetail) Given a group operation job's details, this returns a schedule POJO corresponding to that job.
org.rhq.core.domain.operation.bean.GroupOperationSchedule	getGroupOperationSchedule(org.rhq.core.domain.auth.Subject subject, String jobId) Given a group job's id, this returns the schedule for that group job.
org.rhq.core.domain.operation.ResourceOperationHistory	getLatestCompletedResourceOperation(org.rhq.core.domain.auth.Subject subject, int resourceId) Get the mostly recently run operation for the Resource with the given id, or null if the resource has had no operations performed against it yet (or if all previously performed operations have been deleted from the history).
org.rhq.core.domain.operation.ResourceOperationHistory	getOldestInProgressResourceOperation(org.rhq.core.domain.auth.Subject subject, int resourceId) Get the oldest operation still in progress for the Resource with the given id, or null if the resource has no operations being performed against it.
org.rhq.core.domain.operation.OperationDefinition	getOperationDefinition(org.rhq.core.domain.auth.Subject subject, int operationId) Get the OperationDefinition object that corresponds to this operationId
org.rhq.core.domain.operation.OperationDefinition	getOperationDefinitionByResourceTypeAndName(int resourceTypeId, String operationName, boolean eagerLoaded)
org.rhq.core.domain.operation.OperationHistory	getOperationHistoryByHistoryId(org.rhq.core.domain.auth.Subject subject, int historyId) TODO
org.rhq.core.domain.operation.OperationHistory	getOperationHistoryByJobId(org.rhq.core.domain.auth.Subject subject, String historyJobId) TODO
List<org.rhq.core.domain.common.composite.IntegerOptionItem>	getResourceNameOptionItems(int groupId) TODO
org.rhq.core.domain.operation.bean.ResourceOperationSchedule	getResourceOperationSchedule(org.rhq.core.domain.auth.Subject whoami, int scheduleId) TODO
org.rhq.core.domain.operation.bean.ResourceOperationSchedule	getResourceOperationSchedule(org.rhq.core.domain.auth.Subject subject, org.quartz.JobDetail jobDetail) Given a Resource operation job's details, this returns a schedule POJO corresponding to that job.
org.rhq.core.domain.operation.bean.ResourceOperationSchedule	getResourceOperationSchedule(org.rhq.core.domain.auth.Subject subject, String jobId) Given a resource job's id, this returns the schedule for that resource job.
org.rhq.core.domain.operation.OperationDefinition	getSupportedGroupOperation(org.rhq.core.domain.auth.Subject subject, int compatibleGroupId, String operationName, boolean eagerLoaded) Returns the definition of the named operation supported by the given group.
org.rhq.core.domain.operation.OperationDefinition	getSupportedResourceOperation(org.rhq.core.domain.auth.Subject subject, int resourceId, String operationName, boolean eagerLoaded) Returns the definition of the named operation supported by the given resource.
boolean	isGroupOperationSupported(org.rhq.core.domain.auth.Subject subject, int resourceGroupId) Determines if the given group has at least one operation.
boolean	isResourceOperationSupported(org.rhq.core.domain.auth.Subject subject, int resourceId) Determines if the given resource has at least one operation.
int	purgeOperationHistory(Date purgeBeforeTime) Purge all operation history created before the specified time.
int	purgeOperationHistoryInNewTransaction(Date purgeBeforeTime, boolean isGroupPurge, int limit) This does the work of purgeOperationHistory(Date), targeting group or resource history, and limits transaction size by applying a limit to the number of history records purged.
int	scheduleGroupOperation(org.rhq.core.domain.auth.Subject subject, org.rhq.core.domain.operation.bean.GroupOperationSchedule schedule) Schedules a Resource group operation for execution.
org.rhq.core.domain.operation.bean.GroupOperationSchedule	scheduleGroupOperation(org.rhq.core.domain.auth.Subject subject, int groupId, int[] executionOrderResourceIds, boolean haltOnFailure, String operationName, org.rhq.core.domain.configuration.Configuration parameters, org.quartz.Trigger trigger, String description) Schedules an operation for execution on members of the given group.
org.rhq.core.domain.operation.bean.ResourceOperationSchedule	scheduleResourceOperation(org.rhq.core.domain.auth.Subject subject, int resourceId, String operationName, org.rhq.core.domain.configuration.Configuration parameters, org.quartz.Trigger trigger, String description) Schedules an operation for execution on the given resource.
int	scheduleResourceOperation(org.rhq.core.domain.auth.Subject subject, org.rhq.core.domain.operation.bean.ResourceOperationSchedule schedule) Schedules a Resource operation for execution.
org.rhq.core.domain.operation.OperationHistory	updateOperationHistory(org.rhq.core.domain.auth.Subject subject, org.rhq.core.domain.operation.OperationHistory history) This is called by the jobs so they can update the history.
void	updateOperationScheduleEntity(org.rhq.core.domain.operation.ScheduleJobId jobId, long nextFireTime) This allows you to update an operation schedule entity with a new next-fire-time.

Methods inherited from interface org.rhq.enterprise.server.operation.OperationManagerRemote

cancelOperationHistory, deleteOperationHistories, deleteOperationHistory, findGroupOperationHistoriesByCriteria, findOperationDefinitionsByCriteria, findResourceOperationHistoriesByCriteria, findScheduledGroupOperations, findScheduledResourceOperations, scheduleGroupOperation, scheduleGroupOperationUsingCron, scheduleResourceOperation, scheduleResourceOperationUsingCron, unscheduleGroupOperation, unscheduleResourceOperation

Method Detail

getResourceNameOptionItems

List<org.rhq.core.domain.common.composite.IntegerOptionItem> getResourceNameOptionItems(int groupId)

TODO

Parameters:

groupId -

Returns:

scheduleResourceOperation

int scheduleResourceOperation(org.rhq.core.domain.auth.Subject subject,
                            org.rhq.core.domain.operation.bean.ResourceOperationSchedule schedule)

Schedules a Resource operation for execution.

Parameters:

subject - the user who is asking to schedule the job

schedule - the information describing the operation to be scheduled along with the schedule to be used

Returns:

the id of the ResourceOperationScheduleEntity created to track the scheduled operation

scheduleGroupOperation

int scheduleGroupOperation(org.rhq.core.domain.auth.Subject subject,
                         org.rhq.core.domain.operation.bean.GroupOperationSchedule schedule)
                           throws ScheduleException

Schedules a Resource group operation for execution.

Parameters:

subject - the user who is asking to schedule the job

schedule - the information describing the operation to be scheduled along with the schedule to be used

Returns:

the id of the GroupOperationScheduleEntity created to track the scheduled operation

Throws:

ScheduleException

scheduleResourceOperation

org.rhq.core.domain.operation.bean.ResourceOperationSchedule scheduleResourceOperation(org.rhq.core.domain.auth.Subject subject,
                                                                                     int resourceId,
                                                                                     String operationName,
                                                                                     org.rhq.core.domain.configuration.Configuration parameters,
                                                                                     org.quartz.Trigger trigger,
                                                                                     String description)
                                                                                       throws org.quartz.SchedulerException

Schedules an operation for execution on the given resource.

Parameters:

subject - the user who is asking to schedule the job

resourceId - the resource that is the target of the operation

operationName - the actual operation to invoke

parameters - optional parameters to pass into the operation

trigger - the schedule of when the job runs (the names and group names in this trigger are ignored and reset by this method)

description - user-entered description of the job to be scheduled

Returns:

the information on the new schedule

Throws:

org.quartz.SchedulerException - if failed to schedule the operation

scheduleGroupOperation

org.rhq.core.domain.operation.bean.GroupOperationSchedule scheduleGroupOperation(org.rhq.core.domain.auth.Subject subject,
                                                                               int groupId,
                                                                               int[] executionOrderResourceIds,
                                                                               boolean haltOnFailure,
                                                                               String operationName,
                                                                               org.rhq.core.domain.configuration.Configuration parameters,
                                                                               org.quartz.Trigger trigger,
                                                                               String description)
                                                                                 throws org.quartz.SchedulerException

Schedules an operation for execution on members of the given group.

Parameters:

subject - the user who is asking to schedule the job

groupId - the group whose member resources are the target of the operation

executionOrderResourceIds - optional order of exection - if notnull, these are group members resource IDs in the order in which the operations are invoked

haltOnFailure - if true, the group operation will halt whenever one individual resource fails to execute. When executing in order, this means once a failure occurs, the resources next in line to execute will abort and not attempt to execute. If not executing in any particular order, you are not guaranteed which will stop and which will continue since all are executed as fast as possible, but the group operation will attempt to stop as best it can.

operationName - the actual operation to invoke

parameters - optional parameters to pass into the operation

trigger - the schedule of when the job runs (the names and group names in this trigger are ignored and reset by this method)

description - user-entered description of the job to be scheduled

Returns:

the information on the new schedule

Throws:

org.quartz.SchedulerException - if failed to schedule the operation

getResourceOperationSchedule

org.rhq.core.domain.operation.bean.ResourceOperationSchedule getResourceOperationSchedule(org.rhq.core.domain.auth.Subject whoami,
                                                                                        int scheduleId)

TODO

Parameters:

whoami -

scheduleId -

Returns:

getGroupOperationSchedule

org.rhq.core.domain.operation.bean.GroupOperationSchedule getGroupOperationSchedule(org.rhq.core.domain.auth.Subject whoami,
                                                                                  int scheduleId)

TODO

Parameters:

whoami -

scheduleId -

Returns:

deleteOperationScheduleEntity

void deleteOperationScheduleEntity(org.rhq.core.domain.operation.ScheduleJobId jobId)

This will delete an operation schedule entity identified with the given job ID. Note that this does not actually unschedule the job - it merely removed our schedule tracking entity. This schedule tracking entity is really just used to provide some additional querying capabilities since it allows us to link a resource or group ID with a Quartz job directly within SQL.

This method is really just for the OperationJob objects to clean out the schedule tracking entity when the schedule has run its course and will no longer be triggered. The UI or other pieces of client code will usually not have to ever use this method; if you are thinking about having a need to call this method, please know what you are doing.

Parameters:

jobId -

updateOperationScheduleEntity

void updateOperationScheduleEntity(org.rhq.core.domain.operation.ScheduleJobId jobId,
                                 long nextFireTime)

This allows you to update an operation schedule entity with a new next-fire-time.

This method is really just for the OperationJob objects to update the schedule tracking entity. The UI or other pieces of client code will usually not have to ever use this method; if you are thinking about having a need to call this method, please know what you are doing.

Parameters:

jobId -

nextFireTime - the next time this job is due to be triggered

getResourceOperationSchedule

@Nullable
org.rhq.core.domain.operation.bean.ResourceOperationSchedule getResourceOperationSchedule(org.rhq.core.domain.auth.Subject subject,
                                                                                                 org.quartz.JobDetail jobDetail)

Given a Resource operation job's details, this returns a schedule POJO corresponding to that job.

Parameters:

subject -

jobDetail -

Returns:

the object that encapsulates the resource schedule, or null if the specified job is no longer scheduled

getResourceOperationSchedule

org.rhq.core.domain.operation.bean.ResourceOperationSchedule getResourceOperationSchedule(org.rhq.core.domain.auth.Subject subject,
                                                                                        String jobId)
                                                                                          throws org.quartz.SchedulerException

Given a resource job's id, this returns the schedule for that resource job.

Parameters:

subject -

jobId -

Returns:

the object that encapsulates the resource schedule

Throws:

org.quartz.SchedulerException - if failed to find the schedule

getGroupOperationSchedule

@Nullable
org.rhq.core.domain.operation.bean.GroupOperationSchedule getGroupOperationSchedule(org.rhq.core.domain.auth.Subject subject,
                                                                                           org.quartz.JobDetail jobDetail)

Given a group operation job's details, this returns a schedule POJO corresponding to that job.

Parameters:

subject -

jobDetail -

Returns:

the object that encapsulates the group schedule, , or null if the specified job is no longer scheduled

getGroupOperationSchedule

org.rhq.core.domain.operation.bean.GroupOperationSchedule getGroupOperationSchedule(org.rhq.core.domain.auth.Subject subject,
                                                                                  String jobId)
                                                                                    throws org.quartz.SchedulerException

Given a group job's id, this returns the schedule for that group job.

Parameters:

subject -

jobId -

Returns:

the object that encapsulates the group schedule

Throws:

org.quartz.SchedulerException - if failed to find the schedule

findResourceOperationHistoriesByGroupHistoryId

org.rhq.core.domain.util.PageList<org.rhq.core.domain.operation.ResourceOperationHistory> findResourceOperationHistoriesByGroupHistoryId(org.rhq.core.domain.auth.Subject subject,
                                                                                                                                       int historyId,
                                                                                                                                       org.rhq.core.domain.util.PageControl pc)

Get the paged resource operation histories for a given group history.

Parameters:

subject - the user that wants to see the history

historyId - ID of the history to retrieve

pc - the page control used for sorting and paging of results

Returns:

the requested page of sorted resource operation history results for the given group history

findCompletedGroupOperationHistories

org.rhq.core.domain.util.PageList<org.rhq.core.domain.operation.GroupOperationHistory> findCompletedGroupOperationHistories(org.rhq.core.domain.auth.Subject subject,
                                                                                                                          int groupId,
                                                                                                                          org.rhq.core.domain.util.PageControl pc)

Returns the list of completed operation histories for the group resource. This will return all items that are no longer INPROGRESS that were invoked on this group. This only returns the group history item - not the individual resource operation histories for the group member invocation results. See findCompletedResourceOperationHistories(Subject, int, Long, Long, PageControl) for that.

Parameters:

subject -

groupId -

pc -

Returns:

all group histories

findPendingGroupOperationHistories

org.rhq.core.domain.util.PageList<org.rhq.core.domain.operation.GroupOperationHistory> findPendingGroupOperationHistories(org.rhq.core.domain.auth.Subject subject,
                                                                                                                        int groupId,
                                                                                                                        org.rhq.core.domain.util.PageControl pc)

Returns the list of pending operation histories for the group resource. This will return all items that are still INPROGRESS that were invoked on this group. This only returns the group history item - not the individual resource operation histories for the group member invocation results. See findPendingResourceOperationHistories(Subject, int, PageControl) for that.

Parameters:

subject -

groupId -

pc -

Returns:

all group histories

updateOperationHistory

org.rhq.core.domain.operation.OperationHistory updateOperationHistory(org.rhq.core.domain.auth.Subject subject,
                                                                    org.rhq.core.domain.operation.OperationHistory history)

This is called by the jobs so they can update the history. The job will pass in an updated history object, this method just updates the database with the new data.

Every call to this method will trigger at least one check against the AlertConditionCacheManager. The first is against the passed history element itself, which captures the creation events (history element will be in the INPROGRESS state), as well as updated to ResourceOperationHistory elements (completed, failed, etc).

Furthermore, since ResourceOperationHistory elements are reused for execution of group operations, this method also checks to see if it is part of a larger group operation. If it is, and if it is the last member of that group to finish, the group status will be updated. This will trigger a second check against the AlertConditionCacheManager using that corresponding group history element.

Parameters:

subject - the user that the job is executing under

history - the history with the data to be updated. The history record will be created if id is set to 0. Otherwise the record must already exist and will be updated.

Returns:

the updated or newly created history

checkForCompletedGroupOperation

void checkForCompletedGroupOperation(int historyId)

This is, for all intents and purposes, and internal method. It should be called just after updating any OperationHistory element. To date, this includes two places: a) post-processing hook to updateOperationHistory(Subject whoami, OperationHistory history) b) embedded inside the logic for checkForTimedOutOperations(Subject) This method will perform the following logic: 1) checks whether the entity corresponding to the passed id is part of a larger GroupOperationHistory 2) if #1 is true, it will further check whether that entity was the last element from the group to complete 3) if #2 is true, it will perform the necessary logic to moving the associated GroupOperationHistory entity to the appropriate termination state

Parameters:

historyId - the integer id of the OperationHistory entity that needs to be checked

findSupportedResourceTypeOperations

List<org.rhq.core.domain.operation.OperationDefinition> findSupportedResourceTypeOperations(org.rhq.core.domain.auth.Subject subject,
                                                                                          int resourceTypeId,
                                                                                          boolean eagerLoaded)

Returns the definitions of all the operations supported by the given resource type.

Parameters:

subject -

resourceTypeId -

eagerLoaded - if true the parametersConfigurationDefinition, resultsConfigurationDefinition, and resourceType fields are eagerly loaded, otherwise they are left as null references

Returns:

the operation definitions for the resource type

findSupportedGroupOperations

List<org.rhq.core.domain.operation.OperationDefinition> findSupportedGroupOperations(org.rhq.core.domain.auth.Subject subject,
                                                                                   int compatibleGroupId,
                                                                                   boolean eagerLoaded)

Returns the definitions of all the operations supported by the given group.

Parameters:

subject -

compatibleGroupId -

eagerLoaded - if true the parametersConfigurationDefinition, resultsConfigurationDefinition, and resourceType fields are eagerly loaded, otherwise they are left as null references

Returns:

the operation definitions for the group

getSupportedResourceOperation

org.rhq.core.domain.operation.OperationDefinition getSupportedResourceOperation(org.rhq.core.domain.auth.Subject subject,
                                                                              int resourceId,
                                                                              String operationName,
                                                                              boolean eagerLoaded)

Returns the definition of the named operation supported by the given resource. If the operation is not valid for the resource, an exception is thrown.

Parameters:

subject -

resourceId -

operationName -

eagerLoaded - if true the parametersConfigurationDefinition, resultsConfigurationDefinition, and resourceType fields are eagerly loaded, otherwise they are left as null references

Returns:

the named operation definition for the resource

getSupportedGroupOperation

org.rhq.core.domain.operation.OperationDefinition getSupportedGroupOperation(org.rhq.core.domain.auth.Subject subject,
                                                                           int compatibleGroupId,
                                                                           String operationName,
                                                                           boolean eagerLoaded)

Returns the definition of the named operation supported by the given group. If the operation is not valid for the group, an exception is thrown.

Parameters:

subject -

compatibleGroupId -

operationName -

eagerLoaded - if true the parametersConfigurationDefinition, resultsConfigurationDefinition, and resourceType fields are eagerly loaded, otherwise they are left as null references

Returns:

the named operation definition for the group

isResourceOperationSupported

boolean isResourceOperationSupported(org.rhq.core.domain.auth.Subject subject,
                                   int resourceId)

Determines if the given resource has at least one operation.

Parameters:

subject -

resourceId -

Returns:

true if the resource has at least one operation

isGroupOperationSupported

boolean isGroupOperationSupported(org.rhq.core.domain.auth.Subject subject,
                                int resourceGroupId)

Determines if the given group has at least one operation.

Parameters:

subject -

resourceGroupId -

Returns:

true if the group has at least one operation

checkForTimedOutOperations

void checkForTimedOutOperations(org.rhq.core.domain.auth.Subject whoami)

Will check to see if any in progress operation jobs are taking too long to finish and if so marks their histories as failed. This method will be perodically called by the JON Server.

Calls to this method could trigger a number of checks against the AlertConditionCacheManager. The first set of checks would be against any and all resource operations that have timed out. Then, for any of these timeouts, since ResourceOperationHistory elements are reused for execution of group operations, this method also checks to see if it is part of a larger group operation. If it is, and if it is the last member of that group to finish, the group status will be updated. This will trigger another check against the AlertConditionCacheManager using that corresponding group history element.

Parameters:

whoami - only the overlord may execute this system operation

getLatestCompletedResourceOperation

@Nullable
org.rhq.core.domain.operation.ResourceOperationHistory getLatestCompletedResourceOperation(org.rhq.core.domain.auth.Subject subject,
                                                                                                  int resourceId)

Get the mostly recently run operation for the Resource with the given id, or null if the resource has had no operations performed against it yet (or if all previously performed operations have been deleted from the history). Returns the result of the operation as it is known on the server-side in the database.

Parameters:

subject - the user who wants to see the information

resourceId - a Resource id

Returns:

the most recent operation performed against the Resource with the given id, or null if the resource has had no operations performed against it yet.

getOldestInProgressResourceOperation

@Nullable
org.rhq.core.domain.operation.ResourceOperationHistory getOldestInProgressResourceOperation(org.rhq.core.domain.auth.Subject subject,
                                                                                                   int resourceId)

Get the oldest operation still in progress for the Resource with the given id, or null if the resource has no operations being performed against it. Returns the INPROCESS element with empty results.

Parameters:

subject - the user who wants to see the information

resourceId - a Resource id

Returns:

the oldest operation still in progress for the Resource with the given id, or null if the resource has no operations being performed against it.

getOperationDefinition

org.rhq.core.domain.operation.OperationDefinition getOperationDefinition(org.rhq.core.domain.auth.Subject subject,
                                                                       int operationId)

Get the OperationDefinition object that corresponds to this operationId

Parameters:

subject - the user who wants to see the information

operationId -

Returns:

the OperationDefinition object that corresponds to this operationId

getOperationDefinitionByResourceTypeAndName

org.rhq.core.domain.operation.OperationDefinition getOperationDefinitionByResourceTypeAndName(int resourceTypeId,
                                                                                            String operationName,
                                                                                            boolean eagerLoaded)
                                                                                              throws OperationDefinitionNotFoundException

Parameters:

resourceTypeId -

operationName -

eagerLoaded - if true the parametersConfigurationDefinition, resultsConfigurationDefinition, and resourceType fields are eagerly loaded, otherwise they are left as null references

Returns:

the operation definition

Throws:

OperationDefinitionNotFoundException

findRecentlyCompletedResourceOperations

org.rhq.core.domain.util.PageList<org.rhq.core.domain.operation.composite.ResourceOperationLastCompletedComposite> findRecentlyCompletedResourceOperations(org.rhq.core.domain.auth.Subject subject,
                                                                                                                                                         Integer resourceId,
                                                                                                                                                         org.rhq.core.domain.util.PageControl pc)

Gets a list of all recently completed resource operations. This is used to support the dashboard operations portlet. WARNING: Do not send in a page control that asks for an unlimited page list - depending on the number of operations in the system's history, that kind of request could blow up.

Only resource operations are returned (group operations are ignored by this method). However, if a group operation was executed, all of the resource executions that occurred as part of it will be returned (that is, the resources in that group will have its resource operations returned.

Parameters:

subject - the user asking for the data; the returned list is limited to what this user can see

resourceId - if non-null, will only result recent completed operations for this resource

pc - limits the number of composite objects returned

Returns:

the list of recently completed resource operations

findRecentlyCompletedGroupOperations

org.rhq.core.domain.util.PageList<org.rhq.core.domain.operation.composite.GroupOperationLastCompletedComposite> findRecentlyCompletedGroupOperations(org.rhq.core.domain.auth.Subject subject,
                                                                                                                                                   org.rhq.core.domain.util.PageControl pc)

Gets a list of all recently completed group operations. This is used to support the dashboard operations portlet. WARNING: Do not send in a page control that asks for an unlimited page list - depending on the number of operations in the system's history, that kind of request could blow up.

Parameters:

subject - the user asking for the data; the returned list is limited to what this user can see

pc - limits the number of composite objects returned

Returns:

the list of recently completed group operations

findCurrentlyScheduledResourceOperations

org.rhq.core.domain.util.PageList<org.rhq.core.domain.operation.composite.ResourceOperationScheduleComposite> findCurrentlyScheduledResourceOperations(org.rhq.core.domain.auth.Subject subject,
                                                                                                                                                     org.rhq.core.domain.util.PageControl pc)

Gets a list of all currently scheduled resource operations (that is, scheduled but not yet invoked and/or completed).

Parameters:

subject - the user asking for the data; the returned list is limited to what this user can see

pc - limits the number of composite objects returned

Returns:

the list of scheduled resource operations

findCurrentlyScheduledGroupOperations

org.rhq.core.domain.util.PageList<org.rhq.core.domain.operation.composite.GroupOperationScheduleComposite> findCurrentlyScheduledGroupOperations(org.rhq.core.domain.auth.Subject subject,
                                                                                                                                               org.rhq.core.domain.util.PageControl pc)

Gets a list of all currently scheduled group operations (that is, scheduled but not yet invoked and/or completed).

Parameters:

subject - the user asking for the data; the returned list is limited to what this user can see

pc - limits the number of composite objects returned

Returns:

the list of scheduled group operations

findCompletedResourceOperationHistories

org.rhq.core.domain.util.PageList<org.rhq.core.domain.operation.ResourceOperationHistory> findCompletedResourceOperationHistories(org.rhq.core.domain.auth.Subject subject,
                                                                                                                                int resourceId,
                                                                                                                                Long startDate,
                                                                                                                                Long endDate,
                                                                                                                                org.rhq.core.domain.util.PageControl pc)

Returns the list of completed operation histories for the given resource. This will return all items that are no longer INPROGRESS that were invoked as part of a group operation to which this resource belongs or on the resource directly.

Parameters:

subject -

resourceId -

startDate - filter used to show only results occurring after this epoch millis parameter, nullable

endDate - filter used to show only results occurring before this epoch millis parameter, nullable

pc -

Returns:

all operation histories for the given resource

findPendingResourceOperationHistories

org.rhq.core.domain.util.PageList<org.rhq.core.domain.operation.ResourceOperationHistory> findPendingResourceOperationHistories(org.rhq.core.domain.auth.Subject subject,
                                                                                                                              int resourceId,
                                                                                                                              org.rhq.core.domain.util.PageControl pc)

Returns the list of pending operation histories for the given resource. This will return all items that are still INPROGRESS that were invoked as part of a group operation to which this resource belongs or on the resource directly.

Parameters:

subject -

resourceId -

pc -

Returns:

all operation histories for the given resource

getOperationHistoryByHistoryId

org.rhq.core.domain.operation.OperationHistory getOperationHistoryByHistoryId(org.rhq.core.domain.auth.Subject subject,
                                                                            int historyId)

TODO

getOperationHistoryByJobId

org.rhq.core.domain.operation.OperationHistory getOperationHistoryByJobId(org.rhq.core.domain.auth.Subject subject,
                                                                        String historyJobId)

TODO

findSupportedResourceOperations

List<org.rhq.core.domain.operation.OperationDefinition> findSupportedResourceOperations(org.rhq.core.domain.auth.Subject subject,
                                                                                      int resourceId,
                                                                                      boolean eagerLoaded)

Returns the definitions of all the operations supported by the given resource.

Parameters:

subject -

resourceId -

eagerLoaded - if true the parametersConfigurationDefinition, resultsConfigurationDefinition, and resourceType fields are eagerly loaded, otherwise they are left as null references

Returns:

the operation definitions for the resource

purgeOperationHistory

int purgeOperationHistory(Date purgeBeforeTime)

Purge all operation history created before the specified time. Note that all ResourceOperationHIstory for an eligible GroupOperationHistory will be removed regardless of whether the resource-level history was created before the specified time.

In-Progress operation history is still purged, on the assumption that it is obsolete and possibly in a bad state.

Parameters:

purgeBeforeTime -

Returns:

the number of purged history records. GroupOperationHistory counts as 1 regardless of the number of associated ResourceOperationHistory records.

purgeOperationHistoryInNewTransaction

int purgeOperationHistoryInNewTransaction(Date purgeBeforeTime,
                                        boolean isGroupPurge,
                                        int limit)

This does the work of purgeOperationHistory(Date), targeting group or resource history, and limits transaction size by applying a limit to the number of history records purged. The records purged are not done in any order, any history meeting the purgeBeforeTime constraint is eligible.

Parameters:

purgeBeforeTime -

isGroupPurge -

limit -

Returns: