# Managing Jobs ## Listing running and queued jobs The `squeue` command will list all jobs scheduled in the cluster. We have also written wrappers for `squeue` on Oscar that you may find more convenient: ```bash myq List only your own jobs. allq List all jobs, but organized by partition, and a summary of the nodes in use in the partition. allq List all jobs in a single partition. myjobinfo Get the time and memory used for your jobs. ``` ## Viewing estimated time until completion for pending jobs ```bash squeue -u -t PENDING --start ``` This command will list all of your pending jobs and the estimated time until completion. ## Canceling jobs ```bash scancel ``` ## View details about completed jobs ### `sacct` The `sacct` command will list all of your running, queued and completed jobs since midnight of the previous day. To pick an earlier start date, specify it with the `-S` option: ```bash sacct -S 2012-01-01 ``` To find out more information about a specific job, such as its exit status or the amount of runtime or memory it used, specify the `-l` ("long" format) and `-j` options with the job ID: ```bash sacct -lj ``` (example) ### `myjobinfo` The `myjobinfo` command uses the `sacct` command to display "Elapsed Time", "Requested Memory" and "Maximum Memory used on any one Node" for your jobs. This can be used to optimize the requested time and memory to have the job started as early as possible. Make sure you request a conservative amount based on how much was used. ```bash myjobinfo Info about jobs for user 'mdave' submitted since 2017-05-19T00:00:00 Use option '-S' for a different date or option '-j' for a specific Job ID. JobID JobName Submit State Elapsed ReqMem MaxRSS 1861 ior 2017-05-19T08:31:01 COMPLETED 00:00:09 2800Mc 1744K 1862 ior 2017-05-19T08:31:11 COMPLETED 00:00:54 2800Mc 22908K 1911 ior 2017-05-19T15:02:01 COMPLETED 00:00:06 2800Mc 1748K 1912 ior 2017-05-19T15:02:07 COMPLETED 00:00:21 2800Mc 1744K ``` `ReqMem` shows the requested memory: A `c` at the end of number represents Memory Per CPU, a `n` represents Memory Per Node. `MaxRSS` is the maximum memory used on any one node. Note that memory specified to sbatch using `--mem` is Per Node. ### `jobstats` The 'jobstats' utility is now available for analyzing recently completed jobs, comparing the resources used to those requested in the job script, including CPU, GPU, and memory. If email notifications are enabled, 'jobstats' sends an email with the results and includes a prompt to contact support for help with resource requests. Run this command in a bash shell on Oscar. No additional module needs to be loaded. ```bash jobstats ``` To send this output to your email after the job is completed, make sure that these lines are in your job submit script ```bash #SBATCH --mail-type=END #SBATCH --mail-user= ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.ccv.brown.edu/oscar/submitting-jobs/managing-jobs.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.