Provided by:
torque-client_2.4.16+dfsg-1build1_i386 
NAME
pbs_queue_attributes - pbs queue attributes
DESCRIPTION
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:
acl_group_enable
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.
acl_group_sloppy
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.
acl_groups
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.
acl_host_enable
Attribute which when true directs the server to use the
acl_hosts access list. Format: boolean (see
acl_group_enable); default value: disabled.
acl_hosts
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.
acl_logic_or
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.
acl_user_enable
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.
acl_users
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.
disallowed_types
List of job "types"
(interactive,batch,rerunable,nonrerunable,fault_tolerant,fault_intolerant)
that are not allowed in this queue.
default value: all types allowed.
enabled
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.
from_route_only
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.
is_transit
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.
max_queuable
The maximum number of jobs allowed to reside in the queue at
any given time. Format: integer; default value: infinite.
max_user_queuable
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.
max_running
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.
Priority
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.
queue_type
The type of the queue: execution or route. Format:
"execution", "e", "route", "r". This attribute must be
explicitly set.
resources_max
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.
resources_min
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.
resources_default
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.
started
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:
checkpoint_min S
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.
resources_available
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).
keep_completed
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.
kill_delay
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.
max_user_run
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.
max_group_run
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:
route_destinations
The list of destinations to which jobs may be routed.
[default value: none, should be set to at least one valid
destination]
alt_router
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.
route_held_jobs
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.
route_waiting_jobs
If true, jobs with a future execution_time attribute may be
routed from this queue. If false, they are not to be routed.
Format: boolean (see acl_group_enable); default value: false.
route_retry_time
Time delay between route retries. Typically used when the
network between servers is down. Format: integer seconds;
default value: {PBS_NET_RETRY_TIME} (30 seconds).
route_lifetime
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:
total_jobs
The number of jobs currently residing in the queue.
state_count
The total number of jobs currently residing in the queue in
each state.
These read-only attributes only apply to execution queues:
resources_assigned
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)