There are a variety of useful commands for Linux when using Tempest to control jobs and view useful information.

View Information

sqf

The 'sqf' command can be used to display details about all or a specific subset of jobs on Tempest.

Flags:

  • -h : Shows the help message
  • -a : Displays the whole queue
  • -s <expression> : Search for a specific string in the queue
  • -u : Search for jobs run by the current user in the queue

scontrol show

The 'scontrol' command has a large amount of different flags for different functions, but for users the primary use of scontrol is to see details about a specific job with the 'show' flag. The full arguments for scontrol show are:

scontrol show <ENTITY> [<ID>]

The entity argument can be a variety of different arguments such as job, node, or partition with the ID argument being the value to search for with the correspoding entity. Use the -h flag for full scontrol documentation.

sacct

The 'sacct' command can be used to see recent jobs run by the user along with a variety of parameters such as where the job was run, the time it took, the current status, and the max memory usage. This command can be used to optimize resource utilization for jobs that may be repeatedly run.

Control Jobs

scancel

The 'scancel' command can be used to cancel jobs started by the user by giving the job ID after the scancel command. The job ID can be found using the commands like sqf.