1pbs_queue_attributes(7B) PBS pbs_queue_attributes(7B)
2
6 pbs_queue_attributes - pbs queue attributes
7
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 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 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 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 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 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 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 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 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 Format: "[+|-]user[@host][,...]"; default value: all users
73 allowed.
74 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 default value: all types allowed.
81 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 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 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 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 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 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 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 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 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 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 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 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 The following attributes apply only to execution queues:
158 checkpoint_min §
160 Specifies the minimum interval of cpu time, in minutes, which
161 is allowed between checkpoints of a job. If a user specifies
162 a time less than this value, this value is used instead. For‐
163 mat: integer; default value: no minimum.
164 resources_available
166 The list of resource and amounts available to jobs running in
167 this queue. The sum of the resource of each type used by all
168 jobs running from this queue cannot exceed the total amount
169 listed here. Advisory to the Scheduler, not enforced by the
170 server. Format: "resources_available.resource_name=value",
171 see qmgr(1B).
172 keep_completed
174 Number of seconds to retain completed jobs in the C state.
175 This overrides the server attribute of the same name. EXPERI‐
176 MENTAL Format: integer; default value: 0.
177 kill_delay
179 The amount of the time delay between the sending of SIGTERM
180 and SIGKILL when a qdel command is issued against a running
181 job. This overrides the server attribute of the same name.
182 Format: integer seconds; default value: 2 seconds.
183 max_user_run
185 The maximum number of jobs owned by a single user that are
186 allowed to be running from this queue at one time. This
187 attribute is advisory to the Scheduler, it is not enforced by
188 the server. Format: integer; default value: none.
189 max_group_run
191 The maximum number of jobs owned by any users in a single
192 group that are allowed to be running from this queue at one
193 time. This attribute is advisory to the Scheduler, it is not
194 enforced by the server. Format: integer; default value: none.
195 The following attributes apply only to routing queues:
197 route_destinations
199 The list of destinations to which jobs may be routed.
200 [default value: none, should be set to at least one valid des‐
201 tination]
202 alt_router
204 If true, an site supplied, alternative job router function is
205 used to determine the destination for routing jobs from this
206 queue. Otherwise, the default, round-robin router is used.
207 Format: boolean (see acl_group_enable); default value: false.
208 route_held_jobs
210 If true, jobs with a hold type set may be routed from this
211 queue. If false, held jobs are not to be routed. Format:
212 boolean (see acl_group_enable); default value: false.
213 route_waiting_jobs
215 If true, jobs with a future execution_time attribute may be
216 routed from this queue. If false, they are not to be routed.
217 Format: boolean (see acl_group_enable); default value: false.
218 route_retry_time
220 Time delay between route retries. Typically used when the
221 network between servers is down. Format: integer seconds;
222 default value: {PBS_NET_RETRY_TIME} (30 seconds).
223 route_lifetime
225 The maximum time a job is allowed to exist in a routing queue.
226 If the job cannot be routed in this amount of time, the job is
227 aborted. If unset or set to a value of zero (0), the lifetime
228 is infinite. Format: integer seconds; default infinite.
229 The following data items are read-only attributes of the queue. They
231 are visible to but cannot be changed by clients.
232 Items which apply to all types of queues are:
234 total_jobs
236 The number of jobs currently residing in the queue.
237 state_count
239 The total number of jobs currently residing in the queue in
240 each state.
241 These read-only attributes only apply to execution queues:
243 resources_assigned
245 The total amount of certain types of resources allocated to
246 jobs running from this queue.
247
249 the PBS ERS, qmgr(1B), pbs_resources(7B)
250Local pbs_queue_attributes(7B)