5.637 Parameters

arch

$attempt_to_make_dir

$clienthost

$check_poll_time

$configversion

$cputmult

$cray_check_rur

$cuda_visible_devices

$down_on_error

$enablemomrestart

$exec_with_exec

$ext_pwd_retry

$force_overwrite

$ideal_load

$igncput

$ignmem

$ignvmem

$ignwalltime

$jobdirectory_sticky

$job_exit_wait_time

$job_output_file_unmask

$job_starter

$job_starter_run_priviledged

$log_directory

$log_file_suffix

$logevent

$loglevel

$log_file_max_size

$log_file_roll_depth

$log_keep_days

$max_conn_timeout_micro_sec

$max_join_job_wait_time

$max_load

$memory_pressure_duration

$memory_pressure_threshold

$mom_hierarchy_retry_time

$mom_host

$node_check_script

$node_check_interval

$nodefile_suffix

$nospool_dir_list

opsys

$pbsclient

$pbsserver

$presetup_prologue

$prologalarm

$rcpcmd

$remote_reconfig

$remote_checkpoint_dirs

$reduce_prolog_checks

$reject_job_submission

$restricted

$restricted

$rpp_throttle

size[fs=<FS>]

$source_login_batch

$source_login_interactive

$spool_as_final_name

$status_update_time

$thread_unlink_calls

$timeout

$tmpdir

$usecp

$use_smt

$varattr

$wallmult

$xauthpath

When set to TRUE, specifies that you want Torque to attempt to create the output directories for jobs if they do not already exist.

Default is FALSE.

Torque uses this parameter to make the directory as the user and not as root. Torque will create the directory (or directories) ONLY if the user has permissions to do so.

Specifies the machine running pbs_server.

This parameter is deprecated. Use $pbsserver.

CPU time multiplier.

If set to 0.0, MOM level cputime enforcement is disabled.

Causes the MOM to report itself as state "down" to pbs_server in the event of a failed health check. See 5.715.24 Health check for more information.

Enables automatic restarts of the MOM. If enabled, the MOM will check if its binary has been updated and restart itself at a safe point when no jobs are running; thus making upgrades easier. The check is made by comparing the mtime of the pbs_mom executable. Command-line args, the process name, and the PATH env variable are preserved across restarts. It is recommended that this not be enabled in the config file, but enabled when desired with momctl (see Parameters for more information.)

(Available in Torque 2.5.10, 3.0.4, and later.) Specifies the number of times to retry checking the password. Useful in cases where external password validation is used, such as with LDAP.

The default value is 3 retries.

(Available in Torque 6.0.3 and later.) When set to true, forces the output files to be overwritten each time a job is started.

Creates an event mask enumerating which log events will be recorded in the MOM logs. By default all events are logged.

These are the events which can be chosen:

ERROR      0x0001    internal errors  

SYSTEM     0x0002    system (server) & (trqauthd) events

ADMIN      0x0004    admin events

JOB        0x0008    job related events

JOB_USAGE  0x0010    End of Job accounting

SECURITY   0x0020    security violation events

SCHED      0x0040    scheduler events

DEBUG      0x0080    common debug messages

DEBUG2     0x0100    less needed debug messages

CLIENTAUTH 0X0200    TRQAUTHD login events

SYSLOG     0x0400    pass this event to the syslog as well

The listed events are shown here with hexidecimal values; however, a decimal value must be used when setting $logevent.

This sets the connection timeout on the MOM to .3 seconds..

The interval to wait for jobs stuck in a prerun state before deleting them from the MOMs and requeueing them on the server. Default is 10 minutes.

If a MOM is completely idle, it can take as long as the next MOM-to-server update time to requeue a failed job.

(Applicable in version 3.0 and later.) The memory_pressure of a cpuset provides a simple per-cpuset running average of the rate that the processes in a cpuset are attempting to free up in-use memory on the nodes of the cpuset to satisfy additional memory requests. The memory_pressure_threshold is an integer number used to compare against the reclaim rate provided by the memory_pressure file. If the threshold is exceeded and memory_pressure_duration is set, then the process terminates after exceeding the threshold by the number of times set in memory_pressure_duration. If memory_pressure duration is not set, then a warning is logged and the process continues. Memory_pressure_threshold is only valid with memory_pressure enabled in the root cpuset.

To enable, log in as the super user and execute the command echo 1 >> /dev/cpuset/memory_pressure_enabled. See the cpuset man page for more information concerning memory pressure.

$mom_hierarchy_retry_time 30

$mom_host node42

Specifies the number of MOM intervals between subsequent executions of the specified health check. This value defaults to 1 indicating the check is run every MOM interval (see Compute Node Health Check for more information).

$node_check_interval has two special strings that can be set:

• jobstart – makes the node health script run when a job is started (before the prologue script).
• jobend – makes the node health script run after each job has completed on a node (after the epilogue script).

The node health check may be configured to run before or after the job with the "jobstart" and/or "jobend" options. However, the job environment variables do not get passed to node health check script, so it has no access to those variables at any time.

$nodefile_suffix i

with the suffix of "i" and the control channel adapter with the name node01, the data channel would have a hostname of node01i.

If this is configured, the job's output is spooled in the working directory of the job or the specified output directory.

Specify the list in full paths, delimited by commas. If the job's working directory (or specified output directory) is in one of the paths in the list (or a subdirectory of one of the paths in the list), the job is spooled directly to the output location. $nospool_dir_list * is accepted.

The user that submits the job must have write permission on the folder where the job is written, and read permission on the folder where the file is spooled.

Alternatively, you can use the $spool_as_final_name parameter to force the job to spool directly to the final output.

This should generally be used only when the job can run on the same machine as where the output file goes, or if there is a shared filesystem. If not, this parameter can slow down the system or fail to create the output file.

Specifies the machine running pbs_server.

This parameter replaces the deprecated parameter $clienthost.

A full path to the presetup prologue for all jobs on this node. If set, this script executes before any setup for the job occurs (such as becoming the user, creating the output files, or changing directories). As a result, no output from this script will appear in the job's output.

If set to TRUE, jobs will be rejected and the user will receive the message, "Jobs cannot be run on mom %s." Default is FALSE.

$rpp_throttle 100

(will cause a 100 microsecond sleep)

Specifies that the available and configured disk space in the <FS> filesystem is to be reported to the pbs_server and scheduler.

To request disk space on a per job basis, specify the file resource as in qsub -l nodes=1,file=1000kb.

Unlike most MOM config options, the size parameter is not preceded by a "$" character.

size[fs=/localscratch]

The available and configured disk space in the /localscratch filesystem will be reported.

$source_login_batch False

MOM will bypass the sourcing of /etc/profile, etc. type files.

$source_login_interactive False

MOM will bypass the sourcing of /etc/profile, etc. type files.

status_update_time:

$status_update_time 120

MOM will send server update reports every 120 seconds.

thread_unlink_calls:

$thread_unlink_calls true

Specifies the number of seconds before a TCP connection on the MOM will timeout. Default is 300 seconds.

In version 3.x and earlier, this specifies the number of seconds before MOM-to-MOM messages will timeout if RPP is disabled. Default is 60 seconds.

$timeout 120

A TCP connection will wait up to 120 seconds before timing out.

For 3.x and earlier, MOM-to-MOM communication will allow up to 120 seconds before timing out.

Indicates that the user would like to use SMT. If set, each logical core inside of a physical core will be used as a normal core for cpusets. This parameter is on by default.

$use_smt is deprecated. Please use the -L NUMA Resource Request syntax to control whether or not threads or cores are used.

If you use SMT, you will need to set the np attribute so that each logical processor is counted.

Provides a way to keep track of dynamic attributes on nodes.

<INTEGER> is how many seconds should go by between calls to the script to update the dynamic values. If set to -1, the script is read only one time.

<STRING> is the script path. This script should check for whatever dynamic attributes are desired, and then output lines in this format:

name=value

Include any arguments after the script's full path. These features are visible in the output of pbsnodes-a

varattr=Matlab=7.1;Octave=1.0.

For information about using $varattr to request dynamic features in Moab, see REQATTR in the Moab Workload Manager Administrator Guide.

Sets a factor to adjust walltime usage by multiplying a default job time to a common reference system. It modifies real walltime on a per-MOM basis (MOM configuration parameters). The factor is used for walltime calculations and limits in the same way that cputmult is used for cpu time.

If set to 0.0, MOM level walltime enforcement is disabled.

Specifies the path to the xauth binary to enable X11 forwarding.