qtools

qtools offers the shortcuts for some common procedures when working with the Open Grid Scheduler.

Installation

Install qtools using gem:

$ gem install qtools

Usage

• qqsub to submit a script or a compiled executable
• qclean to remove .e[0-9]* and .o[0-9]* files in the current directory
• qwatch to see the running jobs for the current user
• qcount to see the number of running jobs for the current user
• qnode to list the free nodes
• qundo to stop the last submitted job for the current user
• qless to read the last error log .e[0-9]* in the current folder

qqsub

Usage:

$ qqsub 'python3 my_script.py -i input.txt -v' -n my_name -m 8gb

The command above will create a shell script file with the corresponding content and submit a job which will feature the name my_name and require 8gb of memory.

qwatch

Usage:

$ qwatch

The command above is equivalent to running watch -n1 -d "qstat -u $USER".

Flags:

• -n, --nodes to show information on nodes too (qstat -n1 -u $USER)

qclean

Usage:

$ qclean

The command above will run rm *.[eo][0-9]* in the current directory (if such files exist).

qcount

Usage:

$ qcount

Count the number of jobs for the $USER. Running qcount -a will output the number of jobs for all the users.

qnode

Usage:

$ qnode

The command above will print the list of free nodes sorted by their LOAD. Use qnode -m to sort the list of free nodes by memory available and qnode -c to sort the list by the number of free cores.

qundo

Usage:

$ qundo

The command above will try to run qdel for the last job submitted.

qless

Usage:

$ qless

The command above will try to read the last default error log .e[0-9]* in the current folder. Use -o flag to read the last default output file.

Contributing

Bug reports and pull requests are welcome on GitHub.

License

The gem is available as open source under the terms of the MIT License.