Get Summary Information

nc summary, nc list and nc info jobId will be the three commands that you use frequently to get information about the jobs managed by Accelerator.

Get Summary of All My Jobs: nc summary

% nc summary
NC Summary For User dexin
TOTAL JOBS         11      Duration: 23s
  Done              1
  Idle              0
  Queued            5
  Running           2
  Failed            3

  JOBS   GROUP    TOOL        WAITING FOR...
     1   alpha    sleep      'aa'
     3   alpha    sleep      'linux'

In the above example, the command displays summary information for user dexin. There are a total of 11 jobs, 1 of which is Done, 2 Running, 3 Failed, etc. In the bottom part, it shows the summary for jobs that are queued, that is, there is 1 sleep job queued because it is waiting for resource 'aa', and there are 3 sleep jobs waiting for resource 'linux'.

To get an idea of what is going on in the whole Accelerator system, the following shows all the jobs and what the jobqueue buckets are waiting for. Note that Accelerator subcommands may be abbreviated. 
% nc sum -a -b

Get a List of My Jobs: nc list

This command, without any option, displays the last 20 of your jobs in the format of "jobId status command".
% nc list
04193437 Done    sleep 1
04193911 Done    sleep 5
04193913 Failed  sleep 10
04193917 Failed  sleep 20
04193919 Idle    sleep 60
04193937 Running sleep 10
04193943 Queued  sleep 56

Status Meaning

In Accelerator, each job is assigned an "Accelerator Computing Status" which is defined as follows:

Status Color * Explanation
Queued Cyan The job is scheduled to be executed.
Running Orange The job is currently executing
Done Green The job ran successfully
Failed Red The job ran and failed.
Idle BlueViolet The job needs to be run, but it is not scheduled.

*(Colors may look different on some systems)

Some Options about nc list

The nc list command has several useful options. They include:
Get detailed usage of this command: 
% nc list -h
List all jobs, including others' jobs: 
% nc list -a
04193437 Done    alpha    dexin    rhino      sleep 1
04193898 Done    users    integ    rhino      sleep 2
04193939 Done    alpha    dexin    rhino      sleep 15
04193941 Done    alpha    dexin    rhino      sleep 20
04193943 Done    alpha    dexin    rhino      sleep 60
Control output format, show job Id the (first) tool of job only: 
% nc list -O "@ID@ @TOOL@"
04193437 sleep
04193898 sleep
04193939 sleep
04193941 sleep
04193943 sleep
In the above example, we use "fields", i.e., ID and TOOL, surrounded by two "@" signs, to format strings.

Get Detailed Information About a Job: nc info jobId

Without options, this command displays the basic information about the job, like user, group, directory, command, environment, queue time, etc. 

% nc info 000001086
NC Queue        Rqueue
Id,User,Group   000001086,dexin,rtda,/time/users.dexin
Environment     SNAPSHOT(vnc_logs/snapshots/dexin/linux64/env44278.env)
Directory       /projects/dexin/Rqueue.swd/logs
Command         echo hello
Resources       linux64
Submitted from  rhino
Submitted at    Mon Aug 26 10:37:07 PDT 2024
Priorities      schedule=normal execution=low
PlacementPolicy fastest,none
Status          Done
   Host         rhino
   Tasker       rhino
   QueueTime    0s
   CPUTime      67.00
   MaxRAM       4MB
   Duration     0s
   Age          13s
   AutoForget   1
Job 000001086 is Done

Main Reason:
   This job successfully executed.

With option -l, this command shows the contents of the log file. 

% nc info -l 000001086

Log file is: db=FILEX '/projects/dexin/Rqueue.swd/logs/vnc_logs/20240826/103707.386550.66ccbd43-6209-2099-bf4f0-293039-03e253533383730'
hello