|
Oracle Fusion Applications Java API Reference for Oracle Enterprise Scheduler Service 11g Release 1 (11.1.2) E20742-02 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface RuntimeServiceMXBeanProxy
Remote management interface for the runtime service.
This interface is identical to RuntimeServiceMXBean except that these methods additionally throw java.io.IOEXception.
Field Summary | |
---|---|
static java.lang.String |
s_mbeanObjectNameString
|
static oracle.as.scheduler.management.ProtocolVersion |
s_protocolVersion
The local version information for this interface |
static java.lang.String |
s_shortName
|
Method Summary | |
---|---|
void |
addBinding(oracle.as.scheduler.management.Binding binding)
Adds a new binding, which binds a work assignment to a processor. |
void |
addBindings(java.util.List<oracle.as.scheduler.management.Binding> bindings)
Adds a list of new bindings. |
void |
cancelRequest(long requestId)
Cancels the processing of a request that is not in a terminal state. |
void |
changeBindingMode(MetadataObjectId bindingName,
boolean isExclusive)
Changes the mode of an existing binding. |
void |
changeRequestPriority(long requestId,
int priority)
Changes the priority for a submitted request that has not yet started to run. |
void |
cleanExecutionGroup(java.lang.String domainName,
java.lang.String clusterName)
Cleans up artifacts from an ESS execution group. |
void |
close(oracle.as.scheduler.management.QueryResultHandle handle)
Closes the handle returned by executeQueryRequests . |
void |
completeAsyncRequest(long requestId,
oracle.as.scheduler.async.AsyncStatus status,
java.lang.String statusMessage)
Complete an asynchronous request with the given status. |
void |
deleteRequest(long requestId)
Marks a request for deletion. |
oracle.as.scheduler.management.QueryResultHandle |
executeQueryRequests(Filter filter,
RuntimeService.QueryField orderBy,
boolean ascending)
Query requests whose attributes and properties match those specified by the fields in the filter. |
oracle.as.scheduler.management.QueryResultHandle |
executeQueryRequests(Filter filter,
RuntimeService.QueryField orderBy,
boolean ascending,
boolean includeProcessGroup)
Query requests whose attributes and properties match those specified by the fields in the filter. |
RequestDetail[] |
fetchQueryResults(oracle.as.scheduler.management.QueryResultHandle handle)
Retrieves request details for the requests that satisified the query performed by executeQueryRequests . |
RequestDetail[] |
fetchQueryResults(oracle.as.scheduler.management.QueryResultHandle handle,
int maxRows)
Retrieves request details for the requests that satisified the query performed by executeQueryRequests . |
java.util.List<oracle.as.scheduler.management.AppRegistrationInfo> |
getApplicationsInfo()
Retrieve application registration information for all applications in all servers for all process groups in this isolation group. |
java.util.List<oracle.as.scheduler.management.AppRegistrationInfo> |
getApplicationsInfo(boolean includeEssApp)
Retrieve application registration information for all applications in all servers for all process groups in this isolation group. |
java.util.List<oracle.as.scheduler.management.AsyncThrottle> |
getAsyncLimits(WorkAssignment workAssignment)
Gets the async limits for all workshifts of the given work assignment. |
java.util.List<oracle.as.scheduler.management.AsyncThrottle> |
getAsyncThrottle(MetadataObjectId waId)
Deprecated. Async limits are now associated with the workshift only. |
oracle.as.scheduler.management.AsyncThrottle |
getAsyncThrottle(MetadataObjectId waId,
MetadataObjectId wshiftId)
Deprecated. |
oracle.as.scheduler.management.AsyncThrottle |
getAsyncThrottleForWorkshift(MetadataObjectId wshiftId)
Deprecated. |
java.util.List<oracle.as.scheduler.management.Binding> |
getBindings()
Gets the processor bindings. |
long[] |
getBlockedRequests(long requestId)
Returns a list of request identifiers that are blocked by the given request. |
long[] |
getBlockingRequests(long requestId)
Returns a list of request identifiers that are blocking the given request. |
long[] |
getExecutingRequests()
Retrieve the requests currently executing on this instance. |
java.util.List<FailedExecutionResult> |
getFailedExecutionHistory(long requestId)
Retrieves all failed execution attempts for a request. |
java.util.List<oracle.as.scheduler.management.InactiveBinding> |
getInactiveBindings()
Gets the inactive bindings for the ESS instance. |
FailedExecutionResult |
getLastFailedExecution(long requestId)
Gets information on the last failed execution attempt for a request. |
oracle.as.scheduler.management.ProtocolVersion |
getProtocolVersion()
Returns remote version information for this interface |
long |
getQueryRequestsCount(oracle.as.scheduler.management.QueryResultHandle handle)
Returns return the number of requests that satisifed the query performed by executeQueryRequests . |
RequestDetail |
getRequestDetail(long requestId)
Gets the runtime details of the specified request. |
Diagnosis |
getRequestDiagnosis(long requestId)
Gets the diagnosis for the given request. |
long[] |
getRequests(long id)
Returns the requests identifiers for those requests that have the specified request as its immediate parent. |
java.lang.String |
getRequestState(long requestId)
Retrieves the current state of the specified request. |
oracle.as.scheduler.management.SpawnedJobDetail |
getSpawnedJobDetail(long requestId)
Retrieves job details for a process type (spawned) job request. |
SQLJobDetail |
getSQLJobDetail(long requestId)
Retrieves current database job details for a SQL job request. |
void |
holdRequest(long requestId)
Withholds further processing of a request that is in WAIT or READY state. |
RequestSummary[] |
queryApplicationRequests(State[] state,
java.lang.String processor)
Gets a summary of requests by application. |
javax.management.openmbean.TabularData |
queryCompletedRequestsDetail(java.lang.String application,
java.lang.String processor,
int deltaStart,
int deltaEnd,
long elapsed,
int maxCount,
java.util.Map<java.lang.String,java.lang.String> filterParamNameValues,
java.util.List<java.lang.String> returnParamNames)
Gets a map of requests that got completed within the specified start and end times. |
RequestSummary[] |
queryJobCompletedRequests(java.lang.String application,
java.lang.String processor,
CalendarWrapper start,
CalendarWrapper end,
long elapsed,
int count)
Gets a summary of requests by job or job set. |
RequestDetail[] |
queryLongRunningRequests(java.lang.String processor,
int count)
Gets the longest running requests reverse ordered by elapsed time, longest to shortest. |
javax.management.openmbean.TabularData |
queryLongRunningRequestsDetail(java.lang.String application,
java.lang.String processor,
int maxCount,
java.util.Map<java.lang.String,java.lang.String> filterParamNameValues,
java.util.List<java.lang.String> returnParamNames)
Gets a map of requests that are running for long by filtering as per the application and processor. |
javax.management.openmbean.TabularData |
queryReadyRequestsDetail(java.lang.String application,
java.util.Map<java.lang.String,java.lang.String> filterParamNameValues,
java.util.List<java.lang.String> returnParamNames)
Gets a list of requests details that are in ready state |
RequestSummary |
queryRequestSummary(long id)
Gets a summary for the request specified. |
RequestSummary[] |
queryRunningRequestsByProcessor(java.lang.String application)
Gets a summary of requests for each user reverse ordered according to number of requests, highest to lowest, by processor. |
RequestSummary[] |
querySnapshotDailyRequests(int month,
int year,
int day)
Gets a summary of requests for the day specified. |
RequestSummary[] |
querySnapshotMonthlyRequests(int month,
int year)
Gets a summary of requests for the month specified. |
RequestSummary[] |
querySnapshotWeeklyRequests(int month,
int year,
int week)
Gets a summary of requests for the week specified. |
RequestSummary[] |
queryUserCompletedRequests(java.lang.String application,
java.lang.String processor,
CalendarWrapper start,
CalendarWrapper end,
long minTotalElapsed,
int count)
Gets a summary of requests for each user reverse ordered according to number of requests, highest to lowest, for requests that have completed. |
RequestSummary[] |
queryUserRequests(java.lang.String application,
State[] state,
java.lang.String processor)
Gets a summary of requests for each user reverse ordered according to number of requests, highest to lowest. |
java.util.List<RequestDetail> |
queryWorkAssignmentReadyRequests(MetadataObjectId waMid)
Returns list of sparse request detail for the requests, in order of priority, that are in READY state and could be processed by the given work assignment. |
RequestSummary[] |
queryWorkAssignmentRequests(java.lang.String application,
java.lang.String processor,
CalendarWrapper start,
int count)
Gets a summary of requests by work assignment. |
void |
recoverRequest(long requestId)
Attempts to force a request to complete under certain conditions. |
void |
releaseRequest(long requestId)
Releases a request from the HOLD state. |
void |
removeBinding(MetadataObjectId bindingName)
Removes a processor binding. |
void |
removeBindings(java.util.List<MetadataObjectId> bindingNames)
Removes a list of processor bindings. |
void |
replaceSchedule(long requestId,
MetadataObjectId schedule)
Replace the current schedule for a request that has already been submitted. |
void |
replaceScheduleAdhoc(long requestId,
Schedule schedule)
Replace the current schedule for a request that has already been submitted. |
void |
replaceScheduleStartEnd(long requestId,
MetadataObjectId schedule,
Schedule adhocSchedule,
CalendarWrapper start,
CalendarWrapper end)
Replace the current schedule for a request that has already been submitted with a schedule. |
void |
setRequestParameter(long requestId,
java.lang.String name,
PropertyValue value)
Sets the value of a request parameter for a specified request. |
long |
submitAdHocRequest(java.lang.String desc,
JobType.ExecutionType type,
Schedule schedule,
Trigger trigger,
CalendarWrapper start,
CalendarWrapper end,
RequestParameters parameters)
Adhoc job request submission using specified Schedule and Trigger instances. |
long |
submitBatchDeleteRequest(java.lang.String desc,
CalendarWrapper start,
RequestParameters parameters)
Submits a request for a batch delete job. |
long |
submitBatchDeleteRequest(java.lang.String desc,
MetadataObjectId scheduleMetaId,
Schedule adhocSchedule,
CalendarWrapper start,
CalendarWrapper end,
RequestParameters parameters)
Submits a request for a batch delete job. |
long |
submitPartAdHocRequest(java.lang.String desc,
MetadataObjectId definition,
Schedule schedule,
Trigger trigger,
CalendarWrapper start,
CalendarWrapper end,
RequestParameters parameters)
Job request submission using Job Definition predefined in Metadata, and adhoc Schedule and Trigger instances. |
long |
submitRequest(java.lang.String desc,
MetadataObjectId definition,
CalendarWrapper start,
RequestParameters parameters)
Submits a new job request using metadata definition of the job to run once at the specified time. |
long |
submitRequest(java.lang.String desc,
MetadataObjectId definition,
MetadataObjectId schedule,
MetadataObjectId trigger,
CalendarWrapper start,
CalendarWrapper end,
RequestParameters parameters)
Submits a new job request using metadata definitions of the job, schedule and associated trigger. |
void |
updateAsyncThrottle(oracle.as.scheduler.management.AsyncThrottle throttle)
Deprecated. Async limits are now defined on the workshift. |
void |
updateAsyncThrottle(java.util.List<oracle.as.scheduler.management.AsyncThrottle> throttles)
Deprecated. Async limits are now defined on the workshift. |
void |
updateRequestProperty(long requestId,
java.lang.String name,
PropertyValue value)
Updates the value of a request parameter for a request. |
void |
updateRequestStartEnd(long requestId,
CalendarWrapper start,
CalendarWrapper end)
Replace the start and end time for a request that has already been submitted. |
Field Detail |
---|
static final oracle.as.scheduler.management.ProtocolVersion s_protocolVersion
static final java.lang.String s_shortName
static final java.lang.String s_mbeanObjectNameString
Method Detail |
---|
oracle.as.scheduler.management.ProtocolVersion getProtocolVersion() throws java.io.IOException
java.io.IOException
- if a protocol error occurslong submitRequest(java.lang.String desc, MetadataObjectId definition, CalendarWrapper start, RequestParameters parameters) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.InvalidAttributeValueException, javax.management.RuntimeOperationsException
desc
- description for the request.definition
- the name of a job definition or job set to
use from metadata.start
- the time at which the request must be started.parameters
- request parameters.
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if any metadata specified for this
operation was not found in the metadata repository.
javax.management.InvalidAttributeValueException
- if the request validation failed.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.long submitRequest(java.lang.String desc, MetadataObjectId definition, MetadataObjectId schedule, MetadataObjectId trigger, CalendarWrapper start, CalendarWrapper end, RequestParameters parameters) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.InvalidAttributeValueException, javax.management.RuntimeOperationsException
desc
- description for the request.definition
- the name of a job definition or job set to
use from metadata.schedule
- the name of the job schedule to use from metadata.trigger
- the name of job trigger to use from metadatastart
- the start time from which the requests must be started.
The start time applies to both Schedule and Trigger if present.end
- the end time until which the request should run. The end
time applies to both the Schedule and Trigger definitions is specified.parameters
- request parameters.
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if any metadata specified for
this operation was not found in the metadata repository.
javax.management.InvalidAttributeValueException
- if the request validation failed.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.long submitAdHocRequest(java.lang.String desc, JobType.ExecutionType type, Schedule schedule, Trigger trigger, CalendarWrapper start, CalendarWrapper end, RequestParameters parameters) throws java.io.IOException, javax.management.InvalidAttributeValueException, javax.management.RuntimeOperationsException
desc
- description for the request.type
- must be one of the base types values viz. JAVA_TYPE,
SQL_TYPE and PROCESS_TYPE specified by JobType
enum.schedule
- instance of schedule objecttrigger
- the instance of Trigger objectstart
- the start time from which the requests must be started.
The start time applies to both Schedule and Trigger if present.end
- the end time until which the request should run. The end
time applies to both the Schedule and Trigger definitions is specified.parameters
- additional request parameters specified a
part of the request.
java.io.IOException
- if a protocol error occurred.
javax.management.InvalidAttributeValueException
- if the request validation failed.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.long submitPartAdHocRequest(java.lang.String desc, MetadataObjectId definition, Schedule schedule, Trigger trigger, CalendarWrapper start, CalendarWrapper end, RequestParameters parameters) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.InvalidAttributeValueException, javax.management.RuntimeOperationsException
desc
- description for the request.definition
- the name of a job definition or job set to
use from metadata.schedule
- instance of schedule objecttrigger
- the instance of Trigger objectstart
- the start time from which the requests must be started.
The start time applies to both Schedule and Trigger if present.end
- the end time until which the request should run. The end
time applies to both the Schedule and Trigger definitions is specified.parameters
- additional request parameters specified a
part of the request.
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if any metadata specified for
this operation was not found in the metadata repository.
javax.management.InvalidAttributeValueException
- if the request validation failed.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.void updateRequestProperty(long requestId, java.lang.String name, PropertyValue value) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.InvalidAttributeValueException, javax.management.RuntimeOperationsException
This operation fails if the request parameter does not already exist.
This operation is subject to any read-only constraint on the parameter being updated and an error occurs if the parameter is read-only.
This operation applies to only the target request. It does not cascade to any other requests that may be associated with the request.
requestId
- the request identifier of the request being updatedname
- the name of the parameter to modify.value
- the new value of the parameter
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if the request was not found
javax.management.InvalidAttributeValueException
- if parameter validation fails.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.void setRequestParameter(long requestId, java.lang.String name, PropertyValue value) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.InvalidAttributeValueException, javax.management.RuntimeOperationsException
The parameter will be added if it does not already exist, otherwise the value of the parameter will be updated.
This operation is subject to any read-only constraint on the parameter being set and an error occurs if the parameter already exists and is read-only.
This operation applies to only the target request. It does not cascade to any other requests that may be associated with the request.
requestId
- the request identifier of the request being updatedname
- the name of the parameter to set.value
- the new value of the parameter
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if the request was not found
javax.management.InvalidAttributeValueException
- if parameter validation fails.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.java.lang.String getRequestState(long requestId) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.RuntimeOperationsException
requestId
- the request identifier of the request
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if the request was not found
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.long[] getRequests(long id) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.RuntimeOperationsException
id
- the request identifier of the target request.
requestId
as the immediate parent.
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if the request was not found.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.RequestDetail getRequestDetail(long requestId) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.RuntimeOperationsException
requestId
- the request identifier of the request
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if the request was not found
or if any metadata referenced for this operation was not found in
the metadata repository.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.oracle.as.scheduler.management.QueryResultHandle executeQueryRequests(Filter filter, RuntimeService.QueryField orderBy, boolean ascending) throws java.io.IOException, javax.management.InvalidAttributeValueException, javax.management.RuntimeOperationsException
The method provides the block-fetch mechanism for querying requests.
It returns an handle to the results. This handle must then be used in
subsequent calls to fetchQueryResults
to fetch the desired
number of rows. getQueryRequestsCount
can be used to determine
the number of requests returned by the query.
The runtime subsystem might close the handle if it is not used for a long time in order to release associated resources.
filter
- contains field/comparator/value combinations
used as parameters for retrieving query results.orderBy
- field based on which the results will be sorted.ascending
- flag indicating whether the ordering based on the
given field should be ascending or descending.
java.io.IOException
- if a protocol error occurred.
javax.management.InvalidAttributeValueException
- if filter parameter validation
fails.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.oracle.as.scheduler.management.QueryResultHandle executeQueryRequests(Filter filter, RuntimeService.QueryField orderBy, boolean ascending, boolean includeProcessGroup) throws java.io.IOException, javax.management.InvalidAttributeValueException, javax.management.RuntimeOperationsException
The method provides the block-fetch mechanism for querying requests.
It returns an handle to the results. This handle must then be used in
subsequent calls to fetchQueryResults
to fetch the desired
number of rows. getQueryRequestsCount
can be used to determine
the number of requests returned by the query.
The runtime subsystem might close the handle if it is not used for a long time in order to release associated resources.
filter
- contains field/comparator/value combinations
used as parameters for retrieving query results.orderBy
- field based on which the results will be sorted.ascending
- flag indicating whether the ordering based on the
given field should be ascending or descending.includeProcessGroup
- flag indicating whether the processGroup
should be included in the search scope or not.
java.io.IOException
- if a protocol error occurred.
javax.management.InvalidAttributeValueException
- if filter parameter validation
fails.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.long getQueryRequestsCount(oracle.as.scheduler.management.QueryResultHandle handle) throws java.io.IOException, javax.management.RuntimeOperationsException
executeQueryRequests
.
handle
- instance of handle returned by a prior call to
executeQueryRequests
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.RequestDetail[] fetchQueryResults(oracle.as.scheduler.management.QueryResultHandle handle) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.RuntimeOperationsException
executeQueryRequests
.
This method returns information for all remaining requests that
satisified the query. If this the first fetch method called after
executeQueryRequests
then all requests are returned and
subsequent fetches will return no additional information.
The method returns an array of sparse RequestDetail
objects
that contain only few key attributes and proporties. The full details
for a given request can be obtained by calling getRequestDetail
.
The runtime subsystem might close the handle if it is not used for a long time in order to release associated resources.
handle
- instance of handle returned by a prior call to
executeQueryRequests
RequestDetail
objects. An empty
array is returned if there is no request information to be returned.
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if the requests was not found.
javax.management.RuntimeOperationsException
- due to runtime subsystem failureRequestDetail[] fetchQueryResults(oracle.as.scheduler.management.QueryResultHandle handle, int maxRows) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.RuntimeOperationsException
executeQueryRequests
.
The method returns a given number of requests (block-fetch) as specified
by maxRows
. The retrieval of the requests is done in sequential
fashion until the requests that satisified the query are returned.
The method returns an array of sparse RequestDetail
objects
that contain only few key attributes and proporties. The full details
for a given request can be obtained by calling getRequestDetail
.
The runtime subsystem might close the handle if it is not used for a long time in order to release associated resources.
handle
- instance of handle returned by a prior call to
executeQueryRequests
maxRows
- maximum number of requests to be returned. If the
number of remaining requests is less than this value, then only those
requests are returned. If value is zero, then information for all
remaining requests that satisified the query is returned.
RequestDetail
objects. An empty
array is returned if there is no request information to be returned.
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if the requests was not found.
javax.management.RuntimeOperationsException
- due to runtime subsystem failurevoid close(oracle.as.scheduler.management.QueryResultHandle handle) throws java.io.IOException, javax.management.RuntimeOperationsException
executeQueryRequests
.
Once the handle is closed it cannot be used by to retrieve information
about the query.
handle
- instance of handle to be closed
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs or handle
is null.void holdRequest(long requestId) throws java.io.IOException, javax.management.InstanceNotFoundException, java.lang.IllegalStateException, javax.management.OperationsException, javax.management.RuntimeOperationsException
requestId
- of request to hold.
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if the request was not found.
java.lang.IllegalStateException
- if request is not in a
compatible state.
javax.management.OperationsException
- if this operation is not allowed on the
specified request.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.void releaseRequest(long requestId) throws java.io.IOException, javax.management.InstanceNotFoundException, java.lang.IllegalStateException, javax.management.OperationsException, javax.management.RuntimeOperationsException
requestId
- the request identifier of the request
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if the request was not found.
java.lang.IllegalStateException
- if request is not in a
compatible state.
javax.management.OperationsException
- if this operation is not allowed on the
specified request.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.void cancelRequest(long requestId) throws java.io.IOException, java.lang.IllegalStateException, javax.management.InstanceNotFoundException, javax.management.RuntimeOperationsException
For a singleton and child request in WAIT
, READY
,
BLOCKED
or HOLD
state, this operation will cause
them to go to CANCELLED
state.
For a singleton and child request in RUNNING
or
COMPLETED
state, cancellation is best effort and the
state will go to a transitory CANCELLING
state which will
persist until the request has been cancelled and transitions to
CANCELLED
or some other terminal state.
For parent requests, this operation cascades to all its children.
requestId
- the request identifier of the request
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if the request was not found.
java.lang.IllegalStateException
- if request is already in a
terminal state.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.void deleteRequest(long requestId) throws java.io.IOException, javax.management.InstanceNotFoundException, java.lang.IllegalStateException, javax.management.OperationsException, javax.management.RuntimeOperationsException
The target request must be a submitted request that has finished and is in a terminal state. An error occurs if the target request is not in a terminal state, or if it is a child request of some kind, for example, a JobSet step, a sub-request, a Schedule instance request, or Trigger instance request.
This does not physically remove request data, although the request will no longer be accessible (visible) for most operations.
requestId
- the request identifier of the request
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if the request was not found.
java.lang.IllegalStateException
- if the operation cannot be
performed
due to the current state of the request.
javax.management.OperationsException
- the this operation is not supported for
the request.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.RequestDetail[] queryLongRunningRequests(java.lang.String processor, int count) throws java.io.IOException, javax.management.RuntimeOperationsException
processor
- by mid-tier instance name that processed the request,
or null for all.count
- number of results to return.
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- due to runtime subsystem failureRequestSummary[] queryUserRequests(java.lang.String application, State[] state, java.lang.String processor) throws java.io.IOException, javax.management.RuntimeOperationsException
application
- for the specified application or null for
all applications.state
- array of State. Requests for the given states
(only) will be selected. If null, then requests in the default states
will be selected: running, success, error, warning, cancelled.processor
- the name of processing node for which
to return the result, null for all.
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- due to runtime subsystem failurefor applicable states.
RequestSummary[] queryUserCompletedRequests(java.lang.String application, java.lang.String processor, CalendarWrapper start, CalendarWrapper end, long minTotalElapsed, int count) throws java.io.IOException, javax.management.RuntimeOperationsException
application
- for the specified application or null for
all applications.processor
- the name of processing node for which
to return the result, null for all.start
- the start time of the request.end
- the end time of the request.minTotalElapsed
- the minimum total (cumulative) elapsed time
in seconds for completed requests by user that should be used to
filter out the result. A value of 0 indicates all results should
be returned.count
- number of results to return. A value of 0 indicates all
results should be returned.
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- due to runtime subsystem failurejavax.management.openmbean.TabularData queryCompletedRequestsDetail(java.lang.String application, java.lang.String processor, int deltaStart, int deltaEnd, long elapsed, int maxCount, java.util.Map<java.lang.String,java.lang.String> filterParamNameValues, java.util.List<java.lang.String> returnParamNames) throws java.io.IOException, javax.management.RuntimeOperationsException
application
- application for the specified application or null for
all applicationsprocessor
- processor the name of processing node for which
to return the result, null for all.deltaStart
- start time of the request relative to cuttent timedeltaEnd
- end time of the request relative to cuttent timeelapsed
- the elapsed time in milliseconds for completed requests
by user that should be used to filter out the result.
A value of 0 indicates all results should be returned.maxCount
- count number of results to return.
A value of 0 indicates all results should be returned.filterParamNameValues
- map with name-value pair of parameters to
filter the requestsreturnParamNames
- list of parameter names to return with the
resultset
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- due to runtime subsystem failurejavax.management.openmbean.TabularData queryLongRunningRequestsDetail(java.lang.String application, java.lang.String processor, int maxCount, java.util.Map<java.lang.String,java.lang.String> filterParamNameValues, java.util.List<java.lang.String> returnParamNames) throws java.io.IOException, javax.management.RuntimeOperationsException
application
- application for the specified application or null for
all applicationsprocessor
- processor the name of processing node for which
to return the result, null for all.maxCount
- count number of results to return.
A value of 0 indicates all results should be returned.filterParamNameValues
- map with name-value pair of parameters to
filter the requestsreturnParamNames
- list of parameter names to return with the
resultset
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- due to runtime subsystem failurejavax.management.openmbean.TabularData queryReadyRequestsDetail(java.lang.String application, java.util.Map<java.lang.String,java.lang.String> filterParamNameValues, java.util.List<java.lang.String> returnParamNames) throws java.io.IOException, javax.management.RuntimeOperationsException
The result list will have set of maps containing the information about that request.
application
- application for the specified application or null for
all applicationsfilterParamNameValues
- map with name-value pair of parameters to
filter the requestsreturnParamNames
- list of parameter names to return with the
resultset
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- due to runtime subsystem failureRequestSummary[] queryRunningRequestsByProcessor(java.lang.String application) throws java.io.IOException, javax.management.RuntimeOperationsException
application
- for the specified application or null for
all applications.
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- due to runtime subsystem failureRequestSummary[] queryApplicationRequests(State[] state, java.lang.String processor) throws java.io.IOException, javax.management.RuntimeOperationsException
state
- array of State. Requests for the given states
(only) will be selected. If null, then requests in the default states
will be selected: running, success, error, warning, cancelled.processor
- the name of processing node for which
to return the result, null for all.
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- due to runtime subsystem failurefor applicable states.
RequestSummary[] queryJobCompletedRequests(java.lang.String application, java.lang.String processor, CalendarWrapper start, CalendarWrapper end, long elapsed, int count) throws java.io.IOException, javax.management.RuntimeOperationsException
application
- for the specified application or null for
all applications.processor
- the name of processing node for which
to return the result, null for all.start
- requests that completed after, null for all.end
- requests that completed before, null for all.elapsed
- requests with elapsed time in seconds
greater than, zero for all.count
- maximum number of results to return.
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- due to runtime subsystem failureRequestSummary[] queryWorkAssignmentRequests(java.lang.String application, java.lang.String processor, CalendarWrapper start, int count) throws java.io.IOException, javax.management.RuntimeOperationsException
application
- name, null for all.processor
- name, null for all.start
- requests that completed after. Used for restricting the
result to most recent requests. null for all.count
- maximum number of results to return.
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- due to runtime subsystem failureRequestSummary[] querySnapshotMonthlyRequests(int month, int year) throws java.io.IOException, javax.management.RuntimeOperationsException
month
- in year (1-12)year
-
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- due to runtime subsystem failureRequestSummary[] querySnapshotWeeklyRequests(int month, int year, int week) throws java.io.IOException, javax.management.RuntimeOperationsException
month
- in year (1-12)year
- week
- in month (1-6)
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- due to runtime subsystem failureRequestSummary[] querySnapshotDailyRequests(int month, int year, int day) throws java.io.IOException, javax.management.RuntimeOperationsException
month
- in year (1-12)year
- day
- (1-31)
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- due to runtime subsystem failureRequestSummary queryRequestSummary(long id) throws java.io.IOException, javax.management.RuntimeOperationsException
id
- request identifier
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- due to runtime subsystem failureSQLJobDetail getSQLJobDetail(long requestId) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.RuntimeOperationsException
This returns null if no database details are available. For example, if no information is available for the for the Oracle Scheduler job associated with the ESS request. That might occur if the Scheduler job has not yet been submitted, or the Scheduler job has completed and no information is available from Scheduler views.
requestId
- the ESS request identifier
java.io.IOException
- if a protocol error occurs
javax.management.InstanceNotFoundException
- if the request was not found or
if any metadata referenced for this operation was not found in the
metadata repository.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occursoracle.as.scheduler.management.SpawnedJobDetail getSpawnedJobDetail(long requestId) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.RuntimeOperationsException
This returns null if no job details are available. That might occur if the process has not yet been created.
requestId
- the ESS request identifier
java.io.IOException
- if a protocol error occurs
javax.management.InstanceNotFoundException
- if the request was not found
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurslong[] getBlockedRequests(long requestId) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.RuntimeOperationsException
Requests get blocked only if they are defined to be incompatible with each other and cannot run together.
requestId
- the identifer of the request that might be blocking
some other requests. Such a given request must be in RUNNING state.
java.io.IOException
- if a protocol error occurs.
javax.management.InstanceNotFoundException
- if target request was not found.
javax.management.RuntimeOperationsException
- if runtime service errorlong[] getBlockingRequests(long requestId) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.RuntimeOperationsException
Requests get blocked only if they are defined to be incompatible with each other and cannot run together.
requestId
- the identifer of the request that is blocked by other
requests. Such a given request must be in BLOCKED state.
java.io.IOException
- if a protocol error occurs.
javax.management.InstanceNotFoundException
- if target request was not found.
javax.management.RuntimeOperationsException
- if runtime service errorvoid changeRequestPriority(long requestId, int priority) throws java.io.IOException, javax.management.InvalidAttributeValueException, javax.management.InstanceNotFoundException, javax.management.RuntimeOperationsException
This can be used to change the priority for a request that is in
WAIT
, READY
, HOLD
state.
The request priority will be changed even if it is read-only parameter for the request and normally not subject to be changed by the user.
requestId
- the request identifier of the target requestpriority
- the new request priority value. Value can range
from zero (highest) to nine (lowest).
java.io.IOException
- if a protocol error occurs.
javax.management.InvalidAttributeValueException
- if a validation error occurs.
For example, if the priority is not valid; or the request that cannot
be changed due to it being in an unsupported state for the operation.
javax.management.InstanceNotFoundException
- if the request was not found.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem
failure occursvoid replaceScheduleAdhoc(long requestId, Schedule schedule) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.InvalidAttributeValueException, javax.management.RuntimeOperationsException
The new schedule is an adhoc schedule. The old schedule could have been a metadata schedule or an adhoc schedule.
This can be used to replace the schedule for a request that is in
WAIT
or HOLD
state.
All previously scheduled instances of this request that have not started running will be canceled. The new schedule will be effective immediately for scheduling new instances.
requestId
- the request whose schedule is to be
replaced. This request must be a submitted request, not a
generated request.schedule
- the new schedule to use for this request
java.io.IOException
- if a protocol error occurs.
javax.management.InstanceNotFoundException
- if requestId
was not found.
javax.management.InvalidAttributeValueException
- if the schedule is not valid or if
requestId
is not for a submitted request or represents a
request in an unsupported state for the operation.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem
failure occursvoid replaceSchedule(long requestId, MetadataObjectId schedule) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.InvalidAttributeValueException, javax.management.RuntimeOperationsException
The new schedule will be a schedule obtained from the metadata of the application that submitted the request. The old schedule could have been a metadata schedule or an adhoc schedule.
This can be used to replace the schedule for a request that is in
WAIT
or HOLD
state.
All previously scheduled instances of this request that have not started running will be canceled. The new schedule will be effective immediately for scheduling new instances.
requestId
- the request whose schedule is to be replaced.
This request must be a submitted request, not a generated request.schedule
- a MetadataObjectId
representing the new
schedule to use for this request
java.io.IOException
- if a protocol error occurs.
javax.management.InstanceNotFoundException
- if requestId
was not found.
javax.management.InvalidAttributeValueException
- if the schedule is not valid or
if requestId
is not for a submitted request or represents a
request in an unsupported state for the operation.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem
failure occursvoid replaceScheduleStartEnd(long requestId, MetadataObjectId schedule, Schedule adhocSchedule, CalendarWrapper start, CalendarWrapper end) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.InvalidAttributeValueException, javax.management.RuntimeOperationsException
The new schedule will be a schedule obtained from the metadata of the application that submitted the request or an adhoc schedule. The old schedule could have been a metadata schedule or an adhoc schedule. This operation cannot be invoked on a singleton request that only had a start time and no other schedule.
Either scheduleId
or schedule
must be specified.
See updateRequestStartEnd(long, oracle.as.scheduler.CalendarWrapper, oracle.as.scheduler.CalendarWrapper)
.
This can be used to replace the schedule for a request that is in
WAIT
or HOLD
state.
All previously scheduled instances of this request that have not started running will be canceled. The new schedule will be effective immediately for scheduling new instances.
This operation acquires a lock for the given request.
The lock is released when close
operation is subsequently
invoked or the encompassing transaction is committed.
If an application tries to invoke this operation while the lock is being held by another thread, this method will block until the lock is released.
requestId
- the request whose schedule is to be replaced.
This request must be a submitted request, not a generated request.schedule
- a MetadataObjectId
representing the new
schedule to use for this requestadhocSchedule
- the new schedule to use for this requeststart
- the new requested start time for the request. The request
will not run prior to this time. If null
, the current
time will be used. If the request is meant to begin
immediately, null
should be specified.end
- the time past which this request or its child
requests will not be dispatched for execution. If null
,
no end time is in effect.
javax.management.InvalidAttributeValueException
- if both schedule
and
adhocSchedule
are null
, the schedule is not valid or
if requestId
is not for a submitted request or
represents a request in an unsupported state for the operation.
javax.management.InstanceNotFoundException
- if requestId
was not found or
if the schedule metadata specified for this operation was not found
in the metadata repository.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem
failure occurs
java.io.IOException
void updateRequestStartEnd(long requestId, CalendarWrapper start, CalendarWrapper end) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.InvalidAttributeValueException, javax.management.RuntimeOperationsException
This method should may be invoked for submitted requests
whether or not they not have an associated schedule or
trigger. If a schedule or trigger is associated with the
request and it is to be changed, please see replaceSchedule(long, oracle.as.scheduler.MetadataObjectId)
.
If no schedule or trigger is associated with the request note that
end
has very little meaning. It is only used in validation
to ensure that it does not come before start
.
This operation acquires a lock for the given request.
The lock is released when close
operation is subsequently
invoked or the encompassing transaction is committed.
If an application tries to invoke this operation while the lock is being held by another thread, this method will block until the lock is released.
requestId
- the request whose schedule is to be replaced.
This request must be a submitted request, not a generated request.start
- the new requested start time for the request. The request
will not run prior to this time. If null
, the current
time will be used. If the request is meant to begin
immediately, null
should be specified.end
- the time past which this request or its child
requests will not be dispatched for execution. If null
,
no end time is in effect.
java.io.IOException
javax.management.InstanceNotFoundException
javax.management.InvalidAttributeValueException
javax.management.RuntimeOperationsException
void addBinding(oracle.as.scheduler.management.Binding binding) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.InstanceAlreadyExistsException, javax.management.InvalidAttributeValueException, javax.management.RuntimeOperationsException
binding
- new binding to add
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if any metadata specified for this
operation was not found in the metadata repository.
javax.management.InvalidAttributeValueException
- if the binding validation failed,
due to either invalid metadata or invalid binding mode.
javax.management.InstanceAlreadyExistsException
- if the binding already exists.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.void addBindings(java.util.List<oracle.as.scheduler.management.Binding> bindings) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.InstanceAlreadyExistsException, javax.management.InvalidAttributeValueException, javax.management.RuntimeOperationsException
bindings
- list of bindings to add
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if any metadata specified for this
operation was not found in the metadata repository.
javax.management.InvalidAttributeValueException
- if the binding validation failed,
due to either invalid metadata or invalid binding mode.
javax.management.InstanceAlreadyExistsException
- if the binding already exists.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.void removeBinding(MetadataObjectId bindingName) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.RuntimeOperationsException
bindingName
- metadata id of the bound work assignment
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.
javax.management.InstanceNotFoundException
void removeBindings(java.util.List<MetadataObjectId> bindingNames) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.RuntimeOperationsException
bindingNames
- list of metadata ids of bound work assignments
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if the binding is not found.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.void changeBindingMode(MetadataObjectId bindingName, boolean isExclusive) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.InvalidAttributeValueException, javax.management.RuntimeOperationsException
bindingName
- name of the binding to changeisExclusive
- true
if the binding mode should be set to
exclusive; false
if the binding mode should be set to standard.
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if the binding was not found.
javax.management.InvalidAttributeValueException
- if the binding mode is invalid.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.java.util.List<oracle.as.scheduler.management.Binding> getBindings() throws java.io.IOException, javax.management.RuntimeOperationsException
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.long[] getExecutingRequests() throws java.io.IOException, javax.management.RuntimeOperationsException
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.void recoverRequest(long requestId) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.OperationsException, javax.management.RuntimeOperationsException
1. The request must already by in a terminal state or in State.CANCELLING
. If a request is in another state,
RuntimeService.cancel
must be called first. If the
request does not eventually transition to State.CANCELLED
,
then this operation may be invoked on the request.
2. All child requests of the given request must already be complete.
A completed> request is a request in a terminal state with
a process phase of ProcessPhase.Complete
.
Note that this operation will lock the request.
requestId
- the request identifier of the request.
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if the request is not found
javax.management.OperationsException
- if the given request has child requests
that are not complete.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.void completeAsyncRequest(long requestId, oracle.as.scheduler.async.AsyncStatus status, java.lang.String statusMessage) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.OperationsException, javax.management.RuntimeOperationsException
State.ERROR_MANUAL_RECOVERY
. The caller must make sure the
remote job is no longer executing before invoking this
operation with a terminal status. The status
is
used to transition the request to the appropriate state. Updatable.onEvent
is not invoked during this operation.
requestId
- the request identifier of the requeststatus
- the asynchronous status. Note that AsyncStatus.UPDATE
will result in nothing being done.statusMessage
- An error message if the status is ERROR or
BIZ_ERROR, a warning message if the status is WARNING,
the paused state if the status is PAUSED.
The value will be ignored if the status is SUCCESS, CANCEL, or UPDATE.
javax.management.InstanceNotFoundException
- if the requestId
is not found
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.
javax.management.OperationsException
- if the request is not asynchronous
or is not in the correct state or process phase.
java.io.IOException
Diagnosis getRequestDiagnosis(long requestId) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.RuntimeOperationsException
requestId
- request to diagnose
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if the request is not found
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.FailedExecutionResult getLastFailedExecution(long requestId) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.RuntimeOperationsException
requestId
- id of request that failed
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if the request is not found, or
if no failed execution history was found for the request,
meaning the request has not been retried.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.java.util.List<FailedExecutionResult> getFailedExecutionHistory(long requestId) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.RuntimeOperationsException
requestId
- id of request that failed
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if the request is not found
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.java.util.List<RequestDetail> queryWorkAssignmentReadyRequests(MetadataObjectId waMid) throws java.io.IOException, javax.management.InvalidAttributeValueException, javax.management.RuntimeOperationsException
READY
state and could be processed by the given work assignment.
javax.management.InvalidAttributeValueException
- if the work assignment is not
bound on this instance.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.
java.io.IOException
long submitBatchDeleteRequest(java.lang.String desc, CalendarWrapper start, RequestParameters parameters) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.InvalidAttributeValueException, javax.management.RuntimeOperationsException
desc
- description for the requeststart
- the time at which the request is to be started.
If null, the request will be start immediately.parameters
- the request parameters
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if any metadata specified for this
operation was not found in the metadata repository.
javax.management.InvalidAttributeValueException
- if the request validation failed.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.long submitBatchDeleteRequest(java.lang.String desc, MetadataObjectId scheduleMetaId, Schedule adhocSchedule, CalendarWrapper start, CalendarWrapper end, RequestParameters parameters) throws java.io.IOException, javax.management.InstanceNotFoundException, javax.management.InvalidAttributeValueException, javax.management.RuntimeOperationsException
Either a metadata Schedule or adhoc Schedule can be given. This fails
if both scheduleMetaId
and adhocSchedule
are non-null.
If a metadata schedule is used, the Schedule metadata must be in the
metadata repository configured for ESSAPP.
desc
- description for the requestscheduleMetaId
- the metadata object id of the schedule to useadhocSchedule
- the adhoc schedule to usestart
- the time at which the request is to be startedend
- the end time past which the request should not run.parameters
- the request parameters
java.io.IOException
- if a protocol error occurred.
javax.management.InstanceNotFoundException
- if any metadata specified for this
operation was not found in the metadata repository.
javax.management.InvalidAttributeValueException
- if the request validation failed.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.@Deprecated void updateAsyncThrottle(oracle.as.scheduler.management.AsyncThrottle throttle) throws java.io.IOException, javax.management.RuntimeOperationsException
throttle
- object that specifies the limits
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.@Deprecated void updateAsyncThrottle(java.util.List<oracle.as.scheduler.management.AsyncThrottle> throttles) throws java.io.IOException, javax.management.RuntimeOperationsException
throttles
- list of objects that specify the limits
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.@Deprecated oracle.as.scheduler.management.AsyncThrottle getAsyncThrottleForWorkshift(MetadataObjectId wshiftId) throws java.io.IOException, javax.management.RuntimeOperationsException
wshiftId
- metadata id of the workshift to get the async
throttle infor for.
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.java.util.List<oracle.as.scheduler.management.AsyncThrottle> getAsyncLimits(WorkAssignment workAssignment) throws javax.management.RuntimeOperationsException
workAssignment
- work assignment object to use.
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.@Deprecated oracle.as.scheduler.management.AsyncThrottle getAsyncThrottle(MetadataObjectId waId, MetadataObjectId wshiftId) throws java.io.IOException, javax.management.RuntimeOperationsException
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.@Deprecated java.util.List<oracle.as.scheduler.management.AsyncThrottle> getAsyncThrottle(MetadataObjectId waId) throws javax.management.RuntimeOperationsException
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.void cleanExecutionGroup(java.lang.String domainName, java.lang.String clusterName) throws javax.management.OperationsException, javax.management.RuntimeOperationsException
recoverRequest
. After all such requests
are complete, the ESS hosted applications should be undeployed.
If for some reason, the above steps were not taken, then this operation can do the following. 1. Terminate all requests in the execution group. Requests that are not in a terminal state are transitioned to CANCELLED. All incompatibility locks are released and other cleanup occurs. 2. Application registration entries are removed for the execution group. 3. ESS instance registration entries are removed for the execution group. An execution group is based on a particular cluster or server. If the server/cluster has been removed
domainName
- the name of the domain in which the execution group to
remove residesclusterName
- the cluster name of the execution group to remove.
If in a cluster, this is the cluster name of, otherwise this is the
server name.
java.io.IOException
- if a protocol error occurred.
javax.management.OperationsException
- if there are active ESS instances in
the execution group being removed or if the execution group clean up
is already occurring.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.java.util.List<oracle.as.scheduler.management.InactiveBinding> getInactiveBindings() throws javax.management.RuntimeOperationsException
java.io.IOException
- if a protocol error occurred.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem failure
occurs.java.util.List<oracle.as.scheduler.management.AppRegistrationInfo> getApplicationsInfo() throws javax.management.RuntimeOperationsException
Retrieve application registration information for all applications in all servers for all process groups in this isolation group.
A separate entry is returned for each application/server combination.
The AppRegistrationInfo for ESSAPP is removed from the returned
list. To get the full list, use
getApplicationsInfo(boolean)
with true
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem
failure occurs.java.util.List<oracle.as.scheduler.management.AppRegistrationInfo> getApplicationsInfo(boolean includeEssApp) throws javax.management.RuntimeOperationsException
Retrieve application registration information for all applications in all servers for all process groups in this isolation group.
A separate entry is returned for each application/server combination.
javax.management.RuntimeOperationsException
- if a RuntimeService subsystem
failure occurs.
|
Oracle Fusion Applications Java API Reference for Oracle Enterprise Scheduler Service 11g Release 1 (11.1.2) E20742-02 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |