Provided by: torque-client_2.4.16+dfsg-1build1_i386 bug

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.

         extra_resc
                Add additional string-type job resources.  They have no effect
                within TORQUE and are only advisible to the  scheduler.   They
                can  not be used for resources_default/min/max.  Format: list;
                default value: none.

         job_nanny
                Enables the "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.  Format: boolean; default value: false.

         job_start_timeout
                Specifies  the  pbs_server  to  pbs_mom  TCP socket timeout in
                seconds that is used when the pbs_server sends a job start  to
                the  pbs_mom.   It  is  useful when the mom has extra overhead
                involved  in  starting  jobs.   If  not  specified  then   the
                tcp_timeout value is used.

         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 overridden by the execution  queue  attribute  of  the
                same name.  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 overridden 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_body_fmt
                Override the default format for  the  body  of  outgoing  mail
                messages. A number of printf-like format specifiers and escape
                sequences can be used:

         \n     new line

         \t     horizontal tab

         \\     backslash

         \'     single quote

         \"     double quote

         %d     details concerning the message

         %h     PBS host name

         %i     PBS job identifier

         %j     PBS job name

         %m     long reason for message

         %r     short reason for message

         %%     a single %

         Format: a printf-like format string;  Default  value:  "PBS  Job  Id:
         %i\nJob Name:   %j\nExec host:  %h\n%m\n%d\n".

         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_subject_fmt
                Override the default format for the subject of  outgoing  mail
                messages. A number of printf-like format specifiers and escape
                sequences can be used:

         \n     new line

         \t     horizontal tab

         \\     backslash

         \'     single quote

         \"     double quote

         %d     details concerning the message

         %h     PBS host name

         %i     PBS job identifier

         %j     PBS job name

         %m     long reason for message

         %r     short reason for message

         %%     a single %

         Format: a printf-like format string; Default value: "PBS JOB %i".

         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 "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.
                Format: boolean; default value: true.

         next_job_number
                This  hidden  attribute  is used to allow a manager to set the
                value of the next job  ID  via  qmgr.  This  attribute  should
                rarely be modified. Some sites may find it useful if they need
                to recreate their pbs_server database (perhaps due to a format
                change between major TORQUE versions) and they keep a database
                of job information indexed by the job ID. The  manager  should
                be  careful to avoid setting the value to something that would
                allow the next job number  to  conflict  with  a  job  already
                queued,  however Torque will handle this in a sane manner: the
                job submission will be rejected and the next job  number  will
                be incremented.

         net_counter
                Lists  the 3 numbers representing the number of connections in
                the last 5 seconds, 30 seconds, and 60  seconds.   This  is  a
                read-only attribute.  Format: string; default value: none.

         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.

         sched_version
                A  string specifying the scheduler version.  Schedulers should
                check this string when starting and not become active  if  the
                wrong string is found.  This is ignored by pbs_server.

         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]

         tcp_timeout
                Specifies the pbs_server to  pbs_mom  TCP  socket  timeout  in
                seconds.  Format: integer; default value: 6.

       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)