Class setstatus

source code

object --+    
         |    
   Command --+
             |
            setstatus

Command: setstatus <dataset_id>[.<job>] <status>

Set the status of all jobs or a specific job from a dataset.
Can set the status of multiple jobs over multiple datasets at once.

Arguments:
  <dataset_id>  Specify the dataset.
  [.<job>]      (Optional) Specify the job within the dataset.
  <status>      Specify the status
                (WAITING, QUEUEING, QUEUED, PROCESSING, OK, ERROR,
                 READYTOCOPY, COPYING, SUSPENDED, RESET, FAILED,
                 COPIED, EVICTED, CLEANING, IDLE)
  
Returns:
  Returns the result of the mysql query (success or failure).
  Warning that if the dataset or job id is wrong it will likely
  print success because there was no mysql error.
  
Examples:
  Set status of all jobs in dataset to RESET  (dataset 1234, all jobs)
     status 1234 RESET
  
  Set status of individual jobs from different datasets
  (dataset 1234, job 10 to waiting and dataset 4321, job 20 to RESET)
     status 1234.10 WAITING 4321.20 RESET
  
  Set status of multiple datasets and jobs using commas
  (jobs 1, 3, and 5 from datasets 1234 and 1243 to OK)
     status 1234,1243.1,3,5 OK
  
  Set status of multile datasets and jobs using ranges
  (datasets 1234 - 1235, jobs 1 - 5 to SUSPENDED)
     status 1234-1235.1-5 SUSPENDED