Batch Queueing System

DESCRIPTION

The Batch Queueing System is a simple first-come first-serve queueing system. Any user can submit a job to be run. Users can kill and remove their own jobs. Only the root user can kill the server, kill other people's jobs, or remove other people's jobs. When BQS is restarted (i.e. after a system failure) then it will start/restart then first job in the queue assuming the job is restartable, else it continues on to the next job.

COMMAND LINE OPTIONS

HOW TO SUBMIT A JOB

To submit a job, do something similar the following:
# bqs
Batch Queueing System - Copyright (c) 1994 Boyd C. Fletcher and Old Dominion University
BQS Version 1.0.2
Trying to connect to server...|
Now connected to charybdis.ccpo.odu.edu
Command: submit
Enter relative path to executable (i.e. fluid not /home/user/fluid): test
Enter name of executable (i.e. a.out): run_pic
Enter your e-mail address (DEFAULT: boyd@ccpo.odu.edu):
Is your job restartable [Yes,No]? yes

PATH:        test
EXECUTABLE:  run_pic
EMAIL:       boyd@ccpo.odu.edu
RESTARTABLE: Yes

Submit job [Yes,No]? yes
Your Job ID is 781223547-1 and is the number 1 in the queue.

NOTE: This would run the job /home/boyd/test/run_pic

HOW TO GET HELP

To find out more about bqs, type: help at the Command: prompt in BQS.

WRITING A SHELL WRAPPER

I HIGHLY SUGGEST that all jobs have a shell script wrapper around them.

For example:

#!/bin/sh
exec /home/boyd/test/pic3 <  /home/boyd/test/myinput.file  > /home/boyd/test/pic3.out 2> /home/boyd/test/pic3.errors
NOTE: the 2> redirects directs stderror to the file pic3.errors.

ERROR MESSAGES

If you get the following error, it usually means that the server is down or the server is busy. Try again in a minute or two, if you still get this error send mail to root.
ERROR, Could not get peer name: Bad file number

BUGS

If you find any please send me mail.

COPYRIGHT

Copyright (c) 1994 Boyd Fletcher and Old Dominion University

AUTHOR

Boyd Fletcher
boyd@ccpo.odu.edu
Center For Coastal Physical Oceanography
Old Dominion University
Norfolk, VA 23529
USA

Press here to return to the Miscellaneous Menu