1SGE_INTRO(1)               Grid Engine User Commands              SGE_INTRO(1)
2
3
4

NAME

6       Grid Engine - a facility for executing UNIX jobs on remote machines
7

DESCRIPTION

9       Grid Engine is a facility for executing UNIX batch jobs (shell scripts)
10       on a pool of cooperating workstations. Jobs  are  queued  and  executed
11       remotely  on workstations at times when those workstations would other‐
12       wise be idle or only lightly loaded. The work load is distributed among
13       the  workstations in the cluster corresponding to the load situation of
14       each machine and the resource requirements of the jobs.
15
16       User level checkpointing  programs  are  supported  and  a  transparent
17       checkpointing  mechanism  is provided (see sge_ckpt(1)).  Checkpointing
18       jobs migrate from workstation to workstation without user  intervention
19       on  load demand. In addition to batch jobs, interactive jobs and paral‐
20       lel jobs can also be submitted to Grid Engine.
21

USER INTERFACE

23       The Grid Engine user interface consists of several programs  which  are
24       described separately.
25
26       qacct(1)
27              qacct extracts arbitrary accounting information from the cluster
28              logfile.
29
30       qalter(1)
31              qalter changes the characteristics of already submitted jobs.
32
33       qconf(1)
34              qconf provides the user interface  for  configuring,  modifying,
35              deleting and querying queues and the cluster configuration.
36
37       qdel(1)
38              qdel  provides  the  means for a user/operator/manager to cancel
39              jobs.
40
41       qhold(1)
42              qhold holds back submitted jobs from execution.
43
44       qhost(1)
45              qhost displays status information about  Grid  Engine  execution
46              hosts.
47
48       qlogin(1)
49              qlogin  initiates  a  telnet or similar login session with auto‐
50              matic selection of a low loaded and suitable host.
51
52       qmake(1)
53              qmake is a replacement for the standard Unix make  facility.  It
54              extends make by its ability to distribute independent make steps
55              across a cluster of suitable machines.
56
57       qmod(1)
58              qmod allows the owner(s) of a queue to suspend  and  enable  all
59              queues  associated  with  his machine (all currently active pro‐
60              cesses in this queue are also signaled) or to suspend and enable
61              jobs executing in the owned queues.
62
63       qmon(1)
64              qmon provides a Motif command interface to all Grid Engine func‐
65              tions. The status of all or a private selection of  the  config‐
66              ured  queues  is  displayed on-line by changing colors at corre‐
67              sponding queue icons.
68
69       qresub(1)
70              qresub creates new jobs by copying currently running or  pending
71              jobs.
72
73       qrls(1)
74              qrls  releases  holds from jobs previously assigned to them e.g.
75              via qhold(1) (see above).
76
77       qrsh(1)
78              qrsh can be used for various purposes such as  providing  remote
79              execution of interactive applications via Grid Engine comparable
80              to the standard Unix facility rsh, to allow for  the  submission
81              of batch jobs which, upon execution, support terminal I/O (stan‐
82              dard/error output and standard input) and terminal  control,  to
83              provide a batch job submission client which remains active until
84              the job has finished or to allow for the Grid  Engine-controlled
85              remote execution of the tasks of parallel jobs.
86
87       qselect(1)
88              qselect  prints a list of queue names corresponding to specified
89              selection criteria. The output of qselect is  usually  fed  into
90              other Grid Engine commands to apply actions on a selected set of
91              queues.
92
93       qsh(1) qsh opens an interactive shell (in an xterm(1)) on a low  loaded
94              host. Any kind of interactive jobs can be run in this shell.
95
96       qstat(1)
97              qstat  provides  a status listing of all jobs and queues associ‐
98              ated with the cluster.
99
100       qtcsh(1)
101              qtcsh is a fully compatible replacement for the widely known and
102              used  Unix C-Shell (csh) derivative tcsh. It provides a command-
103              shell with the extension of transparently distributing execution
104              of  designated applications to suitable and lightly loaded hosts
105              via Grid Engine.
106
107       qsub(1)
108              qsub is the user interface for submitting a job to Grid Engine.
109

SEE ALSO

111       sge_ckpt(1),  qacct(1),   qalter(1),   qconf(1),   qdel(1),   qhold(1),
112       qhost(1),  qlogin(1),  qmake(1),  qmod(1), qmon(1), qresub(1), qrls(1),
113       qrsh(1), qselect(1), qsh(1), qstat(1), qsub(1), qtcsh(1),  Grid  Engine
114       Installation  and  Administration Guide, Grid Engine Quick Start Guide,
115       Grid Engine User's Guide.
116

118       Copyright: 2004 by Sun Microsystems, Inc.
119
120
121
122GE 6.1                   $Date: 2004/05/26 17:37:54 $             SGE_INTRO(1)
Impressum