SGE_INTRO(1) General Commands Manual SGE_INTRO(1) NAME Univa Grid Engine - a facility for executing UNIX jobs on remote machines DESCRIPTION Univa Grid Engine is a facility for executing UNIX batch jobs (shell scripts) on a pool of cooperating workstations. Jobs are queued and executed remotely on workstations at times when those workstations would otherwise be idle or only lightly loaded. The work load is dis- tributed among the workstations in the cluster corresponding to the 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)). Checkpointing jobs migrate from workstation to workstation without user intervention on load demand. In addition to batch jobs, interactive jobs and paral- lel jobs can also be submitted to Univa Grid Engine. USER INTERFACE The Univa Grid Engine user interface consists of several programs which are described separately. 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 Univa Grid Engine execu- tion hosts. qlogin(1) qlogin initiates a telnet or similar login session with auto- matic 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 pro- cesses 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 Univa Grid Engine functions. The status of all or a private selection of the con- figured queues is displayed on-line by changing colors at corre- sponding 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 Univa Grid Engine com- parable to the standard Unix facility rsh, to allow for the sub- mission of batch jobs which, upon execution, support terminal I/O (standard/error output and standard input) and terminal con- trol, to provide a batch job submission client which remains active until the job has finished or to allow for the Univa 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 Univa 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 Univa 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 associ- ated 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 Univa Grid Engine. qsub(1) qsub is the user interface for submitting a job to Univa Grid Engine. SEE ALSO 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), Univa Grid Engine Installation Guide, Univa Grid Engine Administration Guide, Univa Grid Engine User's Guide. COPYRIGHT Copyright: 2008 by Sun Microsystems, Inc. Parts of the manual page texts are Copyright 2011 Univa Corporation. Univa Grid Engine User Commands UGE 8.5.4 SGE_INTRO(1)