1GE_INTRO(1)                Grid Engine User Commands               GE_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 ge_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       qquota(1)
70              qquota provides a status listing of all currently used  resource
71              quotas (see ge_resource_quota(1).)
72
73       qresub(1)
74              qresub  creates new jobs by copying currently running or pending
75              jobs.
76
77       qrls(1)
78              qrls releases holds from jobs previously assigned to  them  e.g.
79              via qhold(1) (see above).
80
81       qrdel(1)
82              qrdel provides the means to cancel advance reservations.
83
84       qrsh(1)
85              qrsh  can  be used for various purposes such as providing remote
86              execution of interactive applications via Grid Engine comparable
87              to  the  standard Unix facility rsh, to allow for the submission
88              of batch jobs which, upon execution, support terminal I/O (stan‐
89              dard/error  output  and standard input) and terminal control, to
90              provide a batch job submission client which remains active until
91              the  job has finished or to allow for the Grid Engine-controlled
92              remote execution of the tasks of parallel jobs.
93
94       qrstat(1)
95              qrstat provides a status listing of all advance reservations  in
96              the cluster.
97
98       qrsub(1)
99              qrsub is the user interface for submitting a advance reservation
100              to Grid Engine.
101
102       qselect(1)
103              qselect prints a list of queue names corresponding to  specified
104              selection  criteria.  The  output of qselect is usually fed into
105              other Grid Engine commands to apply actions on a selected set of
106              queues.
107
108       qsh(1) qsh  opens an interactive shell (in an xterm(1)) on a low loaded
109              host. Any kind of interactive jobs can be run in this shell.
110
111       qstat(1)
112              qstat provides a status listing of all jobs and  queues  associ‐
113              ated with the cluster.
114
115       qtcsh(1)
116              qtcsh is a fully compatible replacement for the widely known and
117              used Unix C-Shell (csh) derivative tcsh. It provides a  command-
118              shell with the extension of transparently distributing execution
119              of designated applications to suitable and lightly loaded  hosts
120              via Grid Engine.
121
122       qsub(1)
123              qsub is the user interface for submitting a job to Grid Engine.
124

SEE ALSO

126       ge_ckpt(1), qacct(1), qalter(1), qconf(1), qdel(1), qhold(1), qhost(1),
127       qlogin(1), qmake(1), qmod(1),  qmon(1),  qresub(1),  qrls(1),  qrsh(1),
128       qselect(1),  qsh(1), qstat(1), qsub(1), qtcsh(1), Grid Engine Installa‐
129       tion Guide, Grid Engine Administration Guide, Grid Engine User's Guide.
130

COPYRIGHT

132       Copyright: 2008 by Sun Microsystems, Inc.
133
134
135
136GE 6.2u5                 $Date: 2008/05/02 08:53:44 $              GE_INTRO(1)