JobResults

The JobResults interface is a derived interface of MonitorResults. In addition to the functionality of MonitorResults, it adds a type-specific get method and a method to kill an array of jobs.

The following methods, part of the MonitorResults functionality, are exposed on the JobResults interface:

• getCount()

  Returns the total count of items returned in the browsing request.  

• getCountSummary()

  Returns the CountSummary interface containing summary count information. Note that if the count information is not specified in the MonitorSource, then the count summary has only an overall count, not a count broken down by category.  

• getLevel()

  Returns the level of data asked for in the request to get results. This determines the monitoring information that is populated on each object returned. This value is obtained from the EnumDSSXMLLevelFlags enumeration.  

• elements()

  Returns a java.util.Enumeration containing the individual items in the collection.

  If the level flag is count only, this method will throw an exception.

The following method is exposed on and specific to the JobResults interface:

• get()

  Returns the job object in the collection at the given index.  

• kill()

  Kills an array of job objects.

  If there is a failure to kill the jobs, this method will throw a MonitorManipulationException. If there is a fatal error preventing this operation, such as a network error or server crash, this method will throw a WebObjectsAdminException.