SGE Commands Reference

Meta Syntax Summary

•  -A|a (add)
•  -D|d (delete)
•  -M|m (modify)
•  -s (show)

Capitalized argument means ‘read in from file’.  Lowercase means ‘do it interactively’. All SGE commands generally follow this structure

The command-line user interface is a set of ancillary programs (commands) that enable you to do the following tasks:

• Manage queues
• Submit and delete jobs
• Check job status
• Suspend or enable queues and jobs

For a complete list of ancillary programs, see Client Commands. To view detailed information about each command, see the Grid Engine man pages, which are available in your $SGE_ROOT/man directory or on the Open Grid Engine site

Client Commands

The command-line user interface is a set of ancillary programs (commands) that enable you to do the following tasks:

• Manage queues
• Submit and delete jobs
• Check job status
• Suspend or enable queues and jobs

The Grid Engine system provides the following set of ancillary programs:

• qacct – Extracts arbitrary accounting information from the cluster log file. For more information, see Generating Accounting Statistics.
• qalter  – Changes the attributes of submitted but pending jobs.
• qconf – Provides the user interface for cluster configuration and queue configuration. For more information, see Using Files and Scripts for Administrative Tasks.
• qdel – Enables a user to delete one or more jobs. A manager or operator can delete jobs belonging to any user, while regular users can only delete their own jobs. For more information, see How to Control Jobs With qdel and qmod.
• qhold – Holds back submitted jobs from execution.
• qhost – Displays status information about execution hosts.
• qlogin – Initiates a login session with automatic selection of a low-loaded, suitable host.
• qmake – A replacement for the standard UNIX make facility. qmake extends make by its ability to distribute independent make steps across a cluster of suitable machines. For more information, see Parallel Makefile Processing With qmake.
• qmod – Enables the owner to suspend or enable a queue. All currently active processes that are associated with this queue are also signaled. For more information, see How to Control Queues With qmod and How to Control Jobs With qdel and qmod.
• qmon – Provides an X Windows Motif command interface and monitoring facility.
• qping – Checks application status of Sun Grid Engine daemons. If for example execution node does not connect to the master, the first thing to check is how qping behaves in this case. It might be firewall or something else that prevent communication.
• qquota – Shows current usage of Sun Grid Engine resource quotas. For more information, see Monitoring Resource Quota Utilization From the Command Line.
• qrdel – Deletes Sun Grid Engine advance reservations. For more information, see qrdel.
• qresub – Creates new jobs by copying jobs that are running or pending.
• qrls – Releases jobs from holds that were previously assigned to them, for example, through qhold.
• qrsh – Can be used for various purposes, such as the following:
  • To provide remote execution of interactive applications through the Grid Engine system. qrsh is comparable to the standard UNIX facility rsh. For more information, see Remote Execution With qrsh.
  • To allow for the submission of batch jobs that, upon execution, support terminal I/O and terminal control. Terminal I/O includes standard output, standard error, and standard input.
  • To provide a submission client that remains active until the batch job finishes.
  • To allow for the Grid Engine software-controlled remote execution of the tasks of parallel jobs.
• qrstat – Shows the status of Sun Grid Engine advance reservations. For more information, see qrstat.
• qrsub – Submits an advance reservation to Sun Grid Engine. For more information, see qrsub.
• qselect – Prints a list of queue names corresponding to specified selection criteria. The output of qselect is usually sent to other Grid Engine system commands to apply actions on a selected set of queues.
• qsh – Opens an interactive shell in an xterm on a lightly loaded host. Any kind of interactive jobs can be run in this shell. For more information, see How to Submit Interactive Jobs With qsh From the Command Line.
• qstat – Provides a status listing of all jobs and queues associated with the cluster. For more information, see How to Monitor Jobs With qstat.
• qsub – The user interface for submitting batch jobs to the Grid Engine system.
• qtcsh – A fully compatible replacement for the widely known and used UNIX C shell (csh) derivative, tcsh. qtcsh provides a command shell with the extension of transparently distributing execution of designated applications to suitable and lightly loaded hosts through Grid Engine software. For more information see, Transparent Job Distribution With qtcsh.

Recommended Links

Softpanorama Recommended

Top articles

Sites

Top articles

Sites

The Sun Grid Engine manpages are available from die.net

qacct(1)

qacct extracts arbitrary accounting information from the cluster logfile.

qalter(1)

qalter changes the characteristics of already submitted jobs.

qconf(1)

qconf provides the user interface for configuring, modifying, deleting and querying queues and the cluster configuration.

qdel(1)

qdel provides the means for a user/operator/manager to cancel jobs.

qhold(1)

qhold holds back submitted jobs from execution.

qhost(1)

qhost displays status information about Sun Grid Engine execution hosts.

qlogin(1)

qlogin initiates a telnet or similar login session with automatic selection of a low loaded and suitable host.

qmake(1)

qmake is a replacement for the standard Unix make facility. It extends make by its ability to distribute independent make steps across a cluster of suitable machines.

qmod(1)

qmod allows the owner(s) of a queue to suspend and enable all queues associated with his machine (all currently active processes in this queue are also signaled) or to suspend and enable jobs executing in the owned queues.

qmon(1)

qmon provides a Motif command interface to all Sun Grid Engine functions. The status of all or a private selection of the configured queues is displayed on-line by changing colors at corresponding queue icons.

qquota(1)

qquota provides a status listing of all currently used resource quotas (see sge_resource_quota(1).)

qresub(1)

qresub creates new jobs by copying currently running or pending jobs.

qrls(1)

qrls releases holds from jobs previously assigned to them e.g. via qhold(1) (see above).

qrdel(1)

qrdel provides the means to cancel advance reservations.

qrsh(1)

qrsh can be used for various purposes such as providing remote execution of interactive applications via Sun Grid Engine comparable to the standard Unix facility rsh, to allow for the submission of batch jobs which, upon execution, support terminal I/O (standard/error output and standard input) and terminal control, to provide a batch job submission client which remains active until the job has finished or to allow for the Sun Grid Engine-controlled remote execution of the tasks of parallel jobs.

qrstat(1)

qrstat provides a status listing of all advance reservations in the cluster.

qrsub(1)

qrsub is the user interface for submitting a advance reservation to Sun Grid Engine.

qselect(1)

qselect prints a list of queue names corresponding to specified selection criteria. The output of qselect is usually fed into other Sun Grid Engine commands to apply actions on a selected set of queues.

qsh(1)

qsh opens an interactive shell (in an xterm(1)) on a low loaded host. Any kind of interactive jobs can be run in this shell.

qstat(1)

qstat provides a status listing of all jobs and queues associated with the cluster.

qtcsh(1)

qtcsh is a fully compatible replacement for the widely known and used Unix C-Shell (csh) derivative tcsh. It provides a command-shell with the extension of transparently distributing execution of designated applications to suitable and lightly loaded hosts via Sun Grid Engine.

qsub(1)

qsub is the user interface for submitting a job to Sun Grid Engine.

Recommended Links

Softpanorama Recommended

Top articles

Sites

Top articles

Sites

• UGE Manual Pages
• Grid Engine Documentation

Man pages

sge_ckpt(1), qacct(1), qalter(1), qconf(1), qdel(1), qhold(1), qhost(1), qlogin(1), qmake(1), qmod(1), qmon(1), qresub(1), qrls(1), qrsh(1), qselect(1), qsh(1), qstat(1), qsub(1), qtcsh(1), Sun Grid Engine Installation Guide, Sun Grid Engine Administration Guide, Sun Grid Engine User's Guide.

qstat(1) status of batch jobs - Linux man page

qconf(1), qdel-ge(1), qhost(1), qmod(1), qquota(1), qselect-ge(1), qstat-ge(1), sge_host_conf(5), sge_intro(1), sge_pe(5), sge_priority(5), sge_qstat(5), sge_queue_conf(5), sge_sched_conf(5), submit(1)

sge_intro(1), qalter(1), qconf(1), qhold(1), qmod(1), qstat(1), qsub(1), queue_conf(5), sge_execd(8), sge_qmaster(8), sge_shepherd(8).

Etc

Society

Groupthink : Two Party System as Polyarchy : Corruption of Regulators : Bureaucracies : Understanding Micromanagers and Control Freaks : Toxic Managers :   Harvard Mafia : Diplomatic Communication : Surviving a Bad Performance Review : Insufficient Retirement Funds as Immanent Problem of Neoliberal Regime : PseudoScience : Who Rules America : Neoliberalism  : The Iron Law of Oligarchy : Libertarian Philosophy

Quotes

War and Peace : Skeptical Finance : John Kenneth Galbraith :Talleyrand : Oscar Wilde : Otto Von Bismarck : Keynes : George Carlin : Skeptics : Propaganda  : SE quotes : Language Design and Programming Quotes : Random IT-related quotes :  Somerset Maugham : Marcus Aurelius : Kurt Vonnegut : Eric Hoffer : Winston Churchill : Napoleon Bonaparte : Ambrose Bierce :  Bernard Shaw : Mark Twain Quotes

Bulletin:

Vol 25, No.12 (December, 2013) Rational Fools vs. Efficient Crooks The efficient markets hypothesis : Political Skeptic Bulletin, 2013 : Unemployment Bulletin, 2010 :  Vol 23, No.10 (October, 2011) An observation about corporate security departments : Slightly Skeptical Euromaydan Chronicles, June 2014 : Greenspan legacy bulletin, 2008 : Vol 25, No.10 (October, 2013) Cryptolocker Trojan (Win32/Crilock.A) : Vol 25, No.08 (August, 2013) Cloud providers as intelligence collection hubs : Financial Humor Bulletin, 2010 : Inequality Bulletin, 2009 : Financial Humor Bulletin, 2008 : Copyleft Problems Bulletin, 2004 : Financial Humor Bulletin, 2011 : Energy Bulletin, 2010 : Malware Protection Bulletin, 2010 : Vol 26, No.1 (January, 2013) Object-Oriented Cult : Political Skeptic Bulletin, 2011 : Vol 23, No.11 (November, 2011) Softpanorama classification of sysadmin horror stories : Vol 25, No.05 (May, 2013) Corporate bullshit as a communication method  : Vol 25, No.06 (June, 2013) A Note on the Relationship of Brooks Law and Conway Law

History:

Fifty glorious years (1950-2000): the triumph of the US computer engineering : Donald Knuth : TAoCP and its Influence of Computer Science : Richard Stallman : Linus Torvalds  : Larry Wall  : John K. Ousterhout : CTSS : Multix OS Unix History : Unix shell history : VI editor : History of pipes concept : Solaris : MS DOS :  Programming Languages History : PL/1 : Simula 67 : C : History of GCC development :  Scripting Languages : Perl history   : OS History : Mail : DNS : SSH : CPU Instruction Sets : SPARC systems 1987-2006 : Norton Commander : Norton Utilities : Norton Ghost : Frontpage history : Malware Defense History : GNU Screen : OSS early history

Classic books:

The Peter Principle : Parkinson Law : 1984 : The Mythical Man-Month :  How to Solve It by George Polya : The Art of Computer Programming : The Elements of Programming Style : The Unix Hater’s Handbook : The Jargon file : The True Believer : Programming Pearls : The Good Soldier Svejk : The Power Elite

Most popular humor pages:

Manifest of the Softpanorama IT Slacker Society : Ten Commandments of the IT Slackers Society : Computer Humor Collection : BSD Logo Story : The Cuckoo's Egg : IT Slang : C++ Humor : ARE YOU A BBS ADDICT? : The Perl Purity Test : Object oriented programmers of all nations : Financial Humor : Financial Humor Bulletin, 2008 : Financial Humor Bulletin, 2010 : The Most Comprehensive Collection of Editor-related Humor : Programming Language Humor : Goldman Sachs related humor : Greenspan humor : C Humor : Scripting Humor : Real Programmers Humor : Web Humor : GPL-related Humor : OFM Humor : Politically Incorrect Humor : IDS Humor : "Linux Sucks" Humor : Russian Musical Humor : Best Russian Programmer Humor : Microsoft plans to buy Catholic Church : Richard Stallman Related Humor : Admin Humor : Perl-related Humor : Linus Torvalds Related humor : PseudoScience Related Humor : Networking Humor : Shell Humor : Financial Humor Bulletin, 2011 : Financial Humor Bulletin, 2012 : Financial Humor Bulletin, 2013 : Java Humor : Software Engineering Humor : Sun Solaris Related Humor : Education Humor : IBM Humor : Assembler-related Humor : VIM Humor : Computer Viruses Humor : Bright tomorrow is rescheduled to a day after tomorrow : Classic Computer Humor

The Last but not Least Technology is dominated by two types of people: those who understand what they do not manage and those who manage what they do not understand ~Archibald Putt. Ph.D

The statements, views and opinions presented on this web page are those of the author (or referenced source) and are not endorsed by, nor do they necessarily reflect, the opinions of the Softpanorama society. We do not warrant the correctness of the information provided or its fitness for any purpose. The site uses AdSense so you need to be aware of Google privacy policy. You you do not want to be tracked by Google please disable Javascript for this site. This site is perfectly usable without Javascript.

Last modified: March, 12, 2019