This section describes the uxaddque command used to create a batch queue.
The uxaddque command defines a new physical or logical queue. The batch queue is created with a disabled status and must therefore be started before it can be used.
When physical queues are associated with logical queues, there is no verification that the physical queue exists because it may have been created on a remote node. It is advisable therefore to make sure that any physical queues called do actually exist.
The default Environment can be changed.
The command syntax is as follows:
uxaddque QUEUE=queue [GENE] [LSTQUE="node:queue,node:queue,…"] [JOBLIM=nnn] [MAXSEC=seconds] [PERSEC=seconds] [BASPRI=nnn] [ADDPRI=nnn] [MAXPRI=nnn] [EXEPRI=nnn] [SECPRI|NOSECPRI] [LSTMU="mu:jobsnumber,mu:jobsnumber,…"]
Description of Items
QUEUE=
Name of the batch queue.
Format: 31 alphanumeric characters.
GENE
(Optional) Indicates the creation of a logical batch queue.
LSTQUE=
(Optional) List all physical queues associated with the logical queue QUEUE. Each physical queue should be preceded by its node of residence.
Format: "node1:queue1,node2:queue2,…". The order of this list is identical to the one used by the DQM server to dispatch the jobs.
JOBLIM=
(Optional) Maximum number of jobs executable concurrently in the batch queue or, in the case of a Logical queue in all associate physical queues. Once this limit has been reached jobs will enter the queue in a “pending” state.
Format: integer between 0 and 999
Default: 0
MAXSEC=
(Optional) Physical queue only. Retention delay (seconds): If a job is present in the batch queue for a duration greater than or equal to MAXSEC, it gets the highest priority of the queue and can thus run at the earliest.
Format: integer
PERSEC=
(Optional) Physical queue only. Number of seconds determining the revision cycle of the job's sequence priority within the queue. Every PERSEC seconds, the job priority is increased by the value of ADDPRI, starting at the base sequence priority, and up to the MAXPRI.
Format: integer
BASPRI=
(Optional) Physical queue only. Default sequence priority of a job in a batch queue.
Format: integer between 0 and 255
Default=0.
ADDPRI=
(Optional) Physical queue only. Value of the increments to a job's priority in the dynamic sequence priority management mode.
Format: integer between 0 and 255
Default=0.
MAXPRI=
(Optional) Physical queue only. Maximum job priority in the queue. Jobs with this priority are run as soon as the joblim permits.
Format: integer between 0 and 255
Default=0.
EXEPRI=
(Optional) Physical queue only. Default execution priority of jobs in this queue.
Format: integer between 0 and 255
Default=0.
SECPRI | NOSECPRI
(Optional) management of secondary priority
Secondary priority means that jobs with the same submission priority will be considered not on their Entry number but on their session number. In this way jobs in the first session will be able to finish before the second session can start processing.
Default=NOSECPRI
LSTMU=
(Optional) List of the job limits imposed by Management unit for the current queue. Management units in the list will be guaranteed the specified number of concurrent processing slots whenever there are jobs pending in the queue.
Format : "mu:jobsnumber,mu:jobsnumber,…" with:
Examples
When executed in a Uproc script, this command creates a physical queue with a name obtained from the management unit code and the processing date interpreted dynamically during execution of the Uproc, which allows this script to be distributed without needing to be adapted.
$UNI_DIR_EXEC/uxaddque QUEUE="${S_CODUG}_${S_DATRAIT}" JOBLIM=1 MAXSEC=3600 PERSEC=3600 BASPRI=1 ADDPRI=1 MAXPRI=255 EXEPRI=20
This command creates the logical batch queue LOG_QUEUE in the current environment and associates it with the following physical queues: SYS_BATCH and PHYS1 on the node saturn, PHYS2 on the node uranus.
%UNI_DIR_EXEC%\uxaddque QUEUE=LOG_QUEUE GENE LSTQUE="saturn:SYS_BATCH,saturn:PHYS1,uranus:PHYS2"
This command will create a physical queue supporting 10 concurrent jobs in all. Management units C_UK, C_FRANCE and C_SPAIN are all guaranteed at least 2 concurrent jobs when the queue is loaded. All M.U.s (including those specified in the list) will compete for the remaining capacity (4 jobs).
%UNI_DIR_EXEC%\uxaddque QUEUE=PHY_QUEUE LSTMU=”C_UK:2,C_FRANCE:2,C_SPAIN:2” JOBLIM=10