NAME
	  pbs_server_attributes	- PBS server attributes

     DESCRIPTION
	  Server attributes are	alterable on request by	a client.  The
	  client must be acting	for 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_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
		 Specificaiton.	 Requires full manager privilege to
		 set or	alter.	Format:	"[+|-]hostname.domain[,...]";
		 default value:	all hosts.

	    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
		 Specificaiton.	 Requires full manager privilege to
		 set or	alter.	Format:	"[+|-]user[@host][,...]";
		 default value:	all users allowed.

	    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.

	    log_events
		 A bit string which specifies the type of events which
		 are logged, see the section on	Event Logging.
		 Format: integer; default value: 511, all events.

	    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.

	    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.

	    query_other_jobs
		 The setting of	this attribute controls	if general
		 users,	other than the job owner, are allowed to query
		 the status of a job.  Format: boolean (see
		 acl_host_enable); Requires full manager privilege to
		 set or	alter.	default	value: false - users may not
		 query 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.
		 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 is recoved from the prior server run.	 If it
		 has never been	set, the value is "false".

	    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_name
		 The name of the server	which is the same as the host
		 name.

	    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.

     SEE ALSO
	  the PBS ERS, qmgr(1B)