Package oracle.as.scheduler

Interface AsyncRequestBeanInterface

All Known Subinterfaces:
AsyncRequestBeanRemote
public interface AsyncRequestBeanInterface
Used to convey the final execution status of a asynchronous job.

  • Method Details

    • setRequestStatus

      void setRequestStatus(RequestExecutionContext context, AsyncStatus status, String statusMessage) throws RuntimeServiceException, RequestNotFoundException
      Set the status of an ESS asynchronous java job.
      Parameters:
      context - The RequestExecutionContext with which the request was started.
      status - The status of the request.
      statusMessage - An error message if the status is 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 or CANCEL.
      Throws:
      RequestNotFoundException - If a request is not found for the context.
      RuntimeServiceException - if an error occurred.

    • getContextFromString

      RequestExecutionContext getContextFromString(String string) throws RuntimeServiceException, RequestNotFoundException
      Converts the string representation of a RequestExecutionContext into RequestExecutionContext object. The dual of RequestExecutionContext.toString()
      Parameters:
      string - the String to convert to a context.
      Returns:
      the RequestExecutionContext represented by the string argument
      Throws:
      RequestNotFoundException - If a request is not found for the context.
      RuntimeServiceException - if an error occurred.

    • checkInCancelling

      boolean checkInCancelling(RequestExecutionContext context) throws RequestNotFoundException, RuntimeServiceException
      Checks if a cancel operation has been initiated for the given request. This operation also resets the cancel timer.

      The time since a cancel operation is initiated for request is tracked. The purpose is to only allow certain types of recovery operations N minutes after a cancel is invoked. However, invoking this method will reset the timer since it is seen as an indication that the job is still active.

      Thus if the time limit is 10 minutes and the job checks in to ESS 8 minutes after cancel was initiated, the timer will be set back to 0, allowing 10 more minutes.

      Parameters:
      context - the execution context of the running request that is being checked.
      Returns:
      true if a cancel operation has been initated for this request, false otherwise.
      Throws:
      RequestNotFoundException - if the request was not found
      RuntimeServiceException - if a RuntimeService subsystem failure occurs