Provided by: torque-client-x11_2.4.15+dfsg-1_i386 bug

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 
                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)