Corresponding command between NQS and NQSII

Rev.05 December 5, 2003

 

Corresponding commands between SUPER-UX NQS and NQSII are shown in the table below.

(NOTE1) N/A means that there is no corresponding command.

(NOTE2) The options of qalter (except –k) are subset of qsub command in NQSII. Please refer to qsub section for the corresponding commands for NQS qalter.

SUPER-UX NQS

NQSII

Note for NQSII

qsub command

 

qsub -a

qsub -a date_time

The format for date_time is  [[[[CC]YY]MM]DD]hhmm[.SS].

qsub -ac

qsub -A account_string

The maximum size for account_string is 127 bytes.

qsub -c

qsub -l cpunum_prc=max_limit

 

qsub -ds

N/A

 

qsub -e

qsub -e [hostname:]path_name

The conversion letter, which starts with %, can be used for path_name.

qsub -eo

qsub –j o

 

qsub -hold

qsub -h

 

qsub -j

N/A

 

qsub -je

N/A

 

qsub -jm

N/A

 

qsub -jo

N/A

 

qsub -ke

N/A

 

qsub -ko

N/A

 

qsub -l0

qsub -l rlg0cap_job=["]max_limit[,warn_limit"]

The format for ???_limit is integer[.fraction][units].

qsub -l1

qsub -l rlg1cap_job=["]max_limit[,warn_limit"]

The format for ???_limit is integer[.fraction][units].

qsub -l2

qsub -l rlg2cap_job=["]max_limit[,warn_limit"]

The format for ???_limit is integer[.fraction][units].

qsub -l3

qsub -l rlg3cap_job=["]max_limit[,warn_limit"]

The format for ???_limit is integer[.fraction][units].

qsub -lc

qsub -l coresz_prc=["]max_limit[,warn_limit"]

The format for ???_limit is integer[.fraction][units].

qsub -ld

qsub -l datasz_prc=["]max_limit[,warn_limit"]

The format for ???_limit is integer[.fraction][units].

qsub -lD

qsub -l tapenum_job=max_limit

 

qsub -le

qsub -l resnum_prc=max_limit

 

qsub -lE

qsub -l resnum_job=max_limit

 

qsub -lf

qsub -l filesz_prc=["]max_limit[,warn_limit"]

The format for ???_limit is integer[.fraction][units].

qsub -lm

qsub -l memsz_prc=["]max_limit[,warn_limit"]

The format for ???_limit is integer[.fraction][units].

qsub -lM

qsub -l memsz_job=["]max_limit[,warn_limit"]

The format for ???_limit is integer[.fraction][units].

qsub -ln

N/A

 

qsub -lo

qsub -l filenum_prc=max_limit

 

qsub -lO

qsub -l filenum_job=max_limit

 

qsub -lP

qsub -l procnum_job=max_limit

 

qsub -lr

qsub -l restim_prc=["]max_limit[,warn_limit"]

The format for ???_limit is [[hours:]minutes:]seconds[.fraction].

qsub -lR

qsub -l restim_job=["]max_limit[,warn_limit"]

The format for ???_limit is [[hours:]minutes:]seconds[.fraction].

qsub -ls

qsub -l stacksz_prc=["]max_limit[,warn_limit"]

The format for ???_limit is integer[.fraction][units].

qsub -lt

qsub -l cputim_prc=["]max_limit[,warn_limit"]

The format for ???_limit is [[hours:]minutes:]seconds[.fraction].

qsub -lT

qsub -l cputim_job=["]max_limit[,warn_limit"]

The format for ???_limit is [[hours:]minutes:]seconds[.fraction].

qsub -lu

qsub -l tasknum_prc=max_limit

 

qsub -lV

qsub -l tempcap_job=["]max_limit[,warn_limit"]

The format for ???_limit is integer[.fraction][units].

qsub -lx

qsub -l filecap_prc=["]max_limit[,warn_limit"]

The format for ???_limit is integer[.fraction][units].

qsub -lX

qsub -l filecap_job=["]max_limit[,warn_limit"]

The format for ???_limit is integer[.fraction][units].

qsub -lZ

qsub -l elapstim_req=["]max_limit[,warn_limit"]

The format for ???_limit is [[hours:]minutes:]seconds[.fraction].

qsub -mb

qsub -mb

 

qsub -me

qsub -me

 

qsub -mu

qsub -M mail_list

The format for mail_list is mail_address[,mail_address, ...]  and the maximum length is 1023 bytes.

qsub -nc

qsub -c=0 (or -cn)

The periodic checkpoint will be off with –c=0 option. The periodic check point will be taken with default interval of the queue when -c=c is set. The periodic check point will be taken in the interval which is set at –c=XXXX. The unit is minutes. (For NQSII R2.00 or later)

qsub -nr

qsub –r n

Job not to be re-run.

qsub -o

qsub -o [hostname:]path_name

The conversion letter, which starts with %, can be used for path_name. 

qsub -p

qsub -p priority

The range for priority is the integer between -1024 and 1023

qsub -q

qsub -q destination

 

qsub -r

qsub -N name

The maximum length of name is 63bytes.

qsub -re

N/A

 

qsub -ro

N/A

 

qsub -s

qsub -S pathname

The maximum value for pathname is 1023bytes

qsub -x

qsub -V

 

qsub -z

qsub -z

 

qsub -Z

qsub -Z

 

N/A

qsub -b batch_job_count

The batch_job_count is the number of jobs to be created.

N/A

qsub -B ["]job_condition[","job_condition"...]

The condition to execute batch jobs is specified. (For NQSII R2.00 or later)

N/A

qsub -C directive_prefix

The directives for embedded option in scripts are specified.

N/A

qsub -H y|n

The option specifies if the batch request can be held.

N/A

qsub -I "stage_in"[,"stage_in"...]

The option specifying files to stag in. (For NQSII R2.00 or later)

N/A

qsub -O "stage_out"[,"stage_out"...]

The option specifying files to stage out. (For NQSII R2.00 or later)

N/A

qsub -P privilege

The access privilege for NQSII system is specified.

N/A

qsub -R

The version of command and API is shown. (For NQSII R2.00 or later) 

N/A

qsub -T batch_job_topology

The mode of the batch job to be executed is specified. The modes are either distrib or mpisx.

N/A

qsub -v variable_list

The environment variables for the batch job are specified.

qalter command

 

N/A

qalter -K kernel_param_list[,kernel_param_list,...]

The kernel parameters for batch requests are specified.

 

SUPER-UX NQS

NQSII

Note for NQSII

qstat command

 

qstat -a

qstat -P [o|m]

The privilege of NQSII operator or above is required to show all users’ batch requests.

qstat -u

qstat -u userlist

The batch requests of specified users in userlist are shown. (For NQSII R2.00 or later) 

qstat -m

qstat

The summary of batch requests is shown. The format to be shown is different between NQS and NQSII.

qstat -l

qstat -f

The detailed information of the batch request is shown. The shown information is different between NQS and NQSII.

qstat -x

qstat -Qf

The detailed queue information is shown. The shown information is different between NQS and NQSII.

N/A

qstat -B[Pfn]

The batch server information is shown.

N/A

qstat -D[Pfn]

The batch scheduler information is shown. (For NQSII R2.00 or later) 

N/A

qstat -E[Pfn]

The execution host’s information is shown.

N/A

qstat -J[Pfn]

The batch job information is shown.

N/A

qstat -S[Pfn]

The job server information is shown.

N/A

qstat -V

The version of command and API is shown. (For NQSII R2.00 or later)  

qstatr command

 

qstatr -a

qstat -P [o|m]

The privilege of NQSII operator or above is required to show all users’ batch requests.

qstatr -u

qstat -u userlist

The batch requests of specified users in userlist are shown. (For NQSII R2.00 or later) 

qstatr -b

qstat  AND qstat –f

Update 4-12-2003 [Note: req #2890 of Nov/2003]

qstatr -c

N/A

 

qstatr -d

N/A

 

qstatr -N

qstat -T

The network request information is shown. (NQSII R2.00 or later)

qstatr -R

N/A

 

qstatr -f

qstat -f

The detailed information of the batch request is shown. The shown information is different between NQS and NQSII.

qstatr -l

N/A

 

qstatr -n

qstat -n

 

qstatr -F

N/A

 

qstatr -h

qstat @batch_server_host

The batch requests on the hosts specified at @batch_server_host are shown.

qstatr -r

N/A

 

qstatr -t

N/A

 

qstatq command

 

qstatq -b

qstat -Qe

The only execution queue information is shown.

qstatq -d

N/A

 

qstatq -p

qstat -Qr

The only routing queue information is shown.

qstatq -N

qstat -QN

The only network queue information is shown.

qstatq -f

qstat -Qf

The detailed information of the queue is shown. The shown information is different between NQS and NQSII.

qstatq -L

N/A

 

qstatq -n

qstat -Qn

 

qstatq -h

qstat -Q @batch_server_host

The queue on the hosts specified at @batch_server_host is shown.

qstatck command

 

qstatck

qstat -C[Pfn]

The restart file information of each batch job is shown. (For NQSII R2.00 or later)

The other commands

 

qstata

N/A

 

qstatc

N/A

 

qstatd

N/A

 

qstatf

N/A

 

 

SUPER-UX NQS

NQSII

Note for NQSII

qdel command

 

qdel

qdel

The current batch request status is canceled and deleted.

qsig

The signal is sent to specified batch job.

qdel -k

qdel [-g grace]

SIGTERM signal will be sent to all batch job. SIGKILL process will be sent after the specified period at grace.

qdel -signo

qsig [-s signal]

The specified signal at signal will be sent to the batch job.

qdel -R

N/A

 

qdel -s

N/A

 

N/A

qdel -P

The privilege on NQSII system is specified.

N/A

qdel -V

The version of command and API is shown. (NQSII R2.00 or later)

N/A

qsig -P

The privilege on NQSII system is specified.

N/A

qsig -V

The version of command and API is shown. (NQSII R2.00 or later)

qspnd command

 

qspnd

qsig -s STOP

The batch request or batch job is suspended.

qspnd -u

N/A

 

qspnd -r

N/A

 

qrsm command

 

qrsm

qsig -s CONT

The batch request or batch job is resumed.

qrsm -u

N/A

 

qrsm -r

N/A

 

qhold command

 

qhold

qhold

The specified batch request will be held.

qhold -F

N/A

 

qhold -u

N/A

 

qhold -r

N/A

 

N/A

qhold -P

The privilege on NQSII system is specified.

N/A

qhold -V

The version of command and API is shown. (NQSII R2.00 or later)

qrls command

 

qrls

qrls

The specified batch request will be released.

qrls -u

N/A

 

qrls -r

N/A

 

N/A

qrls -P

The privilege on NQSII system is specified.

N/A

qrls -V

The version of command and API is shown. (NQSII R2.00 or later)

qmove command

 

qmove

qmove

The batch request will be moved to the specified batch queue.

qmove -q

qmove -q i-destination

All the requests in the batch queue specified at i-destination will be moved to the specified batch queue.

qmove –u

N/A

 

qmove –r

N/A

 

N/A

qmove -P

The privilege on NQSII system is specified.

N/A

qmove -V

The version of command and API is shown. (NQSII R2.00 or later)

qrrun command

 

Qrerun

qrerun [-g grace]

The batch request will be stopped and re-registered to current queue. After SIGTERM signal will be sent to all batch requests, SIGKILL signal will be sent after the period specified at grace second.

qrerun –u

N/A

 

qrerun –r

N/A

 

N/A

qrerun -P

The privilege on NQSII system is specified.

N/A

qrerun -V

The version of command and API is shown. (NQSII R2.00 or later)

qwait command

 

Qwait

qwait

The batch request waits other requests termination.

qwait –f

qwait -f

 

qwait –t

qwait -t timeout

The request will be timed out after the period specified at timeout second.

qwait –r

N/A

 

N/A

qwait -P

The privilege on NQSII system is specified.

N/A

qwait -V

The version of command and API is shown. (NQSII R2.00 or later)

The other command

 

qcat

N/A

 

qchk

N/A

 

qrst

N/A

 

qdev

N/A

 

qlimit

N/A

 

qmsg

N/A

 

qpr

N/A

 

qwatch

N/A

 

 

COMPULSORY NQSII JOB PARAMETERS

to prevent job failure due to insufficient Memory/CPU resources:

#PBS -l cputim_job=...         #old form -lT

#PBS -l memsz_job=xxmb      #old form -lM

Update 5-12-2003: Req #2978

These two are compulsory in every job.

 

 

SAMPLE JOB:

 

#PBS -q queuename

#PBS -S /bin/sh

#PBS -l memsz_job=10Mb

#PBS -l memsz_prc=10Mb

#PBS -l cputim_job=30  

#PBS -l cputim_prc=30  

#PBS -cn

#PBS -jo

#PBS -o myoutputfile

#PBS -N testnqsII

 

 

 

Subject: NQS settings on SX6

default settings for NQS parameters under nqsII on SX-6 have

been modified and you should ensure you ALWAYS set the NQS parameters

to what you require and NOT rely on defaults for job and process

resources including cputime, memory and #cpus.

Otherwise your job may crash or not run or not get any time if it starts

The set of parameters and some values I use are

#PBS -N lp375pr              ## job name

#PBS -q pbms                 ## queue, either pbms or pbml

#PBS -j o                    ## job error and standard output in same file

#PBS -o /bm/data/rab/runs/laps_pt375/outpre   ## job output file

#PBS -l cputim_prc=1000      ## process time limit

#PBS -l cputim_job=1010      ## whole of job time limit

#PBS -l memsz_prc=6000Mb     ## process max memory size

#PBS -l memsz_job=6000Mb     ## whole of job max memory size

#PBS -l cpunum_prc=2         ## #cpus for process

#PBS -l tasknum_prc=2        ## #tasks for process usually same as #cpus

#PBS -l coresz_prc=0         ## limit on size of core file

 

If you need to specify the shell then add

#PBS -S /usr/bin/csh  OR  /sbin/csh  OR  /usr/bin/ksh  OR  /sbin/ksh  etc

otherwise you get your login shell.

 

Other parameters may be needed for specific types of jobs such as mpi

or noholding, in which case do man qsub on tx7 or sx6 and read carefully.

 

Subject: NQS settings on SX6

William Wang had an interesting failure of the scripts on the SMS scheduler.

The scipts worked last week with NQS settings:

#PBS -q pbml # on sxnqs            # @$-q pbml # on sx6

#PBS -S /sbin/ksh                  # @$-s /bin/ksh

#PBS -l memsz_job=15.9gb            # @$-lM 8.9GB

#PBS -l cputim_job=19000            #old form -lT

#PBS -l tasknum_prc=2

#PBS -l cpunum_prc=2

#PBS -H n

#PBS -T distrib

 

 

 

This no longer works and he has had to modify his scripts to include both

job and per process limits in the NQS options as follows:

#PBS -q pbml # on sxnqs       # @$-q pbml # on sx6

#PBS -S /sbin/ksh             # @$-s /bin/ksh

#PBS -l memsz_job=15.9gb      # @$-lM 8.9GB

#PBS -l memsz_prc=15.9gb      # @$-lM 8.9GB

#PBS -l cputim_job=19000      #old form -lT

#PBS -l cputim_prc=19000      #old form -lT

#PBS -l tasknum_prc=2

#PBS -l cpunum_prc=2

#PBS -H n

#PBS -T distrib

#include include/nqs.h

%include include/nqsII.h