--- name: "sge_intro" section: "1" platform: "linux" package: "gridengine-common" version: "8.1.9+dfsg-13.1" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/sge_intro" --- # sge\_intro(1) Grid Engine, a facility for executing jobs on remote machines ## NAME sge\_intro - Grid Engine, a facility for executing jobs on remote machines ## DESCRIPTION Grid Engine is a facility for executing Unix-like batch jobs (shell scripts or binaries) on a pool of cooperating CPUs. Jobs are queued and executed remotely according to defined policies. The CPUs may be in desktop systems, with jobs run on them at times when they would otherwise be idle or only lightly loaded. The work load may be distributed according to the (generalized) load situation of each machine and the resource requirements of the jobs. User level checkpointing programs are supported and a transparent checkpointing mechanism is provided (see [*sge\_ckpt*(1)](/sge_ckpt/1.md)). Checkpointing jobs migrate from system to system without user intervention on load demand. In addition to simple batch jobs, interactive jobs and parallel jobs can also be submitted to Grid Engine. ## USER INTERFACE The Grid Engine user interface consists of several programs which are described separately. - [*qacct*(1)](/qacct/1.md) *qacct* extracts arbitrary accounting information from the cluster logfile. - [*qalter*(1)](/qalter/1.md) *qalter* changes the characteristics of already submitted jobs. - [*qconf*(1)](/qconf/1.md) *qconf* provides the user interface for configuring, modifying, deleting and querying queues and the cluster configuration. - [*qdel*(1)](/qdel/1.md) *qdel* provides the means for a user/operator/manager to cancel jobs. - [*qevent*(1)](/qevent/1.md) *qevent* provides a means of watching Grid Engine events and acting on jobs finishing. - [*qhold*(1)](/qhold/1.md) *qhold* holds back submitted jobs from execution. - [*qhost*(1)](/qhost/1.md) *qhost* displays status information about Grid Engine execution hosts. - [*qlogin*(1)](/qlogin/1.md) *qlogin* initiates a telnet or similar login session with automatic selection of a suitable host. - *qmake*(1) *qmake* is a replacement for the standard Unix *make* facility. It extends make with an ability to distribute independent make steps across a cluster of suitable machines. - [*qmod*(1)](/qmod/1.md) *qmod* allows the owner(s) of a queue to suspend and enable queues, e.g. 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 queues. - [*qmon*(1)](/qmon/1.md) *qmon* provides a Motif command interface to all 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. - [*qping*(1)](/qping/1.md) *qping* can be used to check the status of Grid Engine daemons. - [*qquota*(1)](/qquota/1.md) *qquota* provides a status listing of all currently used resource quotas (see [*sge\_resource\_quota*(5)](/sge_resource_quota/5.md)). - [*qresub*(1)](/qresub/1.md) *qresub* creates new jobs by copying currently running or pending jobs. - [*qrls*(1)](/qrls/1.md) *qrls* releases holds from jobs previously assigned to them e.g. via [*qhold*(1)](/qhold/1.md) (see above). - [*qrdel*(1)](/qrdel/1.md) *qrdel* provides the means to cancel advance reservations. - [*qrsh*(1)](/qrsh/1.md) *qrsh* can be used for various purposes such as providing remote execution of interactive applications via 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 Grid Engine-controlled remote execution of the tasks of parallel jobs. - [*qrstat*(1)](/qrstat/1.md) *qrstat* provides a status listing of all advance reservations in the cluster. - [*qrsub*(1)](/qrsub/1.md) *qrsub* is the user interface for submitting an advance reservation to Grid Engine. - [*qselect*(1)](/qselect/1.md) *qselect* prints a list of queue names corresponding to specified selection criteria. The output of *qselect* is usually fed into other Grid Engine commands to apply actions on a selected set of queues. - [*qsh*(1)](/qsh/1.md) *qsh* opens an interactive shell (in an [*xterm*(1)](/xterm/1.md)) on a low loaded host. Any kind of interactive job can be run in this shell. - [*qstat*(1)](/qstat/1.md) *qstat* provides a status listing of all jobs and queues associated with the cluster. - [*qtcsh*(1)](/qtcsh/1.md) *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 Grid Engine. - [*qsub*(1)](/qsub/1.md) *qsub* is the user interface for submitting a job to Grid Engine. ## SEE ALSO [*sge\_ckpt*(1)](/sge_ckpt/1.md), [*qacct*(1)](/qacct/1.md), [*qalter*(1)](/qalter/1.md), [*qconf*(1)](/qconf/1.md), [*qdel*(1)](/qdel/1.md), [*qhold*(1)](/qhold/1.md), [*qhost*(1)](/qhost/1.md), [*qlogin*(1)](/qlogin/1.md), *qmake*(1), [*qmod*(1)](/qmod/1.md), [*qmon*(1)](/qmon/1.md), [*qresub*(1)](/qresub/1.md), [*qrls*(1)](/qrls/1.md), [*qrsh*(1)](/qrsh/1.md), [*qselect*(1)](/qselect/1.md), [*qsh*(1)](/qsh/1.md), [*qstat*(1)](/qstat/1.md), [*qsub*(1)](/qsub/1.md), [*qtcsh*(1)](/qtcsh/1.md). ## COPYRIGHT Copyright: 2008 by Sun Microsystems, Inc. Parts of the manual page texts are Copyright 2011 Univa Corporation, and various dates by other contributors. The manual pages are licensed under the Sun Industry Standards Source License, like the source, except where noted in some files by other contributors, which are under other free licences noted in their source.