Provided by: torque-client_2.3.6+dfsg-0ubuntu3_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) 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.

          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)