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_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 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 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 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 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 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 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 The following attributes apply only to routing queues:
202 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 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 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 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 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 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 The following data items are read-only attributes of the queue. They
236 are visible to but cannot be changed by clients.
237 Items which apply to all types of queues are:
239 total_jobs
241 The number of jobs currently residing in the queue.
242 state_count
244 The total number of jobs currently residing in the queue in
245 each state.
246 These read-only attributes only apply to execution queues:
248 resources_assigned
250 The total amount of certain types of resources allocated to
251 jobs running from this queue.
252
254 the PBS ERS, qmgr(1B), pbs_resources(7B)
255Local pbs_queue_attributes(7B)