1pbs_queue_attributes(7B)              PBS             pbs_queue_attributes(7B)
2
3
4

NAME

6       pbs_queue_attributes - pbs queue attributes
7

DESCRIPTION

9       Queue  public  attributes  are  alterable  on request by a client.  The
10       client must be acting for a user with administrator (manager) or opera‐
11       tor privilege.  Certain attributes require the user to have full admin‐
12       istrator  privilege  before  they  can  be  modified.   The   following
13       attributes apply to both queue types:
14
15         acl_group_enable
16                Attribute  which when true directs the server to use the queue
17                group access  control  list  acl_groups  .   Format:  boolean,
18                "TRUE",  "True",  "true",  "Y",  "y",  "1",  "FALSE", "False",
19                "false", "N", "n", "0"; default value: false = disabled.
20
21         acl_group_sloppy
22                Search a job user's secondary groups if  the  effective  group
23                doesn't  match  the group acl.  Warning, this can be very slow
24                and expensive.  Format: boolean, "TRUE", "True", "true",  "Y",
25                "y",  "1",  "FALSE",  "False", "false", "N", "n", "0"; default
26                value: false = disabled.
27
28         acl_groups
29                List which allows or denies enqueuing of jobs owned by members
30                of  the  listed  groups.  The groups in the list are groups on
31                the server host, not submitting hosts.  If acl_group_enable is
32                set  to  true,  only groups listed in the acl_groups attribute
33                will be allowed access to the queue.  See section 10.1, Autho‐
34                rization,  in  the PBS External Reference Specification.  For‐
35                mat:  "[+|-]group_name[,...]";  default  value:   all   groups
36                allowed.
37
38         acl_host_enable
39                Attribute  which  when  true  directs  the  server  to use the
40                acl_hosts    access    list.      Format:     boolean     (see
41                acl_group_enable); default value: disabled.
42
43         acl_hosts
44                List  of  hosts which may enqueue jobs in the queue.  See sec‐
45                tion 10.1, Authorization, in the PBS External Reference Speci‐
46                fication.   Format:  "[+|-]hostname[...]";  default value: all
47                hosts allowed.
48
49         acl_logic_or
50                Modifies the way acls are applied if both acl_user_enable  and
51                acl_group_enable  are  set  to true.  If acl_logic_or is true,
52                then user and group acls are logically OR'ed together  (a  job
53                can  pass  either  the  user  or group acl lists to be allowed
54                access to the queue).  If I acl_logic_or is false,  then  user
55                and group acls are logically AND'ed together (a job would have
56                to pass both user and group acl lists).  Format: boolean  (see
57                acl_group_enable  and  acl_user_enable);  default  value: dis‐
58                abled.
59
60         acl_user_enable
61                Attribute which when true directs the server to  use  the  the
62                acl_users  access  list  for this queue.  Format: boolean (see
63                acl_group_enable); default value: disabled.
64
65         acl_users
66                List of users allowed or denied the ability to enqueue jobs in
67                this  queue.   See  section  10.1,  Authorization,  in the PBS
68                External Reference Specification.  If acl_user_enable  is  set
69                to true, only users listed in the acl_groups attribute will be
70                allowed access to the queue.
71
72                Format: "[+|-]user[@host][,...]";  default  value:  all  users
73                allowed.
74
75         disallowed_types
76                List  of  job  "types"  (interactive,batch,rerunable,nonrerun‐
77                able,fault_tolerant,fault_intolerant) that are not allowed  in
78                this queue.
79
80                default value: all types allowed.
81
82         enabled
83                Queue  will or will not accept new jobs.  When false the queue
84                is disabled and will not accept jobs.   Format:  boolean  (see
85                acl_group_enable); default value: disabled.
86
87         from_route_only
88                When  true,  this queue will not accept jobs except when being
89                routed by the server from a local routing queue.  This is used
90                to force user to submit jobs into a routing queue used to dis‐
91                tribute jobs to other queues based  on  job  resource  limits.
92                Format: boolean; default value: disabled.
93
94         is_transit
95                When  true,  jobs  will be allowed into this queue that do not
96                fit server resource limitations. This is to allow the jobs  to
97                be   routed  to  a  server  that  does  have  the  appropriate
98                resources.  Any queue limits are checked.
99
100         max_queuable
101                The maximum number of jobs allowed to reside in the  queue  at
102                any given time.  Format: integer; default value: infinite.
103
104         max_user_queuable
105                The  maximum  number  of  jobs owned by a single user that are
106                allowed to reside in the queue at  any  given  time.   Format:
107                integer; default value: infinite.
108
109         max_running
110                The  maximum  number  of jobs allowed to be selected from this
111                queue for routing or execution at any given time.  For a rout‐
112                ing  queue,  this  is enforced, if set, by the server.  For an
113                execution queue, this attribute is advisory to the  Scheduler,
114                it is not enforced by the server.  Format: integer.
115
116         Priority
117                The  priority  of  this queue against other queues of the same
118                type on this server.  May  affect  job  selection  for  execu‐
119                tion/routing.   Advisory  to  the  Scheduler,  not used by the
120                server.  Format: integer.
121
122         queue_type
123                The type of the queue: execution or  route.   Format:  "execu‐
124                tion",  "e",  "route", "r".  This attribute must be explicitly
125                set.
126
127         resources_max
128                The maximum amount of each resource which can be requested  by
129                a  single  job  in this queue.  The queue value supersedes any
130                server       wide        maximum        limit.         Format:
131                "resources_max.resource_name=value",   see  qmgr(1B);  default
132                value: infinite usage.
133
134         resources_min
135                The minimum amount of each resource which can be requested  by
136                a  single  job  in  this  queue.   Format:  see resources_max,
137                default value: zero usage.
138
139         resources_default
140                The list of default resource values which are  set  as  limits
141                for a job residing in this queue and for which the job did not
142                specify             a             limit.               Format:
143                "resources_default.resource_name=value", see qmgr(1B); default
144                value: none;  if not set, the  default  limit  for  a  job  is
145                determined  by  the first of the following attributes which is
146                set:  server's   resources_default,   queue's   resources_max,
147                server's  resources_max.   If  none  of these are set, the job
148                will unlimited resource usage.
149
150         started
151                Jobs may be scheduled for execution  from  this  queue.   When
152                false,  the  queue  is  considered  stopped.   Advisory to the
153                Scheduler, not enforced by the server.  [default value: false,
154                but  depends on scheduler interpretation] Format: boolean (see
155                acl_group_enable).
156
157       The following attributes apply only to execution queues:
158
159         checkpoint_defaults
160                Specifies the queues default checkpointing values to  be  used
161                for  a  job  that  does  not have any checkpointing specified.
162                Format: string; default value: none.
163
164         checkpoint_min
165                Specifies the minimum interval of cpu time, in minutes,  which
166                is  allowed between checkpoints of a job.  If a user specifies
167                a time less than this value, this value is used instead.  For‐
168                mat: integer; default value: no minimum.
169
170         resources_available
171                The  list of resource and amounts available to jobs running in
172                this queue.  The sum of the resource of each type used by  all
173                jobs  running  from  this queue cannot exceed the total amount
174                listed here.  Advisory to the Scheduler, not enforced  by  the
175                server.    Format:  "resources_available.resource_name=value",
176                see qmgr(1B).
177
178         keep_completed
179                Number of seconds to retain completed jobs  in  the  C  state.
180                This overrides the server attribute of the same name.  EXPERI‐
181                MENTAL Format: integer; default value: 0.
182
183         kill_delay
184                The amount of the time delay between the  sending  of  SIGTERM
185                and  SIGKILL  when  a qdel command is issued against a running
186                job.  This overrides the server attribute of  the  same  name.
187                Format: integer seconds; default value: 2 seconds.
188
189         max_user_run
190                The  maximum  number  of  jobs owned by a single user that are
191                allowed to be running from  this  queue  at  one  time.   This
192                attribute  is advisory to the Scheduler, it is not enforced by
193                the server.  Format: integer; default value: none.
194
195         max_group_run
196                The maximum number of jobs owned by  any  users  in  a  single
197                group  that  are  allowed to be running from this queue at one
198                time.  This attribute is advisory to the Scheduler, it is  not
199                enforced by the server.  Format: integer; default value: none.
200
201       The following attributes apply only to routing queues:
202
203         route_destinations
204                The  list  of  destinations  to  which  jobs  may  be  routed.
205                [default value: none, should be set to at least one valid des‐
206                tination]
207
208         alt_router
209                If  true, an site supplied, alternative job router function is
210                used to determine the destination for routing jobs  from  this
211                queue.   Otherwise,  the  default, round-robin router is used.
212                Format: boolean (see acl_group_enable); default value: false.
213
214         route_held_jobs
215                If true, jobs with a hold type set may  be  routed  from  this
216                queue.   If  false,  held  jobs are not to be routed.  Format:
217                boolean (see acl_group_enable); default value: false.
218
219         route_waiting_jobs
220                If true, jobs with a future execution_time  attribute  may  be
221                routed  from this queue.  If false, they are not to be routed.
222                Format: boolean (see acl_group_enable); default value: false.
223
224         route_retry_time
225                Time delay between route retries.   Typically  used  when  the
226                network  between  servers  is  down.  Format: integer seconds;
227                default value: {PBS_NET_RETRY_TIME} (30 seconds).
228
229         route_lifetime
230                The maximum time a job is allowed to exist in a routing queue.
231                If the job cannot be routed in this amount of time, the job is
232                aborted.  If unset or set to a value of zero (0), the lifetime
233                is infinite.  Format: integer seconds; default infinite.
234
235       The  following  data items are read-only attributes of the queue.  They
236       are visible to but cannot be changed by clients.
237
238       Items which apply to all types of queues are:
239
240         total_jobs
241                The number of jobs currently residing in the queue.
242
243         state_count
244                The total number of jobs currently residing in  the  queue  in
245                each state.
246
247       These read-only attributes only apply to execution queues:
248
249         resources_assigned
250                The  total  amount  of certain types of resources allocated to
251                jobs running from this queue.
252

SEE ALSO

254       the PBS ERS, qmgr(1B), pbs_resources(7B)
255
256
257
258Local                                                 pbs_queue_attributes(7B)
Impressum