nc preempt

Preempt the specified running jobs.


vnc: Usage Message
  
  NC PREEMPT:
      Preempt the specified running jobs.
      Preemption means that:
      1.  The job is stopped or suspended (depending on method and age)
      2.  The resources of the job are revoked
      3.  If needed, a 'resumer job' is scheduled to
      restart the job as soon as the revoked
      resources are again available.
  
      If a job is not running, an error is reported.
  
  USAGE:
      % nc preempt [OPTIONS] <jobId> ...
  
  OPTIONS:
      -h                   -- This help.
      -v                   -- Increase verbosity.
      -method METHOD       -- Specify preemption method. Default is AUTOMATIC.
                              Common values:
                              AUTOMATIC, KILL, KILL+RESUBMIT, SUSPEND,
                              SIGTSTP+SUSPEND
                              Other values and example of preemption plans
                              (see docs): MODELSIM, BEGIN:RETRACING:EXT, 
                              TSTP, vish. 
                              Bad values are currently ignored.
      -manualresume        -- The resumer job is not scheduled;
                              A 'nc resume' is required to restart the
                              preempted job.
      -resumeres RESLIST   -- Specify resources to be added to the
                              resumer job. The resources are expanded.
                              Examples:
                              @HOST@ RAM/@RAM@
                              @PROP.SOLUTION@
                              Any job field can be used, but here are
                              some common fields that can be useful:
                              @TASKERNAME@
                              @HWRAM@ @HWCORES@ @HWPERCENT@ @HWSLOTS@
  
  EXAMPLES:
      % nc preempt 123456
      % nc preempt -v 123456
  
      % nc preempt -method SIGTSTP 123456
      % nc preempt -method KILL+RESUBMIT 123456
      % nc preempt -method BEGIN:RETRACING:EXT,TSTP,vish 123456
      % nc preempt 03076307 03076311 03076315
  
      % nc preempt -manualresume 123456
      % nc preempt -manualresume -resumeres @PROP.SOLUTION@ 123456
      % nc preempt -manualresume -resumeres "@HOST@ RAM/@MAXRAM@" 123456
      % ...
      % nc resume  123456
  

Options

Most of the options are explained by the summaries in the brief usage output shown above. The -v option enables printing of additional messages that may be helpful in troubleshooting.

The -method option may be used to specify the preemption method used to revoke the resources of the preempted jobs. This overrides any method in the configuration file. This option may be helpful in troubleshooting. The -l option is handy to get a list of known preemption methods. The names of the methods are case-sensitive.

Only users with the Altair Accelerator ADMIN privilege or the owner of the preempted job can run this command.