pbs_queue_attributes(7B) | PBS | pbs_queue_attributes(7B) |
NAME¶
pbs_queue_attributes - pbs queue attributesDESCRIPTION¶
Queue public attributes are alterable on request by a client. The client must be acting for a user with administrator (manager) or operator privilege. Certain attributes require the user to have full administrator privilege before they can be modified. The following attributes apply to both queue types:Attribute which when true directs the server
to use the queue group access control list acl_groups . Format:
boolean, "TRUE", "True", "true", "Y",
"y", "1", "FALSE", "False",
"false", "N", "n", "0"; default value:
false = disabled. Search a job user's secondary groups if the effective group
doesn't match the group acl. Warning, this can be very slow and expensive.
Format: boolean, "TRUE", "True", "true",
"Y", "y", "1", "FALSE",
"False", "false", "N", "n",
"0"; default value: false = disabled. List which allows or denies
enqueuing of jobs owned by members of the listed groups. The groups in the
list are groups on the server host, not submitting hosts. If acl_group_enable
is set to true, only groups listed in the acl_groups attribute will be allowed
access to the queue. See section 10.1, Authorization, in the PBS External
Reference Specification. Format: "[+|-]group_name[,...]"; default
value: all groups allowed. Attribute which when true directs the server to use
the acl_hosts access list. Format: boolean (see acl_group_enable);
default value: disabled. List of hosts which may enqueue jobs in the queue.
See section 10.1, Authorization, in the PBS External Reference Specification.
Format: "[+|-]hostname[...]"; default value: all hosts allowed.
Modifies the way acls are applied if both acl_user_enable and
acl_group_enable are set to true. If acl_logic_or is true, then
user and group acls are logically OR'ed together (a job can pass either the
user or group acl lists to be allowed access to the queue). If I acl_logic_or
is false, then user and group acls are logically AND'ed together (a job would
have to pass both user and group acl lists). Format: boolean (see
acl_group_enable and acl_user_enable); default value: disabled. Attribute
which when true directs the server to use the the acl_users access list
for this queue. Format: boolean (see acl_group_enable); default value:
disabled. List of users allowed or denied the ability to enqueue jobs in this
queue. See section 10.1, Authorization, in the PBS External Reference
Specification. If acl_user_enable is set to true, only users listed in the
acl_groups attribute will be allowed access to the queue.
Format: "[+|-]user[@host][,...]"; default value: all users allowed.
List of job "types"
(interactive,batch,rerunable,nonrerunable,fault_tolerant,fault_intolerant)
that are not allowed in this queue.
default value: all types allowed. Queue will or will not accept new jobs. When
false the queue is disabled and will not accept jobs. Format: boolean (see
acl_group_enable); default value: disabled. When true, this queue will not
accept jobs except when being routed by the server from a local routing queue.
This is used to force user to submit jobs into a routing queue used to
distribute jobs to other queues based on job resource limits. Format: boolean;
default value: disabled. When true, jobs will be allowed into this queue that
do not fit server resource limitations. This is to allow the jobs to be routed
to a server that does have the appropriate resources. Any queue limits are
checked. The maximum number of jobs allowed to reside in the queue at any
given time. Format: integer; default value: infinite. The maximum number of
jobs owned by a single user that are allowed to reside in the queue at any
given time. Format: integer; default value: infinite. The maximum number of
jobs allowed to be selected from this queue for routing or execution at any
given time. For a routing queue, this is enforced, if set, by the server. For
an execution queue, this attribute is advisory to the Scheduler, it is not
enforced by the server. Format: integer. The priority of this queue against
other queues of the same type on this server. May affect job selection for
execution/routing. Advisory to the Scheduler, not used by the server. Format:
integer. The type of the queue: execution or route. Format:
"execution", "e", "route", "r". This
attribute must be explicitly set. The maximum amount of each resource which
can be requested by a single job in this queue. The queue value supersedes any
server wide maximum limit. Format:
"resources_max.resource_name=value", see qmgr(1B); default value:
infinite usage. The minimum amount of each resource which can be requested by
a single job in this queue. Format: see resources_max, default value: zero
usage. The list of default resource values which are set as limits for a job
residing in this queue and for which the job did not specify a limit. Format:
"resources_default.resource_name=value", see qmgr(1B); default
value: none; if not set, the default limit for a job is determined by the
first of the following attributes which is set: server's resources_default,
queue's resources_max, server's resources_max. If none of these are set, the
job will unlimited resource usage. Jobs may be scheduled for execution from
this queue. When false, the queue is considered stopped. Advisory to the
Scheduler, not enforced by the server. [default value: false, but depends on
scheduler interpretation] Format: boolean (see acl_group_enable).
The following attributes apply only to execution queues:
Specifies the minimum interval of cpu time, in
minutes, which is allowed between checkpoints of a job. If a user specifies a
time less than this value, this value is used instead. Format: integer;
default value: no minimum. The list of resource and amounts available to jobs
running in this queue. The sum of the resource of each type used by all jobs
running from this queue cannot exceed the total amount listed here. Advisory
to the Scheduler, not enforced by the server. Format:
"resources_available.resource_name=value", see qmgr(1B). Number of
seconds to retain completed jobs in the C state. This overrides the server
attribute of the same name. EXPERIMENTAL Format: integer; default value: 0.
The amount of the time delay between the sending of SIGTERM and SIGKILL when a
qdel command is issued against a running job. This overrides the server
attribute of the same name. Format: integer seconds; default value: 2 seconds.
The maximum number of jobs owned by a single user that are allowed to be
running from this queue at one time. This attribute is advisory to the
Scheduler, it is not enforced by the server. Format: integer; default value:
none. The maximum number of jobs owned by any users in a single group that are
allowed to be running from this queue at one time. This attribute is advisory
to the Scheduler, it is not enforced by the server. Format: integer; default
value: none.
The following attributes apply only to routing queues:
The list of destinations to which jobs may be
routed. [default value: none, should be set to at least one valid destination]
If true, an site supplied, alternative job router function is used to
determine the destination for routing jobs from this queue. Otherwise, the
default, round-robin router is used. Format: boolean (see acl_group_enable);
default value: false. If true, jobs with a hold type set may be routed from
this queue. If false, held jobs are not to be routed. Format: boolean (see
acl_group_enable); default value: false. If true, jobs with a future attribute
may be routed from this queue. If false, they are not to be routed. Format:
boolean (see acl_group_enable); default value: false. Time delay between route
retries. Typically used when the network between servers is down. Format:
integer seconds; default value: (30 seconds). The maximum time a job is
allowed to exist in a routing queue. If the job cannot be routed in this
amount of time, the job is aborted. If unset or set to a value of zero (0),
the lifetime is infinite. Format: integer seconds; default infinite.
The following data items are read-only attributes of the queue. They are visible
to but cannot be changed by clients.
Items which apply to all types of queues are:
The number of jobs currently residing in the
queue. The total number of jobs currently residing in the queue in each
state.
These read-only attributes only apply to execution queues:
The total amount of certain types of resources
allocated to jobs running from this queue.
SEE ALSO¶
the PBS ERS, qmgr(1B), pbs_resources(7B)Local |