BSCL: Submitting a job to DQS -- basic information

Submitting a job to DQS -- basic information

There are three utilities that you will need for submitting, monitoring, and deleting jobs. These are:

qsub3 submit jobs to the queueing system

qstat3 check the status of your job(s)

qdel3 delete a job from the queueing system

I've only included the basic options for job submission here, but more may be added in the future. For more information, please read the man pages for these utilities and ask questions.

qsub3

Description: qsub3 is the utility that allows you to submit a job to the queueing system

Syntax: qsub3 [-options] [script]

Basic Options: -cwd specifies that DQS should use the current working directory at execution time

Comments: If a script is not specified, qsub3 accepts commands from STDIN.
Returns information about the submission of your job

Sample job-submission script

qstat3

Description: qstat3 shows the status of DQS queues and jobs

Syntax: qstat3 [-options]

Basic Options: -f specifies that qstat3 should print extra information

Comments: returns the status of jobs that you have submitted. The -f option returns information about all queues and jobs in the system.

Sample output and what it means:

makosky@lt1 % qstat3
    rother   scr                      9    0   :  1 r      RUNNING   08/22/96 08:00:36 


----Pending Jobs ---------------------------------------------------------------
makosky  foo.sh         10    0   :  1                          QUEUED 08/22/96 08:43:36

In this case, rother has one job that is running (number 9) and makosky has one job that is waiting to be run (number 10 under the "pending jobs" section).

Job Listings (what the fields mean):

    rother   scr                      9    0   :  1 r      RUNNING   08/22/96 08:00:36

      ^       ^                       ^    ^^^^^^^^ ^         ^      ^^^^^^^^^^^^^^^^^
      |       |                       |        |    \         |             |
      |       |                       |        |     \        |             |
      |       |                       |        |      \       |             |
   owner     job                     job   scheduling  \      |          submision
   name     name                   number  parameters   \     |            time   
                                                        job status
                                                        indicators

Possible values for job status:

r	RUNNING
s	SUSPENDED
q	QUEUED
w	WAITING

Sample full output (using the -f option):

makosky@lt1 % qstat3 -f
Queue Name                       Queue Type    Quan  Load          State
----------                       ----------    ----  ----          -----
i12_m1                           batch         0/1   0.03  er     UP        
i12_test                         batch         0/1   0.03  er     UP        
i13_m1                           batch         1/1   1.31  er     UP        
    rother   scr                      9   0   :  1 r      RUNNING   08/22/96 08:00:36 
i14_m1                           batch         0/1   0.00  er     UP        
i2_m1                            batch         0/1   0.00  er     UP        
i3_m1                            batch         0/1   0.00  er     UP        
i7_m1                            batch         0/1   0.94  es     SUSPENDED 


----Pending Jobs ---------------------------------------------------------------
makosky  foo.sh         10   0   :  1                          QUEUED 08/22/96 08:43:36

qdel3

Description: delete a job from the queue

Syntax: qdel3 job_number

Basic Options: none

Comments: Returns a message indicating if your job was deleted or not. Jobs may take a few minutes to terminate and will continue to show up in the output of any qstat command until they do.

This information is available in alternative formats upon request by individuals with disabilities. Please send email to alt-format@msi.umn.edu or call 612-624-0528.

HOME | QUESTIONS | FEEDBACK
Events | Links | People | Publications | Support | Welcome

URL: http://www.msi.umn.edu /sdml/info/dqs/submit.html

This page last modified on Wednesday, 23-Apr-2008 11:14:47 CDT

Please direct questions or problems to help@msi.umn.edu

Website related questions or problems should be directed to webmaster@msi.umn.edu
The Supercomputing Institute does not collect personal information on visitors to our website. For the University of Minnesota policy, see www.privacy.umn.edu.

qsub3	submit jobs to the queueing system
qstat3	check the status of your job(s)
qdel3	delete a job from the queueing system

Description:	qsub3 is the utility that allows you to submit a job to the queueing system
Syntax:	`qsub3 [-options] [script]`
Basic Options:	`-cwd`	`specifies that DQS should use the current working directory at execution time`
Comments:	If a script is not specified, `qsub3` accepts commands from `STDIN`. Returns information about the submission of your job

Description:	qstat3 shows the status of DQS queues and jobs
Syntax:	`qstat3 [-options]`
Basic Options:	`-f`	`specifies that qstat3 should print extra information`
Comments:	returns the status of jobs that you have submitted. The -f option returns information about all queues and jobs in the system.

Description:	delete a job from the queue
Syntax:	`qdel3 job_number`
Basic Options:	`none`
Comments:	Returns a message indicating if your job was deleted or not. Jobs may take a few minutes to terminate and will continue to show up in the output of any `qstat` command until they do.