pbs_job_attributes(7B)

NAME
pbs_job_attributes - attributes of PBS jobs

DESCRIPTION
Each PBS job has attributes that characterize that job.

Account_Name
    String used for accounting purposes. Can be used for fairshare.
    Can be read and set by user, Operator, Manager.
    Format: String; can contain any character.
    Python type: str
    Default: No default

accounting_id
    Accounting ID for tracking accounting data not produced by PBS. Readable by all.
    Format: String
    Python type: str

accrue_type
    Indicates what kind of time the job is accruing.
    Readable by Manager only.
    Format: Integer
    Python type: int
    Valid values:
    One of 0 (initial_time), 1 (ineligible_time), 2 (eligible_time), or 3 (run_time).

    Default: 2 (eligible_time)

alt_id
    For a few systems, the session ID is insufficient to track which processes belong to the job. Where a different identifier is required, it is recorded in this attribute. If set, it will also be recorded in the end-of-job accounting record.
    For jobs running in CPU sets, the alt_id holds the set name in a form usable by the cpuset(1) command; this is cpuset =<path to cpuset>.
    On Windows, holds PBS home directory.
    Readable by all; settable by None.
    Format: String; may contain white spaces.
    Python type: str
    Default: No default

argument_list
    Job executable's argument list. Shown if job is submitted with "-- <executable> [<argument list>]".
    Can be read and set by user, Operator, Manager.
    Format: JSDL=encoded string
    <jsdl-hpcpa:Argument> <1st arg> </jsdl-hpcpa:Argument>
    <jsdl-hpcpa:Argument> <2nd arg> </jsdl-hpcpa:Argument>
    <jsdl-hpcpa:Argument> <nth arg> </jsdl-hpcpa:Argument>

    Example:
    If arguments are "A B": <jsdl-hpcpa:Argument>A</jsdl-hpcpa:Argument> <jsdl-hpcpa:Argument>B</jsdl-hpcpa:Argument>

    Python type: str
    Default: No default

array
    Indicates whether this is a job array. Set to True if this is an array job.
    Can be read and set by user. Can be read by Manager and Operator.
    Format: Boolean
    Python type: bool
    Default: False

array_id
    Applies only to subjobs. Array identifier of subjob. Readable by all; set by PBS.
    Format: String
    Python type: str
    Default: No default

array_index
    Applies only to subjobs. Index number of subjob. Readable by all; set by PBS.
    Format: String
    Python type: int
    Default: No default

array_indices_remaining
    Applies only to job arrays. List of indices of subjobs still queued. Readable by all; set by PBS.
    Format: String
    Syntax: Range or list of ranges, e.g. 500, 552, 596-1000
    Python type: str
    Default: No default

array_indices_submitted
    Applies only to job arrays. Complete list of indices of subjobs given at submission time.
    Can be read and set by user. Can be read by Manager and Operator.
    Format: String
    Syntax: Given as range, e.g. 1-100
    Python type: pbs.range
    Default: No default

array_state_count
    Applies only to job arrays. Lists number of subjobs in each state.
    Readable by all; set by PBS.
    Format: String
    Python type: pbs.state_count
    Default: No default

block
    Specifies whether qsub will wait for the job to complete and return the exit value of the job.
    For X11 forwarding jobs, and jobs with interactive and block attributes set to True, the job's exit status is not returned.
    When block is True, qsub waits for the job to finish.
    Can be read and set by user. Can be read by Manager and Operator.
    Format: Boolean
    Python type: int
    Default: False

Checkpoint
    Determines when the job will be checkpointed. An $action script is required to checkpoint the job. See the pbs_mom(8B) man page.
    Can be read and set by user, Operator, Manager.
    Format: String, containing description of interval at which to checkpoint.
    Python type: pbs.checkpoint
    Valid values:

    c   Checkpoint at intervals, measured in CPU time, set on the job's execution queue. If no interval set at queue, job is not checkpointed.

    c=<minutes of CPU time>
        Checkpoint at intervals of the specified number of minutes of job CPU time. This value must be greater than zero. If the interval specified is less than that set on the job's execution queue, the queue's interval is used.
        Format: Integer

    w   Checkpoint at intervals, measured in walltime, set on job's execution queue. If no interval set at queue, job is not checkpointed.

    w=<minutes of walltime>
        Checkpoint at intervals of the specified number of minutes of job walltime. This value must be greater than zero. If the interval specified is less that that set on job's execution queue, the queue's interval is used.
        Format: Integer

    n   No checkpointing.

    s   Checkpoint only when the server is shut down.

    u   Unset. Defaults to behavior when interval argument is set to s.

    Default: u

comment
    Comment about job. Informational only.
    Can be read by user. Can be read and set by Operator, Manager.
    Format: String
    Python type: str
    Default: No default

ctime
    Timestamp; time at which the job was created.
    Readable by all; set by PBS.
    Format: Integer
    Syntax: Timestamp.
    Printed by qstat in human-readable format. Output by hooks as seconds since epoch.

    Python type: int
    Default: No default

depend
    Specifies inter-job dependencies.
    No limit on number of dependencies.
    Can be read and set by user, Operator, Manager.
    Format: String
    Syntax:
    "<type>:<job ID>[,<job ID> ...][,<type>:<job ID>[,<job ID> ...] ...]"
    Must be enclosed in double quotes if it contains commas.

    Example: "before:123,456"
    Python type: pbs.depend
    Valid values:

    after:<job ID list>
        This job may run at any point after all jobs in job ID list have started execution.

    afterok:<job ID list>
        This job may run only after all jobs in job ID list have terminated with no errors.

    afternotok:<job ID list>
        This job may run only after all jobs in job ID list have terminated with errors.

    afterany:<job ID list>
        This job can run after all jobs in job ID list have finished execution, with or without errors. This job will not run if a job in the job ID list was deleted without ever having been run.

    before:<job ID list>
        Jobs in job ID list may start once this job has started.

    beforeok:<job ID list>
        Jobs in job ID list may start once this job terminates without errors.

    beforenotok:<job ID list>
        If this job terminates execution with errors, jobs in job ID list may begin.

    beforeany:<job id list>
        Jobs in job ID list may begin execution once this job terminates execution, with or without errors.

    on:<count>
        This job may run after count dependencies on other jobs have been satisfied. This type is used with one of the before types listed. Count is an integer greater than 0.

    Default: No dependencies

egroup
    If the job is queued, this attribute is set to the group name under which the job is to be run.
    Readable by Manager only.
    Format: String
    Python type: str
    Default: No default

eligible_time
    The amount of wall clock wait time a job has accrued while the job is blocked waiting for resources. For a job currently accruing eligible_time, if we were to add enough of the right type of resources, the job would start immediately.
    Viewable via qstat -f.
    Readable by job owner, Manager and Operator. Settable by Operator or Manager.
    Format: Duration
    Python type: pbs.duration
    Default: Zero

Error_Path
    The final path name for the file containing the job's standard error stream. See the qsub and qalter commands.
    Can be read and set by user, Operator, Manager.
    Format: String
    Python type: str
    Syntax: [<hostname>:]<path>
    Valid values:

    <relative path>
        Path is relative to the current working directory of command executing on current host.

    <absolute path>
        Path is absolute path on current host where command is executing.

    <hostname>:<relative path>
        Path is relative to user's home directory on specified host.

    <hostname>:<absolute path>
        Path is absolute path on named host.

    No path
        Path is current working directory where qsub is executed.

    Default: Default path is current working directory where qsub is run. If the output path is specified, but does not include a filename, the default filename is <job ID>.ER. If the path name is not specified, the default filename is <job name>.e<sequence number>.

estimated
    List of estimated values for job. Used to report job's exec_vnode, start_time, and soft_walltime. Can be set in a hook or via qalter, but PBS will overwrite the values.
    Format: Format of reported element
    Syntax:
    estimated.<resource name>=<value>[, estimated.<resource name>=<value> ...]

    Python type: pbs.pbs_resource
    Syntax:
    estimated.<resource name>=<value>
    where <resource name> is a resource

    Reported values:

    exec_vnode
        The estimated vnodes used by this job.
        Readable by all; settable by Manager and Operator.
        Format: String
        Python type: pbs.exec_vnode
        Default: Unset

    soft_walltime
        The estimated soft walltime for this job. Calculated when a job exceeds its soft_walltime resource.
        Readable by all; settable by Manager.
        Format: Duration
        Python type: pbs.duration
        Default: Unset

    start_time
        The estimated start time for this job.
        Readable by all; settable by Manager and Operator.
        Format: start_time is printed by qstat in human-readable format; start_time output in hooks as seconds since epoch.
        Python type: int
        Default: Unset

etime
    Timestamp; time when job became eligible to run, i.e. was enqueued in an execution queue and was in the "Q" state. Reset when a job moves queues, or is held then released. Not affected by qaltering.
    Readable by all; set by PBS.
    Format: Integer
    Syntax:
    Printed by qstat in human-readable format. Output in hooks as seconds since epoch.

    Python type: int
    Default: No default

euser
    If the job is queued, this attribute is set to the user name under which the job is to be run.
    Readable by Manager only; set by PBS.
    Format: String
    Python type: str
    Default: No default

executable
    JSDL-encoded listong of job's executable. Shown if job is submitted with "-- <executable> [<arg list>]".
    Can be read and set by user, Operator, Manager.
    Format: JSDL-encoded string
    Syntax: <jsdl-hpcpa:Executable> <name of executable>
    Example:
    If the executable is ping, the string is <jsdl-hpcpa:Executable>ping</jsdl-hpcpa:Executable>

    Python type: str
    Default: No default

Execution_Time
    Timestamp; time after which the job may execute. Before this time, the job remains queued in the (W)ait state. Can be set when stage-in fails and PBS moves job start time out 30 minutes to allow user to fix problem.
    Can be read and set by user, Operator, Manager.
    Format: Datetime
    Syntax: [[CCwYY]MMDDhhmm[.ss]
    Python type: int
    Default: Unset (no delay)

exec_host
    If the job is running, this is set to the name of the host or hosts on which the job is executing.
    Can be read by user, Operator, Manager.
    Format: String
    Syntax:
    <hostname>/N[*C][+...],
    where N is task slot number, starting with 0, on that vnode, and C is the number of CPUs allocated to the job. *C does not appear if C has a value of 1.

    Python type: pbs.exec_host
    Default: No default

exec_vnode
    List of chunks for the job. Each chunk shows the name of the vnode(s) from which it is taken, along with the host-level, consumable resources allocated from that vnode, and any AOE provisioned on this vnode for this job.
    If a vnode is allocated to the job but no resources from the vnode are used by the job, the vnode name appears alone.
    If a chunk is split across vnodes, the name of each vnode and its resources appear inside one pair of parentheses, joined with a plus sign ("+").
    Can be read by user. Can be read and set by Manager, Operator.
    Format: String
    Syntax:
    Each chunk is enclosed in parentheses, and chunks are connected by plus signs.

    Example:
    For a job which requested two chunks that were satisfied by resources from three vnodes, exec_vnode is
    (vnodeA:ncpus=N:mem=X)+(vnodeB:ncpus=P:mem=Y+vnodeC:mem=Z).
    For a job which requested one chunk and exclusive use of a 2-vnode host, where the chunk was satisfied by resources from one vnode, exec_vnode is
    (vnodeA:ncpus=N:mem=X)+(vnodeB).

    Python type: pbs.exec_vnode
    Default: No default

Exit_status
    Exit status of job. Set to zero for successful execution. If any subjob of an array job has non-zero exit status, the array job has non-zero exit status.
    Readable by all; set by PBS.
    Format: Integer
    Python type: int
    Default: No default

forward_x11_cookie
    Contains the X authorization cookie.
    Readable by all; set by PBS.
    Format: String
    Python type: int
    Default: No default

forward_x11_port
    Contains the number of the port being listened to by the port forwarder on the submission host.
    Readable by all; set by PBS.
    Format: Integer
    Python type: int
    Default: No default

group_list
    A list of group names used to determine the group under which the job runs. When a job runs, the server selects a group name from the list according to the following ordered set of rules:

    1.  Select the group name for which the associated host name matches the name of the server host.

    2.  Select the group name which has no associated host name.

    3.  Use the login group for the user name under which the job will be run.

    Can be read and set by user, Operator, Manager.
    Format: String
    Syntax:
    <group name>[@<hostname>] [,<group name>[@<hostname>] ...]
    Must be enclosed in double quotes if it contains commas.

    Python type: pbs.group_list
    Default: No default

hashname
    No longer used.

Hold_Types
    The set of holds currently applied to the job. If the set is not null, the job will not be scheduled for execution and is said to be in the held state. The held state takes precedence over the wait state.
    Can be read and set by user, Operator, Manager.
    Format: String, made up of the letters 'n', 'o', 'p', 's', 'u'
    Hold types:

    n   No hold

    o   Other hold

    p   Bad password

    s   System hold

    u   User hold

    Python type: pbs.hold_types
    Default: n (no hold)

interactive
    Specifies whether the job is interactive.
    When both this attribute and the block attribute are True, no exit status is returned. For X11 forwarding jobs, the job's exit status is not returned.
    Cannot be set using a PBS directive.
    Job arrays cannot be interactive.
    Can be set, but not altered, by unprivileged user. Can be read by Operator, Manager.
    Format: Boolean
    Python type: int
    Default: False

jobdir
    Path of the job's staging and execution directory on the primary execution host. Either user's home, or private sandbox. Depends on value of sandbox attribute. Viewable via qstat -f.
    Readable by all; set by PBS.
    Format: String
    Python type: str
    Default: No default

Job_Name
    The job name. See the qsub and qalter commands.
    Can be read and set by user, Operator, Manager.
    Format: String up to 236 characters, first character must be alphabetic or numeric
    Python type: str
    Default: Base name of job script, or STDIN

Job_Owner
    The login name on the submitting host of the user who submitted the batch job.
    Readable by all; set by PBS.
    Format: String
    Python type: str
    Default: No default

job_state
    The state of the job.
    Readable by all. Can be set indirectly by all.
    Format: Character
    Job states:

    B   Begun. Job arrays only. The job array has begun execution.
        Python type: PBS job state constant pbs.JOB_STATE_BEGUN

    E   Exiting. The job has finished, with or without errors, and PBS is cleaning up post-execution.
        Python type: PBS job state constant pbs.JOB_STATE_EXITING

    F   Finished. Job is finished. Job has completed execution, job failed during execution, or job was deleted.
        Python type: PBS job state constant pbs.JOB_STATE_FINISHED

    H   Held. The job is held.
        Python type: PBS job state constant pbs.JOB_STATE_HELD

    M   Moved. Job has been moved to another server.
        Python type: PBS job state constant pbs.JOB_STATE_MOVED

    Q   Queued. The job resides in an execution or routing queue pending execution or routing. It is not in held or waiting state.
        Python type: PBS job state constant pbs.JOB_STATE_QUEUED

    R   Running. The job is in a execution queue and is running.
        Python type: PBS job state constant pbs.JOB_STATE_RUNNING

    S   Suspended. The job was executing and has been suspended. The job does not use CPU cycles or walltime.
        Python type: PBS job state constant pbs.JOB_STATE_SUSPEND

    T   Transiting. The job is being routed or moved to a new destination.
        Python type: PBS job state constant pbs.JOB_STATE_TRANSIT

    U   User suspended. The job was running on a workstation configured for cycle harvesting and the keyboard/mouse is currently busy. The job is suspended until the workstation has been idle for a configured amount of time.
        Python type: PBS job state constant pbs.JOB_STATE_SUSPEND_USERACTIVE

    W   Waiting. The Execution_Time attribute contains a time in the future. Can be set when stage-in fails and PBS moves job start time out 30 minutes to allow user to fix problem.
        Python type: PBS job state constant pbs.JOB_STATE_WAIITING

    X   Expired. Subjobs only. Subjob is finished (expired.)
        Python type: PBS job state constant pbs.JOB_STATE_EXPIRED

Join_Path
    Specifies whether the job's standard error and standard output streams are to be merged and placed in the file specified in the Output_Path job attribute.
    When set to True, the job's standard error and standard output streams are merged.
    Can be read and set by user, Operator, Manager.
    Format: String
    Behavior:

    eo  Standard output and standard error are merged, intermixed, into a single stream, which becomes standard error.

    oe  Standard output and standard error are merged, intermixed, into a single stream, which becomes standard output.

    n   Standard output and standard error are not merged.

    Python type: pbs.join_path
    Default: False

Keep_Files
    Specifies whether the standard output and/or standard error streams are retained on the execution host in the job's staging and execution directory after the job has executed. Otherwise these files are returned to the submission host. Keep_Files overrides the Output_Path and Error_Path attributes.
    Readable and settable by all.
    Format: String
    Python type: pbs.keep_files
    Valid values: Can be one of the following:

    e   The standard error stream is retained. The filename is: job_name.e<sequence number>

    eo, oe
        Both standard output and standard error streams are retained.

    d   Output and error are written directly to their final destination

    n   Neither stream is retained. Files are returned to submission host.

    Default: n
    (neither stream is retained, and files are returned to submission host.)

Mail_Points
    Specifies state changes for which the server sends mail about the job.
    Can be read and set by user, Operator, Manager.
    Format: String
    Python type: pbs.mail_points
    Valid values: Combination of a, b, and e, or n by itself.

    a   Mail is sent when job is aborted

    b   Mail is sent at beginning of job

    e   Mail is sent when job ends

    n   No mail is sent. Cannot be combined with other options.

    Default: a

Mail_Users
    The set of users to whom mail is sent when the job makes state changes specified in the Mail_Points job attribute.
    Can be read and set by user, Operator, Manager.
    Format: String
    Syntax: "<username>@<hostname>[,<username>@<hostname>]"
    Python type: pbs.email_list
    Default: Job owner only

mtime
    Timestamp; the time that the job was last modified, changed state, or changed locations.
    Format: Integer.
    Syntax: Timestamp.
    Printed by qstat in human-readable format; output in hooks as seconds since epoch.

    Python type: int
    Default: No default

no_stdio_sockets
    Not used.

Output_Path
    The final path name for the file containing the job's standard output stream. See the qsub and qalter commands.
    Can be read and set by user, Operator, Manager.
    Format: String
    Python type: str
    Syntax: [<hostname>:]<path>
    Valid values:

    <relative path>
        Path is relative to the current working directory of command executing on current host.

    <absolute path>
        Path is absolute path on current host where command is executing.

    <hostname>:<relative path>
        Path is relative to user's home directory on specified host.

    <hostname>:<absolute path>
        Path is absolute path on named host.

    No path
        Path is current working directory where qsub is executed.

    Default:
    Default path is current working directory where qsub is run.
    If the output path is specified, but does not include a filename, the default filename is <job ID>.OU.
    If the path name is not specified, the default filename is <job name>.o<sequence number>.

pcap_accelerator
    Power attribute. Power cap for an accleerator. Corresponds to Cray capmc set_power_cap --accel setting. See capmc documentation.
    Readable and settable by all.
    Format: Integer
    Units: Watts
    Python type: int
    Default: Unset

pcap_node
    Power attribute. Power cap for a node. Corresponds to Cray capmc set_power_cap --node setting. See capmc documentation.
    Readable and settable by all.
    Format: Integer
    Units: Watts
    Python type: int
    Default: Unset

pgov
    Power attribute. Cray ALPS reservation setting for CPU throttling corresponding to p-governor. See BASIL 1.4 documentation. We do not recommend using this attribute.
    Readable and settable by all.
    Format: String
    Python type: str
    Default: Unset

Priority
    The scheduling priority for the job. Higher value indicates higher priority.
    Can be read and set by user, Operator, Manager.
    Format: Integer
    Syntax: [+|-]nnnnn
    Valid values: [-1024, +1023] inclusive
    Python type: int
    Default: Unset

project
    The job's project. A project is a way to tag jobs. Each job can belong to at most one project.
    Readable and settable by user, Operator, Manager.
    Format: String
    Can contain any characters except for the following: Slash ("/"), left bracket ("["), right bracket ("]"), double quote ("""), semicolon (";"), colon (":"), vertical bar ("|"), left angle bracket ("<"), right angle bracket (">"), plus ("+"), comma (","), question mark ("?"), and asterisk ("*").

    Python type: str
    Default: "_pbs_project_default"

pset
    Name of the placement set used by the job.
    Can be read by user, Operator. Can be read and set by Manager.
    Format: String
    Python type: str
    Default: No default

pstate
    Power attribute. Cray ALPS reservation setting for CPU frequency corresponding to p-state. See BASIL 1.4 documentation.
    Readable and settable by all.
    Format: String
    Units: Hertz
    Python type: str
    Default: Unset

qtime
    Timestamp; the time that the job entered the current queue.
    Readable by all; settable only by PBS.
    Format: Integer
    Syntax: Timestamp.
    Printed by qstat in human-readable format; output in hooks as seconds since epoch.

    Python type: int
    Default: No default

queue
    The name of the queue in which the job currently resides.
    Readable by all; settable only by PBS.
    Format: String
    Python type: pbs.queue
    Default: No default

queue_rank
    A number indicating the job's position within the queue. Only used internally by PBS.
    Readable by Manager only.
    Format: Integer
    Python type: int
    Default: No default

queue_type
    The type of queue in which the job is currently residing.
    Readable by Manager only.
    Format: Character
    Valid values: One of E or R

    E   Execution queue
        Python type:
        PBS job state constant pbs.QUEUE_TYPE_EXECUTION

    R   Routing queue
        Python type:
        PBS job state constant pbs.QUEUE_TYPE_EXECUTION

    Default: No default

release_nodes_on_stageout
    Controls whether job vnodes are released when stageout begins.
    Cannot be used with vnodes managed by cpuset MoMs, (whose arch is linux_cpuset), or with vnodes tied to Cray X* series systems.
    When cgroups is enabled and this is used with some but not all vnodes from one MoM, resources on those vnodes that are part of a cgroup are not released until the entire cgroup is released.
    The job's stageout attribute must be set for the release_nodes_on_stageout attribute to take effect.
    When set to True, all of the job's vnodes not on the primary execution host are released when stageout begins.
    When set to False, job's vnodes are released when the job finishes and MoM cleans up the job.
    Readable and settable by all.
    Format: Boolean
    Python type: bool
    Default: False

Remove_Files
    Specifies whether standard output and/or standard error files are automatically removed upon job completion.
    Readable and settable by all.
    Format: String
    Python type: str
    Valid values: "e", "o", "eo", "oe", or unset

    e   Standard error is removed upon job completion.

    o   Standard output is removed upon job completion.

    eo, oe
        Standard output and standard error are removed upon job completion.

    unset
        Neither is removed.

    Default: Unset

Rerunable
    Specifies whether the job can be rerun. Does not affect how a job is treated if the job could not begin execution. See "Allowing Your Job to be Re-run", in the PBS Professional User's Guide.
    Job arrays are required to be rerunnable and are rerunnable by default.
    Readable and settable by all.
    Format: Character
    Syntax: One of y or n
    Python type: bool
    Default: y (job is rerunnable)

Resource_List
    The list of resources required by the job. List is a set of <resource name>=<value> strings. The meaning of name and value is dependent upon defined resources. Each value establishes the limit of usage of that resource. If not set, the value for a resource may be determined by a queue or server default established by the administrator.
    Readable and settable by all.
    Format: String
    Syntax:
    Resource_List.<resource name>=<value>[, Resource_List.<resource name>=<value>, ...]

    Python type: pbs.pbs_resource
    Syntax:
    Resource_List["<resource name>"]=<value>
    where <resource name> is any built-in or custom resource

    Default: No default

resources_released
    Listed by vnode, consumable resources that were released when the job was suspended. Populated only when restrict_res_to_release_on_suspend server attribute is set.
    Readable by all. Set by server.
    Format: String
    Syntax:
    (<vnode>:<resource name>=<value>: <resource name>=<value>:...)+ (<vnode>:<resource name>=<value>:...)

    Python type: str
    Default: No default

resource_release_list
    Sum of each consumable resource requested by the job that was released when the job was suspended. Populated only when restrict_res_to_release_on_suspend server attribute is set.
    Readable by Manager and Operator. Set by server.
    Format: String
    Syntax:
    resource_released_list.<resource name>=<value>, resource_released_list.<resource name>=<value>, ...

    Python type: pbs.pbs_resource
    Default: No default

resources_used
    The amount of each resource used by the job.
    Readable by all; set by PBS.
    Format: String
    Syntax:
    List of resources_used.<resource name>=<value>,resources_used.<resource name>=<value> pairs.

    Example: resources_used.mem=2mb
    Python type: pbs.pbs_resource
    Syntax:
    resources_used["<resource name>"]=<value>
    where <resource name> is any built-in or custom resource

    Default: No default

run_count
    The number of times the server thinks the job has been executed.
    The run_count attribute starts at zero. Job is held after 21 tries.
    Can be set via qsub, qalter, or a hook.
    Can be read and set by Manager and Operator.
    Format: Integer; must be greater than or equal to zero.
    Python type: int
    Default: Zero

run_version
    Used internally by PBS to track the instance of the job.
    Set by PBS. Visible to Manager only.
    Format: Integer
    Python type: int
    Default: No default

sandbox
    Specifies type of location PBS uses for job staging and execution.
    User-settable via qsub -Wsandbox=<value> or via a PBS directive.
    See the $jobdir_root MoM configuration option in pbs_mom.8B.
    Can be read and set by user, Operator, Manager.
    Format: String
    Valid values: PRIVATE, HOME, unset

    PRIVATE
        When set to PRIVATE, PBS creates job-specific staging and execution directories under the directory specified in the $jobdir_root MoM configuration option.

    HOME or unset
        PBS uses the job owner's home directory for staging and execution.

    Python type: str
    Default: Unset

schedselect
    The union of the select specification of the job, and the queue and server defaults for resources in a chunk.
    Can be read by PBS Manager only.
    Format: String
    Python type: pbs.select
    Default: No default

sched_hint
    No longer used.

server
    The name of the server which is currently managing the job. When the secondary server is running during failover, shows the name of the primary server. After a job is moved to another server, either via qmove or peer scheduling, shows the name of the new server.
    Readable by all; set by PBS.
    Format: String
    Python type: pbs.server
    Default: No default

session_id
    If the job is running, this is set to the session ID of the first executing task.
    Readable by all; set by PBS.
    Format: Integer
    Python type: int
    Default: No default

Shell_Path_List
    One or more absolute paths to the program(s) to process the job's script file.
    Can be read and set by user, Operator, Manager.
    Format: String
    Syntax:
    "<path>[@<hostname>][,<path>[@<hostname>]...]"
    Must be enclosed in double quotes if it contains commas.

    Python type: pbs.path_list
    Default: User's login shell on execution host

stagein
    The list of files to be staged in prior to job execution.
    Can be read and set by user, Operator, Manager.
    Format: String
    Syntax:
    "<execution path>@<storage host>:<storage path> [, <execution path>@<storage host>:<storage path>, ...]"

    Python type: pbs.staging_list
    Default: No default

stageout
    The list of files to be staged out after job execution.
    Can be read and set by user, Operator, Manager.
    Format: String
    Syntax:
    "<execution path>@<storage host>:<storage path> [, <execution path>@<storage host>:<storage path>, ...]"

    Python type: pbs.staging_list
    Default: No default

Stageout_status
    Status of stageout. If stageout succeeded, this is set to 1. If stageout failed, this is set to 0. Displayed only if set. If stageout fails for any subjob of an array job, the value of Stageout_status is zero for the array job. Available only for finished jobs.
    Readable by all; set by PBS.
    Format: Integer
    Python type: int
    Default: No default

stime
    Timestamp; time when the job started execution. Changes when job is restarted.
    Readable by all; set by PBS.
    Format: Integer
    Syntax: Timestamp.
    Printed by qstat in human-readable format; output in hooks as seconds since epoch.

    Python type: int
    Default: No default

Submit_arguments
    Job submission arguments given on the qsub command line. Available for all jobs.
    Can be read and set by user, Operator, Manager.
    Format: String
    Python type: str
    Default: No default

substate
    The substate of the job. The substate is used internally by PBS.
    Readable by all; set by PBS.
    Format: Integer
    Python type: int
    Default: No default

sw_index
    No longer used.

tobjob_ineligible
    Allows administrators to mark this job as ineligible to be a top job.
    When True , this job is not eligible to be the top job.
    Can be read and set by Manager.
    Format: Boolean
    Python type: bool
    Default: False

umask
    The initial umask of the job is set to the value of this attribute when the job is created. This may be changed by umask commands in the shell initialization files such as .profile or .cshrc.
    Can be read and set by user, Operator, Manager.
    Format: Decimal integer
    Python type: int
    Default: 077

User_List
    The list of users which determines the user name under which the job is run on a given host. No length limit.
    When a job is to be executed, the server selects a user name from the list according to the following ordered set of rules:

    1.  Select the user name from the list for which the associated host name matches the name of the server.

    2.  Select the user name which has no associated host name; the wild card name.

    3.  Use the value of Job_Owner as the user name.

    Readable and settable by all.
    Format: String
    Syntax:
    "<username>@<hostname> [,<username>@<hostname>...]"
    Must be enclosed in double quotes if it contains commas. May be up to 256 characters in length.

    Python type: pbs.user_list
    Default: Value of Job_Owner job attribute

Variable_List
    List of environment variables set in the job's execution environment. See the qsub(1B) command.
    Readable and settable by all.
    Format: String
    Syntax:
    "<variable name>=<value> [,<variable name>=<value>...]"
    Must be enclosed in double quotes if it contains commas.

    Python type: pbs.pbs_resource
    Syntax:
    Variable_List["<variable name>"]=<value>

    Default: No default

SEE ALSO
qsub(1B), qalter(1B), qhold(1B), qrls(1B), pbs_resources(7B)