Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

How to Cancel a Workflow

Stop a running workflow and terminate its jobs.

Cancel a Workflow

torc cancel <workflow_id>

This:

  • Marks the workflow as canceled
  • Stops claiming new jobs
  • Sends SIGKILL to all running processes
  • Sends scancel to all active or pending Slurm allocations

Cancel from the TUI

Press C on a workflow in torc tui. This runs the same cancellation as torc cancel, including the scancel of outstanding Slurm allocations, and reports how many were canceled.

Check Cancellation Status

Verify the workflow was canceled:

torc status <workflow_id>

Or check completion status:

torc workflows is-complete <workflow_id>

Output:

Workflow 42 completion status:
  Is Complete: true
  Is Canceled: true

Restart After Cancellation

To resume a canceled workflow:

# Reinitialize to reset canceled jobs
torc workflows reinit <workflow_id>

# Run again locally
torc run <workflow_id>
# Or submit to scheduler
torc submit <workflow_id>

Jobs that completed before cancellation remain completed.

See Also