Provided by:
torque-client_2.1.8+dfsg-0ubuntu3_i386 
NAME
pbs_server_attributes - pbs server attributes
DESCRIPTION
Server attributes can be read by any client; privilege is not required.
Most server attributes are alterable by a privileged client, run by a
user with administrator or operator privilege. Certain attributes
require the user to have full administrator privilege. The following
is a list of the server attributes.
acl_group_sloppy
This is a default value for the queue attribute of the same
name. Format: boolean, "TRUE", "True", "true", "Y", "y",
"1", "FALSE", "False", "false", "N", "n", "0"; default value:
false = disabled.
acl_host_enable
Attribute which when true directs the server to use the
acl_hosts access control lists. Requires full manager
privilege to set or alter. Format: boolean, "TRUE", "True",
"true", "Y", "y", "1", "FALSE", "False", "false", "N", "n",
"0"; default value: false = disabled.
acl_hosts
List of hosts which may request services from this server.
This list contains the network name of the hosts. Local
requests, i.e. from the server’s host itself, are aways
accepted even if the host is not included in the list. See
section 10.1, Authorization, in the PBS External Reference
Specification. Requires full manager privilege to set or
alter. Format: "[+|-]hostname.domain[,...]"; default value:
all hosts.
acl_logic_or
This is a default value for the queue attribute of the same
name. Format: boolean, "TRUE", "True", "true", "Y", "y",
"1", "FALSE", "False", "false", "N", "n", "0"; default value:
false = disabled.
acl_user_enable
Attribute which when true directs the server to use the
server level acl_users access list. Requires full manager
privilege to set or alter. Format: boolean (see
acl_group_enable); default value: disabled.
acl_users
List of users allowed or denied the ability to make any
requests of this server. See section 10.1, Authorization, in
the PBS External Reference Specification. If acl_user_enable
is set to true, only users listed in acl_users may submit to
or execute jobs in the queue. Requires full manager
privilege to set or alter. Format: "[+|-]user[@host][,...]";
default value: all users allowed.
acl_roots
List of super users who may submit to and execute jobs at
this server. If the job execution id would be zero (0), then
the job owner, root@host, must be listed in this access
control list or the job is rejected. Format:
"[+|-]user[@host][,...]"; default value: no root jobs
allowed.
allow_node_submit
Allow job submissions from compute nodes regardless of
ruserok(). Requires full manager privilege to set or alter.
Format: boolean; default value: disabled.
auto_node_np
Automatically configure a node’s np value based on the ncpus
value from the status update. Requires full manager
privilege to set or alter. Format: boolean; default value:
disabled.
comment
A text string which may be set by the scheduler or other
privileged client to provide information to the batch system
users. Format: any string; default value: none.
default_node
A node specification to use if there is no other supplied
specification. This attribute is only used by servers where
a nodes file exist in the server_priv directory providing a
list of nodes to the server. If the nodes file does not
exist, this attribute is not set by default and is ignored if
set. The default value allows for jobs to share a single
node. Format: a node specification string; default value:
1#shared.
default_queue
The queue which is the target queue when a request does not
specify a queue name. Format: a queue name; default value:
none, must be set to an existing queue.
down_on_error
Set a node’s state to "down" if MOM reports a message
beginning with the string "ERROR". This might interfere with
moab’s node error handling. See the HEALTH CHECK section in
pbs_mom(8B). This is an EXPERIMENTAL feature and may be
removed in the future. Format: boolean; default value:
false.
job_nanny
Enables the experimental "job deletion nanny" feature. All
job cancels will create a repeating task that will resend
KILL signals if the initial job cancel failed. Further job
cancels will be rejected with the message "job cancel in
progress." This is useful for temporary failures with a job’s
execution node during a job delete request. It is possible
that the job nanny might interfere with job restarts,
migrations, and checkpointing. This is an EXPERIMENTAL
feature and may be removed in the future. Format: boolean;
default value: false.
job_stat_rate
Moderates how often job stat requests will be issued from
pbs_server to the MOM daemons. If poll_jobs is unset or
false, then all jobs that haven’t been updated in
job_stat_rate seconds will trigger a stat request. If
poll_jobs is true, then all jobs will be updated every
job_stat_rate.
(see poll_jobs) On active clusters, 60 or 120 might be
reasonable. Default value: 45 seconds (PBS_RESTAT_JOB in
server_limits.h) Minimum value: 4 seconds (PBS_JOBSTAT_MIN
in server_limits.h)
keep_completed
Number of seconds to retain completed jobs in the C state.
This is overriden by the execution queue 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 is overriden by the execution queue attribute of
the same name. Format: integer seconds; default value: 2
seconds.
log_events
A bit string which specifies the type of events which are
logged, see the section on Event Logging in chapter 3 of the
ERS. Format: integer; default value: 511, all events.
log_file_max_size
If this is set to a value > 0 then pbs_server will roll the
current log file to logfile.1 when its size is greater than
or equal to the value of log_file_max_size. This value is
interpreted as kilobytes.
log_file_roll_depth
If this is set to a value >=1 and log_file_max_size is set
then pbs_server will continue rolling the log files to
logfile.log_file_roll_depth.
log_level
Controls the verbosity of server logs. This value ranges
from 0 to 7 with 7 representing maximum verbosity. Format:
integer; default value: 0, minimum verbosity.
mail_domain
Override the default domain for outgoing mail messages. If
set, emails will be addressed to "euser@mail_domain". If
unset, the job’s Job_Owner attribute will be used. Format: a
domain name; Default value: none.
mail_uid
The uid from which server generated mail is sent to users.
Format: integer uid; default value: 0 for root.
managers
List of users granted batch administrator privileges.
Format: user@host.sub.domain[,user@host.sub.domain...]. The
host, sub-domain, or domain name may be wild carded by the
use of an * character, see the description of user access
control lists in chapter 10.1.1 of the ERS. Requires full
manager privilege to set or alter. Default value: root on
the local host.
max_running
The maximum number of jobs allowed to be selected for
execution at any given time. Advisory to the Scheduler, not
enforced by the server. Format: integer.
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.
mom_job_sync
Enables the experimental "job sync on MOM" feature. When
MOMs send a status update, and it includes a list of jobs,
server will issue job deletes for any jobs that don’t
actually exist. This is an EXPERIMENTAL feature and may be
removed in the future. Format: boolean; default value:
false.
node_check_rate
In OpenPBS, this was the rate at which pbs_server would poll
each node. In TORQUE, nodes periodically send updates
without solicitation from pbs_server; this attribute is now
used as the maximum number of seconds allowed without an
update before pbs_server will consider the node down.
Format: integer; default value: 150
node_pack
Controls how multiple processor nodes are allocated to jobs.
If this attribute is set to true, jobs will be assigned to
the multiple processor nodes with the fewest free processors.
This packs jobs into the fewest possible nodes leaving
multiple processor nodes free for jobs which need many
processors on a node. If set to false, jobs will be
scattered across nodes reducing conflicts over memory between
jobs. If unset, the jobs are packed on nodes in the order
that the nodes are declared to the server (in the nodes
file). Default value: unset - assigned to nodes as nodes in
order that were declared.
operators
List of users granted batch operator privileges. Format of
the list is identical with managers above. Requires full
manager privilege to set or alter. Default value: root on
the local host.
poll_jobs
Controls how pbs_server will send job status requests to
MOMs. When unset or false, statjob requests from clients
(ie: qstat(1B) or the scheduler) may trigger job status
requests to MOMs and and must wait until the MOMs have
replied; this is suitable for small to medium sized clusters.
When set to true, pbs_server will send periodic job status
requests; this is suitable for busy clusters with lots of
jobs, lots of clients, qstat(1B) is too slow, or your
scheduler times out. (see job_stat_rate) Default value: TRUE
query_other_jobs
The setting of this attribute controls if general users,
other than the job owner, are allowed to query the status of
or select the job. Format: boolean (see acl_host_enable);
Requires full manager privilege to set or alter. default
value: false - users may not query or select jobs owned by
other users.
resources_available
The list of resource and amounts available to jobs run by
this server. The sum of the resource of each type used by
all jobs running by this server cannot exceed the total
amount listed here. Advisory to the Scheduler, not enforced
by the server. Format:
"resources_available.resource_name=value[,...]".
resources_cost
The cost factors of various types of resources. These values
are used in determining the order of releasing members of
synchronous job sets, see the section on Synchronize Job
Starts. For the most part, these value are purely arbitrary
and have meaning only in the relative values between systems.
The cost of the resources requested by a job is the sum of
the products of the various resources_cost s and the amount
of each resource requested by the job. It is not necessary
to assign a cost for each possible resource, only those which
the site wishes to be considered in synchronous job
scheduling. Format:
"resources_cost.resource_name=value[,...]"; default value:
none, cost of resource is not computed.
resources_default
The list of default resource values that are set as limits
for a job executing on this server when the job does not
specify a limit, and there is no queue default. Format:
"resources_default.resource_name=value[,...]"; default value:
no limit.
resources_max
The maximum amount of each resource which can be requested by
a single job executing on this server if there is not a
resources_max valued defined for the queue in which the job
resides. Format: "resources_max.resource_name=value[,...]";
default value: infinite usage.
scheduler_iteration
The time, in seconds, between iterations of attempts by the
batch server to schedule jobs. On each iteration, the server
examines the available resources and runnable jobs to see if
a job can be initiated. This examination also occurs
whenever a running batch job terminates or a new job is
placed in the queued state in an execution queue. Format:
integer seconds; default value: 10 minutes, set by
{PBS_SCHEDULE_CYCLE} in server_limits.h.
scheduling
Controls if the server will request job scheduling by the PBS
job scheduler. If true, the scheduler will be called as
required; if false, the scheduler will not be called and no
job will be placed into execution unless the server is
directed to do so by an operator or administrator. Setting
or resetting this attribute to true results in an immediate
call to the scheduler. For more information, see the section
Scheduler - Server Interaction in the PBS Administrator
Guide. Format: boolean (see acl_host_enable); default value:
value of -a option when server is invoked, if -a is not
specified, the value is recovered from the prior server run.
If it has never been set, the value is "false".
server_name
The name of the server which is the same as the host name.
If the hostname resolves to an external IP address, then set
this to a name that resolves to the internal IP.
submit_hosts
A list of hostnames allowed to submit jobs to this batch
server regardless of ruserok().
system_cost
An arbitrary value factored into the resource cost of any job
managed by this server for the purpose of selecting which
member of synchronous set is released first, see
resources_cost and section 3.2.2, Synchronize Job Starts.
[default value: none, cost of resource is not computed]
The following attributes are read-only, they are maintained by the
server and cannot be changed by a client.
resources_assigned
The total amount of certain types of resources allocated to
running jobs.
server_state
The current state of the server:
Active The server is running and will invoke the job
scheduler as required to schedule jobs for execution.
Idle The server is running but will not invoke the job
scheduler.
Scheduling
The server is running and there is an outstanding
request to the job scheduler.
Terminating
The server is terminating. No additional jobs will be
scheduled.
Terminating, Delayed
The server is terminating in delayed mode. The server
will not run any new jobs and will shutdown when the
last currently executing job completes.
state_count
The total number of jobs managed by the server currently in
each state.
total_jobs
The total number of jobs currently managed by the server.
PBS_version
The release version number of the server.
SEE ALSO
the PBS ERS, qmgr(1B), pbs_resources(7B)