Jobs View

The Jobs view provides comprehensive job management capabilities including monitoring, submission, cancellation, and batch operations.

Jobs view showing job list, filtering, and batch operations

Overview

The Jobs view displays a table of all SLURM jobs with detailed information and provides actions for job management. It supports both single-job operations and powerful batch operations for managing multiple jobs simultaneously.

Table Columns

The jobs table displays 11 columns:

Color Coding

• State column: Color varies by job state
  • Green: RUNNING
  • Cyan: COMPLETED
  • Yellow: PENDING
  • Red: FAILED
  • Gray: CANCELLED
  • Orange: SUSPENDED
  • White: TIMEOUT, PREEMPTED, COMPLETING, CONFIGURING (default)
• Table header: Teal
• Selected rows: Yellow highlight

Single Job Actions

View Job Details

Shortcut: Enter

Shows detailed information about the selected job:

• Job ID, name, and user
• State, exit code, and reason
• Partition and QoS
• Node allocation
• Time information (submit, start, end)
• Resource usage (CPU, memory)
• Working directory and command
• Standard output/error paths

The detail modal shows comprehensive job information including:

• TRES (Trackable Resources) requested and allocated
• GRES details with GPU index assignments
• Batch host, cluster, memory, submit command line
• Expanded output file paths (%j → actual job ID)

Submit New Job

Shortcut: s

Opens the job submission wizard with step-by-step guided submission and pre-configured templates.

See Job Management for detailed submission guide.

Cancel Job

Shortcut: c/C

Cancels the selected job (available for RUNNING or PENDING states).

Confirmation dialog shows:

• Job ID and name
• Current state
• User and partition

Hold Job

Shortcut: H

Places a PENDING job on hold, preventing it from starting.

Release Job

Shortcut: r

Releases a held or suspended job, allowing it to run.

Available for:

• SUSPENDED jobs
• PENDING jobs (that were held)

Requeue Job

Command: :requeue JOBID

Requeues a completed, failed, or cancelled job for re-execution. Use command mode (:requeue) since the q key is reserved for the global quit shortcut.

View Job Output

Shortcut: o/O

Opens the job output viewer with:

• Standard output (stdout)
• Standard error (stderr)
• Real-time log streaming for running jobs

The output viewer supports:

• Real-time streaming — press t to watch output as it's written (like tail -f)
• Stdout/stderr switching — press s to toggle between output streams
• Export — press e to save output in text, JSON, CSV, or markdown format
• Auto-scroll — press a to follow new content automatically

See Job Streaming Guide for details.

View Job Dependencies

Shortcut: d/D

Shows job dependency graph:

• Jobs this job depends on
• Jobs that depend on this job
• Dependency types (afterok, afterany, etc.)

Batch Operations

Enter Batch Mode

Shortcut: b/B

Opens the batch operations menu for managing multiple jobs.

Multi-Select Mode

Shortcut: v/V

Toggles multi-select mode for selecting specific jobs.

In multi-select mode:

• Space - Toggle selection for current row
• Ctrl+A - Select all jobs
• ESC - Exit multi-select mode

Selection status shows: "Selected X jobs"

Batch Actions

When multiple jobs are selected:

• Cancel - Cancel all selected jobs
• Hold - Hold all selected pending jobs
• Release - Release all selected held jobs

State-Based Batch Operations

Operate on all jobs in a specific state:

• Cancel all PENDING jobs
• Hold all PENDING jobs
• Release all SUSPENDED jobs

Filtering & Search

Simple Text Filter

Shortcut: /

Activates the filter input box. Filters jobs by:

• Job ID
• Job name
• Username
• Account
• Partition
• Any displayed column value

Special syntax:

• p:name or partition:name - Filter by partition

Example: / then type "gpu" to find all jobs with "gpu" in any field.

Global Search

Shortcut: Ctrl+F

Opens global search across all entity types (jobs, nodes, partitions, users, accounts, QoS, reservations).

Advanced Filter

The advanced filter bar supports expression-based filtering.

Filter expressions:

Copy
state=RUNNING
user=alice
partition=gpu
nodes>4
priority>=1000

Supported fields:

• id - Job ID
• name - Job name
• user - Username
• account - Account name
• state - Job state
• partition - Partition name
• nodes - Node count (supports >, <, >=, <=, =)
• timelimit - Time limit
• timeused - Time used
• priority - Priority (supports comparison operators)
• qos - Quality of Service
• submittime - Submission time
• starttime - Start time
• endtime - End time
• workdir - Working directory
• command - Job command

Operators:

• = - Exact match
• ~ - Contains
• >, <, >=, <= - Numeric comparison

Example filters:

Copy
state=RUNNING partition=gpu
user=alice priority>500
nodes>=8 state=PENDING

Press ESC to exit advanced filter mode.

State Filtering

User Filtering

Shortcut: u/U

Opens dialog to filter jobs by specific username.

Sorting

Sort jobs by clicking column headers or using keyboard shortcuts.

Sortable columns:

• State
• Priority
• Submit Time

Press S to open the interactive sort modal. Select a column and sort direction.

Auto-Refresh

The Jobs view refreshes on the global auto-refresh ticker, controlled by refreshRate in config (default 10 seconds). All views share this single cadence — editing refreshRate in the F10 modal re-arms the ticker live.

Toggle globally: F6 pauses or resumes auto-refresh across all views.

Manual refresh: R or F5 — always works, even when auto-refresh is paused.

Disable entirely: set refreshRate: "" in config.

Keyboard Shortcuts Reference

Job Operations

Selection & Batch

Filtering & Search

Data Management

Job Submission

Job submission wizard with step-by-step configuration

The job submission wizard (s) guides you through:

1. Basic Information

   • Job name
   • Script or command
   • Working directory

2. Resource Requirements

   • Partition
   • Number of nodes
   • CPUs per task
   • Memory requirements

3. Time Limits

   • Wall time
   • Time limit format (days-hours:minutes:seconds)

4. Advanced Options

   • Account
   • QoS
   • Job dependencies
   • Email notifications
   • Output/error file paths

See Job Management for detailed submission guide.

Tips

• Use v/V for multi-select when you need to operate on specific jobs
• Use batch operations by state when you want to affect all jobs in a state
• Press Ctrl+F for global search across all entity types
• Use p:name syntax in simple filter for quick partition filtering
• Check job output with o/O to debug issues
• Use d/D to understand job dependencies before canceling
• Lower refreshRate in F10 or press F6 to toggle auto-refresh while monitoring active jobs
• Press ? when unsure what actions are available for a job