OVERVIEW

GNQS (a free sw that provides on unix systems standard batch queues) is the local Unix Batch Processing System. It has been installed on the following Central UNIX Cluster machines: to00xd, to01xd, to02xd, to03xd & to05xd.

On each machine, three queues were defined; for example, on to01xd:

  queue_name     max CPU time     max number of jobs  
fast
20 min
5
medium
4 h
4
slow
96 h
4


Users have a limit of 1 job per-queue and 2 jobs per-machine.

SUBMITTING A JOB

Write your job script (for example: /my-working-directory/my-nqs-job), using the following template:

cd /my-working-directory
exec-program1
exec-program2
...

Finally, submit your job by the following command:

qsub -q queue_name                               \
     -eo -ko -o /my-working-directory/STDOUT.log \
     -r JOB_NAME                                 \
     /my-working-directory/my-nqs-job
With the used flags, the file /my-working-directory/STDOUT.log will contain the standard output and the standard error of your job. However, for a command behaviour customization, many other flags are available. Please, for more information, read the related man pages.

SUGGESTIONS FOR THE LOGIN FILE OF NQS USERS

People using NQS batch system could take advantage from using a login script file that discriminates between interactive and batch mode.

The file shown below is just an example on how to implement this functionality for (t)csh users (.login).

Non-(t)csh users can follow the same scheme in their login command file.

##########################################################################
#
# Template of .login for NQS batch users.
#
##########################################################################

set path=($PATH)

#
# Put here things to be done either in batch or interactive mode
#

if ($?ENVIRONMENT) then

   if ($ENVIRONMENT == BATCH) then
      #
      # Put here things to be done in batch mode
      #
   endif
             
else
   #
   # Put here things to be done in interactive mode
   #
endif

###########################################################################

NQS COMMANDS BRIEF SUMMARY

qacct: display NQS accounting information.
qalter: modify NQS request parameters.
qcat: display NQS request output.
qdel: delete or signal NQS request(s).
qdev: display status of NQS devices.
qhold: hold NQS request(s).
qlimit: show supported batch limits, and shell strategy for the named host(s).
qmgr: NQS queue manager program.
qmsg: append message to NQS log or error files.
qpr: submit a hardcopy print request to NQS.
qresume: resume NQS request(s).
qrls: release NQS request(s).
qstat: display status of NQS queue(s).
qsub: submit an NQS batch request.
qsuspend: suspend NQS request(s).

For more information on the above commands, please, use the man pages.