Communicator e3000 MPE/iX Release 6.5 (Non-Platform Software Release C.65.00 (30216-90291)

Chapter 3 67
Growth Solution
User-Defined Job Queues and ALTJOB HIPRI Enhancements
New Commands
NEWJOBQ
Syntax:
NEWJOBQ qname [; limit =n]
The NEWJOBQ command creates a new job queue. SM/OP capability is required to execute
this command.
Limit is the only queue controlling property. The jobs in the queue are sorted by their
INPRI. In case of a tie for INPRI, jobs are sorted by their INTRO time.
The global limit takes precedence over individual queue limits. That is, even if a jobq has a
slot available, if the overall limit has been reached, jobs have to wait until one of the jobs
finishes or the global limit is increased. When a global slot becomes available, the next job
is picked from among the eligible jobqs (those which haven’t yet reached their individual
limits) using the following algorithm:
• Across all job queues, the highest INPRI job is selected. In case of a tie for INPRI, the
one which was introduced earliest is selected. There cannot be a tie in INTRO time.
• The job queues do not persist across reboots, unless a START RECOVERY is done. Any
other system starts will cause the job queues to be deleted and they will have to be
created again.
• This command is available in a session, job, or in BREAK. Pressing
[Break] has no effect
on this command. This command is not allowed in SYSSTART.
Parameters:
qname Name of the queue to be created. Queuename can contain only
alphanumeric characters. Queuename can be up to 8 characters in length;
longer names will not be accepted. If a queue of this name already exists,
an error is returned.
limit Maximum number of jobs that can be allowed in this queue. The limit
value can be changed using the :limit [+-]n;jobq= command. If
omitted, a value of zero is assumed.
Examples:
:NEWJOBQ MYJOBQ;limit=100