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 w ill
70 be allowed access to the queue.
71 Format: "[+|-]user[@host][,...]"; default value: all users
73 allowed.
74 enabled
76 Queue will or will not accept new jobs. When false the queue
77 is disabled and will not accept jobs. Format: boolean (see
78 acl_group_enable); default value: disabled.
79 from_route_only
81 When true, this queue will not accept jobs except when being
82 routed by the server from a local routing queue. This is used
83 to force user to submit jobs into a routing queue used to dis‐
84 tribute jobs to other queues based on job resource limits.
85 Format: boolean; default value: disabled.
86 max_queuable
88 The maximum number of jobs allowed to reside in the queue at
89 any given time. Format: integer; default value: infinite.
90 max_user_queuable
92 The maximum number of jobs owned by a single user that are
93 allowed to reside in the queue at any given time. Format:
94 integer; default value: infinite.
95 max_running
97 The maximum number of jobs allowed to be selected from this
98 queue for routing or execution at any given time. For a rout‐
99 ing queue, this is enforced, if set, by the server. For an
100 execution queue, this attribute is advisory to the Scheduler,
101 it is not enforced by the server. Format: integer.
102 Priority
104 The priority of this queue against other queues of the same
105 type on this server. May affect job selection for execu‐
106 tion/routing. Advisory to the Scheduler, not used by the
107 server. Format: integer.
108 queue_type
110 The type of the queue: execution or route. Format: "execu‐
111 tion", "e", "route", "r". This attribute must be explicitly
112 set.
113 resources_max
115 The maximum amount of each resource which can be requested by
116 a single job in this queue. The queue value supersedes any
117 server wide maximum limit. Format:
118 "resources_max.resource_name=value", see qmgr(1B); default
119 value: infinite usage.
120 resources_min
122 The minimum amount of each resource which can be requested by
123 a single job in this queue. Format: see resources_max,
124 default value: zero usage.
125 resources_default
127 The list of default resource values which are set as limits
128 for a job residing in this queue and for which the job did not
129 specify a limit. Format:
130 "resources_default.resource_name=value", see qmgr(1B); default
131 value: none; if not set, the default limit for a job is
132 determined by the first of the following attributes which is
133 set: server's resources_default, queue's resources_max,
134 server's resources_max. If none of these are set, the job
135 will unlimited resource usage.
136 started
138 Jobs may be scheduled for execution from this queue. When
139 false, the queue is considered stopped. Advisory to the
140 Scheduler, not enforced by the server. [default value: false,
141 but depends on scheduler interpretation] Format: boolean (see
142 acl_group_enable).
143 The following attributes apply only to execution queues:
145 checkpoint_min §
147 Specifies the minimum interval of cpu time, in minutes, which
148 is allowed between checkpoints of a job. If a user specifies
149 a time less than this value, this value is used instead. For‐
150 mat: integer; default value: no minimum.
151 resources_available
153 The list of resource and amounts available to jobs running in
154 this queue. The sum of the resource of each type used by all
155 jobs running from this queue cannot exceed the total amount
156 listed here. Advisory to the Scheduler, not enforced by the
157 server. Format: "resources_available.resource_name=value",
158 see qmgr(1B).
159 keep_completed
161 Number of seconds to retain completed jobs in the C state.
162 This overrides the server attribute of the same name. EXPERI‐
163 MENTAL Format: integer; default value: 0.
164 kill_delay
166 The amount of the time delay between the sending of SIGTERM
167 and SIGKILL when a qdel command is issued against a running
168 job. This overrides the server attribute of the same name.
169 Format: integer seconds; default value: 2 seconds.
170 max_user_run
172 The maximum number of jobs owned by a single user that are
173 allowed to be running from this queue at one time. This
174 attribute is advisory to the Scheduler, it is not enforced by
175 the server. Format: integer; default value: none.
176 max_group_run
178 The maximum number of jobs owned by any users in a single
179 group that are allowed to be running from this queue at one
180 time. This attribute is advisory to the Scheduler, it is not
181 enforced by the server. Format: integer; default value: none.
182 The following attributes apply only to routing queues:
184 route_destinations
186 The list of destinations to which jobs may be routed.
187 [default value: none, should be set to at least one valid des‐
188 tination]
189 alt_router
191 If true, an site supplied, alternative job router function is
192 used to determine the destination for routing jobs from this
193 queue. Otherwise, the default, round-robin router is used.
194 Format: boolean (see acl_group_enable); default value: false.
195 route_held_jobs
197 If true, jobs with a hold type set may be routed from this
198 queue. If false, held jobs are not to be routed. Format:
199 boolean (see acl_group_enable); default value: false.
200 route_waiting_jobs
202 If true, jobs with a future execution_time attribute may be
203 routed from this queue. If false, they are not to be routed.
204 Format: boolean (see acl_group_enable); default value: false.
205 route_retry_time
207 Time delay between route retries. Typically used when the
208 network between servers is down. Format: integer seconds;
209 default value: {PBS_NET_RETRY_TIME} (30 seconds).
210 route_lifetime
212 The maximum time a job is allowed to exist in a routing queue.
213 If the job cannot be routed in this amount of time, the job is
214 aborted. If unset or set to a value of zero (0), the lifetime
215 is infinite. Format: integer seconds; default infinite.
216 The following data items are read-only attributes of the queue. They
218 are visible to but cannot be changed by clients.
219 Items which apply to all types of queues are:
221 total_jobs
223 The number of jobs currently residing in the queue.
224 state_count
226 The total number of jobs currently residing in the queue in
227 each state.
228 These read-only attributes only apply to execution queues:
230 resources_assigned
232 The total amount of certain types of resources allocated to
233 jobs running from this queue.
234
236 the PBS ERS, qmgr(1B), pbs_resources(7B)
237Local pbs_queue_attributes(7B)