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.

• qalter – Changes the attributes of submitted but pending jobs.

• qconf – Provides the user interface for cluster configuration and queue configuration.

• qdel – Provides the means for a user, operator, or manager to send signals to jobs or to subsets thereof.

• qhold – Holds back submitted jobs from execution.

• qhost – Displays status information about execution hosts.

• qlogin – Initiates a telnet or similar 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.

• qmod – Enables the owner to suspend or enable a queue. All currently active processes that are associated with this queue are also signaled.

• qmon – Provides an X Windows Motif command interface and monitoring facility.

• qresub – Creates new jobs by copying running or pending jobs.

• 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.

  • 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.

• 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.

• qstat – Provides a status listing of all jobs and queues associated with the cluster.

• 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.