(Click to open topic with navigation)

5.329 Fields: Jobs

See the associated Jobs resource section for more information on how to use this resource and supported operations.

Additional references

Type Value Additional information
Permissions resource jobs Permissions
Hooks filename jobs.groovy Pre- and Post-Processing Hooks
Distinct query-supported Yes Distinct
ClosedAPI version 3

Job

This class represents a job in the Moab Workload Manager. A job is a request for compute resources (CPUs, memory, storage) with which the requester can do work for a given amount of time. In an HPC environment, this might be a batch script to perform a Monte Carlo simulation. In a cloud environment, this would be a virtual machine and its associated storage. Moab will evaluate the request and assign the requested resources to the requester based on policies, current demand, and other factors in the data center. A job will also usually have some process that Moab starts automatically at the assigned start time. In an HPC environment, this can be starting a batch script on the assigned nodes. In a cloud environment, this can be starting provisioning processes to create the virtual machine and storage and install software on it.

Field Name Type POST PUT Description
id String No No

The unique identifier of this job. Note: this field is not user-assigned and is generated by the database.
arrayIndex Long No No

If this job is a sub-job of a JobArray, this field contains the index of this job in the array. For example, if this job is Moab.1[2], the array index would be 2.
arrayMasterName String No No

If this job is a sub-job of a JobArray, this field contains the name of the job array master. For example, if this job is Moab.1[2], the array master name would be Moab.1.
attributes Set<String> Yes No

The list of generic attributes associated with this job.
blocks Set<JobBlock> No No

Reasons the job is blocked from running.
bypassCount Integer No No

The number of times the job has been backfilled.
cancelCount Integer No No

The number of times a job has received a cancel request.
commandFile String Yes No

The name of the job script file (absolute path). If commandFile is set and commandScript is not set, then MWS must have read access to the file. If commandFile and commandScript are both set, then MWS does not read the contents of the file, but it does provide the name of the file to Moab. Note that Moab changes the contents of the commandFile field and the contents of the file pointed to by commandFile. For the original path and file contents, see submitCommandFile.
commandLineArguments String Yes No

The command line arguments passed to the job script specified by commandFile or commandScript. Must be enclosed in quotes. Example: "commandLineArguments": "\"a b c\""
commandScript String Yes No

The contents of the job script. This field must be Base64-encoded.
completionCode Integer No No

The exit code from this job.
cpuTime Long No No

CPU usage time in seconds as reported by the resource manager.
credentials JobCredentials Yes Yes

The credentials (user and group, for example) associated with this job.
customName String Yes Yes

The user-specified name of this job. This field must not contain any spaces.
dates JobDates Yes Yes

Various dates associated with this job.
deferCount Integer No No

The number of times a job has been deferred.
dependencies Set<JobDependency> Yes No

Dependencies that must be fulfilled before the job can start.
description String No No

The description of the job. Can be set only in a job template.
duration Long Yes Yes

The length of time in seconds requested for the job. Note that it is possible to set duration to "INFINITY" if the AllowInfiniteJobs flag is set on the scheduler in the moab.cfg.
durationActive Long No No

The length of time in seconds the job has been active or running.
durationMinimum Long No No

Minimum duration of the job (used when automatically extending durations). See JOBEXTENDDURATION in the Moab Workload Manager Administrator Guide.
durationQueued Long No No

The length of time in seconds the job has been eligible to run in the queue.
durationRemaining Long No No

An estimate of the time remaining, in seconds, before the job will complete.
durationSuspended Long No No

The length of time in seconds the job has been suspended.
emailNotifyAddresses Set<String> Yes No

The list of addresses to whom email is sent by the execution server.
emailNotifyTypes Set<JobEmailNotifyType> Yes No

The list of email notify types attached to the job.
environmentRequested Boolean Yes No

Setting this field to true tells the Moab Workload Manager to set various variables, if populated, in the job's environment.
environmentVariables Map<String, Map> Yes No

The environment variables to set for this job. This field is defined only during POST. On GET, this field is an empty object. (See also: fullEnvironmentVariableList.)

epilogScript String Yes No

The path to the TORQUE epilog script.
flags Set<JobFlag> Yes Yes

The flags that are set on this job.
fullEnvironmentVariableList String No No

The full list of all environment variables for this job, including variables set by the resource manager, if any. (See also: environmentVariables.)

holdDate Date No No

The date the most recent hold was placed on the job.
holdReason JobHoldReason No No

The reason the job is on hold.
holds Set<JobHoldType> Yes Yes

The holds that are set on the job. The "User" hold type is valid during POST.
initialWorkingDirectory String Yes No

The path to the directory in which the job will be started.
isActive Boolean No No

True if the job is active, false if the job is complete.
jobGroup String Yes No

The job group to which this job belongs (different from credentials.group).
masterNode DomainProxy No No

The first node in the list of allocated nodes for this job. For TORQUE jobs, this represents the "mother superior."
memorySecondsDedicated Double No No

The memory seconds dedicated to the job as reported by its resource manager. Not all resource managers provide this information.
memorySecondsUtilized Double No No

The memory seconds utilized by the job as reported by its resource manager. Not all resource managers provide this information.
messages Set<Message> No Yes

The list of messages associated with the job. The "message" field is valid during PUT.
migrateCount Integer No No

The number of times the job has been migrated.
minimumPreemptTime Long No No

The minimum length of time, in seconds, an active job must be running before it is eligible for preemption.
mwmName String No No

The name of the Moab Workload Manager instance that owns this job.
name String No No

The name of this job. This name is unique per instance of Moab Workload Manager (i.e. not globally).
nodesExcluded Set<DomainProxy> Yes No

The list of nodes that should not be considered for this job.
nodesRequested Set<DomainProxy> Yes No

The exact set, superset, or subset of nodes on which this job must run. (See also: nodesRequestedPolicy.)

nodesRequestedPolicy JobHostListMode Yes No

Indicates an exact set, superset, or subset of nodes on which the job must run. Only relevant if nodesRequested is provided. (See also: nodesRequested.)

partitionAccessList Set<String> No No

The list of partitions that this job can access.
partitionAccessListRequested Set<String> Yes Yes

The list of partitions that this job has requested.
partitionAccessListScheduler Set<String> No No

The feasible partition access list built by the scheduler.
preemptCount Integer No No

The number of times the job has been preempted.
priorities JobPriority Yes Yes

The list of priorities for the job.
processorSecondsDedicated Double No No

The processor seconds dedicated to the job as reported by its resource manager. Not all resource managers provide this information.
processorSecondsLimit Double No No

The limit for processorSecondsUtilized.
processorSecondsUtilized Double No No

The processor seconds utilized by the job as reported by its resource manager. Not all resource managers provide this information.
prologScript String Yes No

The path to the TORQUE prolog script.
queueStatus JobQueueStatus No No

The status of the job in its queue.
rank Integer No No

The index of this job in the eligible queue.
rejectPolicies Set<JobRejectPolicy> No No

The list of policies enabled when a job is rejected.
requirements Set<JobRequirement> Yes Yes

The list of items required for this job to run. Only JobRequirement.features is valid during PUT.
reservationRequested DomainProxy Yes Yes

The reservation that the job requested.
resourceFailPolicy JobResourceFailPolicyType Yes No

The policy that dictates what should happen to the job if it is running and at least one of the resources it is using fails.
resourceManagerExtension String Yes No

If provided during POST, this string will be added to the resource manager extension section of the job submission. Example: "bandwidth=120;queuejob=false"
Note that the delimiter between resourceManagerExtension elements is the semicolon.
resourceManagers Set<ResourceManager> No No

The list of resource managers associated with this job.
shellName String Yes No

Declares the shell that interprets the job script.
standardErrorFilePath String Yes No

The path to the file containing the standard error of the job.
standardOutputFilePath String Yes No

The path to the file containing the standard output of the job.
startCount Integer No No

The number of times the job has been started.
states JobStateInformation No No

Information about the state of the job.
submitCommandFile String No No

This read-only field contains the path to the original commandFile as posted to MWS during job submission.
submitHost String No No

The host from which the job was submitted.
systemJobAction String No No

The action the system job will take.
systemJobType JobSystemJobType No No

The type of system job. In the Moab Cloud Suite, this will usually be "vmtracking" or "generic."
targetedJobAction JobActionType No No

The action that this job is performing on another job.
targetedJobName String No No

The name of the job on which this job is performing the targetedJobAction.
templates Set<DomainProxy> Yes No

The list of all job templates to be set on this job.
triggers Set<String> No No

The list of triggers associated with this job.
variables Map<String, Map> Yes Yes

The list of variables that this job owns or sets on completion.
virtualContainers Set<DomainProxy> Yes No

When submitting this job, add it to the specified existing virtual container. Valid during POST, but only one virtual container can be specified.
virtualMachines Set<DomainProxy> No No

The list of virtual machines that are allocated to this job.
vmUsagePolicy VMUsagePolicy Yes No

The requested Virtual Machine Usage Policy for this job.

JobBlock

Field Name Type POST PUT Description
category JobBlockCategory No No

createdDate Date No No

message String No No

partition String No No

type JobBlockType No No

JobBlockCategory

Value Description
depend
jobBlock
migrate

JobBlockType

Value Description
ActivePolicy
BadUser
Dependency
EState
FairShare
Hold
IdlePolicy
LocalPolicy
NoClass
NoData
NoResource
NoTime
PartitionAccess
Priority
RMSubmissionFailure
StartDate
State
SysLimits

JobCredentials

Moab Workload Manager supports the concept of credentials, which provide a means of attributing policy and resource access to entities such as users and groups. These credentials allow specification of job ownership, tracking of resource usage, enforcement of policies, and many other features.

Field Name Type POST PUT Description
account String Yes Yes

The account credential is also referred to as the project. This credential is generally associated with a group of users along the lines of a particular project for accounting and billing purposes.
group String Yes No

The group credential represents an aggregation of users. User-to-group mappings are often specified by the operating system or resource manager and typically map to a user's UNIX group ID. However, user-to-group mappings may also be provided by a security and identity management service, or you can specify such directly within Moab.
jobClass String Yes Yes

The concept of the class credential is derived from the resource manager class or queue object. Classes differ from other credentials in that they more directly impact job attributes. In standard HPC usage, a user submits a job to a class and this class imposes a number of factors on the job. The attributes of a class may be specified within the resource manager or directly within Moab.
qos String No No

The quality of service assigned to this job.

The concept of a quality of service (QoS) credential is unique to Moab and is not derived from any underlying concept or peer service. In most cases, the QoS credential is used to allow a site to set up a selection of service levels for end-users to choose from on a long-term or job-by-job basis. QoS's differ from other credentials in that they are centered around special access where this access may allow use of additional services, additional resources, or improved responsiveness. Unique to this credential, organizations may also choose to apply different charge rates to the varying levels of service available within each QoS. As QoS is an internal credential, all QoS configuration occurs within Moab.
qosRequested String Yes Yes

The quality of service requested for this job.
user String Yes No

The user credential is the fundamental credential within a workload manager; each job requires an association with exactly one user. In fact, the user credential is the only required credential in Moab; all others are optional. In most cases, the job's user credential is configured within or managed by the operating system itself, although Moab may be configured to obtain this information from an independent security and identity management service.

JobDates

Field Name Type POST PUT Description
completedDate Date No No

createdDate Date No No

deadlineDate Date Yes No

The deadline for completion of the job.
dispatchedDate Date No No

earliestRequestedStartDate Date Yes Yes

The job will start no sooner than this date.
earliestStartDate Date No No

eligibleDate Date No No

lastCanceledDate Date No No

lastChargedDate Date No No

lastPreemptedDate Date No No

lastUpdatedDate Date No No

startDate Date No No

submitDate Date No No

terminationDate Date No No

JobDependency

Field Name Type POST PUT Description
name String Yes No

The name of the object on on which the job is dependent.
type JobDependencyType Yes No

The type of job dependency. Only the "set" type is valid for POST.
value String No No

Optional string representation of the dependency (used with variable dependencies).

JobDependencyType

Represents the type of a job dependency. For now, only the "set" type is supported.

Value Description
set Job will wait until a variable on a Moab object is set before starting.

JobEmailNotifyType

Value Description
JobStart An email will be sent when the job starts.
JobEnd An email will be sent if the job successfully ends.
JobFail An email will be sent if the job fails.
All

JobFlag

This enumeration specifies the flag types of a job.

Value Description
NONE
BACKFILL The job is using backfill to run.
COALLOC The job can use resources from multiple resource managers and partitions.
ADVRES The job requires the use of a reservation.
NOQUEUE The job will attempt to execute immediately or fail.
ARRAYJOB The job is part of a job array.
ARRAYJOBPARLOCK This array job will only run in one partition.
ARRAYJOBPARSPAN This array job will span partitions (default).
ARRAYMASTER This job is the master of a job array.
BESTEFFORT The job will succeed if even partial resources are available.
RESTARTABLE The job is restartable.
SUSPENDABLE The job is suspendable.
HASPREEMPTED This job preempted other jobs to start.
PREEMPTEE The job is a preemptee and therefore can be preempted by other jobs.
PREEMPTOR The job is a preemptor and therefore can preempt other jobs.
RSVMAP The job is based on a reservation.
SPVIOLATION The job was started with a soft policy violation.
IGNNODEPOLICIES The job will ignore node policies.
IGNPOLICIES The job will ignore idle, active, class, partition, and system policies.
IGNNODESTATE The job will ignore node state in order to run.
IGNIDLEJOBRSV The job can ignore idle job reservations. The job granted access to all idle job reservations.
INTERACTIVE The job needs to interactive input from the user to run.
FSVIOLATION The job was started with a fairshare violation.
GLOBALQUEUE The job is directly submitted without doing any authentication.
NORESOURCES The job is a system job that does not need any resources.
NORMSTART The job will not query a resource manager to run.
CLUSTERLOCKED The job is locked into the current cluster and cannot be migrated elsewhere. This is for grid mode.
FRAGMENT The job can be run across multiple nodes in individual chunks.
FORCEPROVISION Job will provision nodes, whether they already have OS or not.
SYSTEMJOB The job is a system job which simply runs on the same node that Moab is running on. This is usually used for running scripts and other executables in workflows.
ADMINSETIGNPOLICIES The IGNPOLICIES flag was set by an administrator.
EXTENDSTARTWALLTIME The job duration (walltime) was extended at job start.
SHAREDMEM The job will share its memory across nodes.
BLOCKEDBYGRES The job's generic resource requirement caused the job to start later.
GRESONLY The job is requesting only generic resources, no compute resources.
TEMPLATESAPPLIED The job has had all applicable templates applied to it.
META META job, just a container around resources.
WIDERSVSEARCHALGO This job prefers the wide search algorithm.
VMTRACKING The job is a VMTracking job for an externally-created VM (via job template).
DESTROYTEMPLATESUBMITTED A destroy job has already been created from the template for this job.
PROCSPECIFIED The job requested processors on the command line.
CANCELONFIRSTFAILURE Cancel job array on first array job failure.
CANCELONFIRSTSUCCESS Cancel job array on first array job success.
CANCELONANYFAILURE Cancel job array on any array job failure.
CANCELONANYSUCCESS Cancel job array on any array job success.
CANCELONEXITCODE Cancel job array on a specific exit code.
NOVMMIGRATE Do not migrate the virtual machine that this job sets up.
VCMASTER Job is the master of a virtual container.
USEMOABJOBID Specifies whether to use the Moab job ID or the resource manager's job ID.
JOINSTDERRTOSTDOUT Join the stderr file to the stdout file.
JOINSTDOUTTOSTDERR Join the stdout file to the stderr file.
PURGEONSUCCESSONLY Only purge the job if it completed successfully
ALLPROCS Each job compute task requests all the procs on its node
COMMLOCAL Each job communications are localized, with minimal routing outside job shape
COMMTOLERANT Each job communications are low-intensity and insensitive to interference

JobHoldReason

Value Description
Admin
NoResources
SystemLimitsExceeded
BankFailure
CannotDebitAccount
InvalidAccount
RMFailure
RMReject Resource manager rejects job execution.
PolicyViolation Job violates job size policy.
CredAccess Job cannot access requested credential.
CredHold Credential hold in place.
PreReq Job prerequisite failed.
Data Data staging cannot be completed.
Security Job security cannot be established.
MissingDependency Dependency job cannot be found.

JobHoldType

Value Description
User The user has manually placed a hold on the job.
System The Moab Workload Manager has placed a hold on the job.
Batch The batch queue has placed a hold on the job.
Defer The job has been deferred.
All During GET, All means that all hold types are set. During PUT, All can be used to clear all hold types.

DomainProxy

A reference to an object contained within an object. For example, a Virtual Machine object contains a reference to the Node on which it is running. That reference is represented by this class.

Field Name Type POST PUT Description
name String Yes No

The name of the object.

Message

Field Name Type POST PUT Description
count Integer No No

The number of times this message has occurred.
createdDate Date No No

The date this message was created.
expireDate Date No No

The date this message expires.
message String No Yes

The message itself.

JobHostListMode

Value Description
superset
subset
exactset

JobPriority

Field Name Type POST PUT Description
run Long No No

start Long No No

system Long No No

user Long Yes Yes

The user-requested priority for the job. By default, the range is between -1024 and 0. To enable priority range from -1024 to +1023, set ENABLEPOSUSERPRIORITY in the moab.cfg file.

JobQueueStatus

Value Description
active A job is actively running in a queue.
blocked A job has been blocked because of a policy violation or because resource requirements cannot be met.
completed A job has completed running.
eligible A job is eligible to run but has not started yet.

JobRejectPolicy

Value Description
CANCEL
HOLD
IGNORE
MAIL
RETRY

JobRequirement

Field Name Type POST PUT Description
architecture String Yes No

The architecture required by the job.
attributes Map<String, JobRequirementAttribute> Yes No

Required node attributes with version number support.
dedicateAllProcessors Boolean No No

Within a requirement, if dedicateAllProcessors is true, then all processors on the node where the job runs will be dedicated to the job.
features Set<String> No Yes

The list of node features the job is scheduled against.
featuresExcluded Set<String> Yes No

Excluded node features. That is, do not select nodes with these features. (See also: featuresExcludedMode.)

featuresExcludedMode JobRequirementFeaturesMode Yes No

Indicates whether excluded features should be AND'ed or OR'd. The default is AND. Only relevant if featuresExcluded is provided. (See also: featuresExcluded.)

featuresRequested Set<String> Yes No

Requested node features. (See also: featuresRequestedMode.)

featuresRequestedMode JobRequirementFeaturesMode Yes No

Indicates whether requested features should be AND'ed or OR'd. The default is AND. Only relevant if featuresRequested is provided. (See also: featuresRequested.)

image String Yes No

The image required by the job.
index Integer No No

The index of the requirement, starting with 0.
metrics Map<String, Double> No No

Generic metrics associated with the job as reported by the resource manager.
nodeAccessPolicy NodeAccessPolicy Yes No

Specifies how node resources should be accessed. Note: If the job requirements array has more than one element that contains nodeAccessPolicy, only the first occurrence will be used.
nodeAllocationPolicy NodeAllocationPolicy Yes No

Specifies how node resources should be selected and allocated to the job. Note: If the job requirements array has more than one element that contains nodeAllocationPolicy, only the first occurrence will be used.
nodeCount Integer Yes No

The number of nodes required by the job.
nodeSet String Yes No

The requested node set of the job. This must follow the format SETSELECTION:SETTYPE[:SETLIST]

  • SETSELECTION - ANYOF, ONEOF, or FIRSTOF
  • SETTYPE - FEATURE or VARATTR
  • SETLIST - For FEATURE, a comma-separated list of features. For VARATTR, a key=value pair.
Examples:
  • ONEOF:FEATURE:fastos,hiprio,bigmem
  • FIRSTOF:VARATTR:datacenter=Provo:datacenter=SaltLake
nodes Set<AllocatedNode> No No

Nodes that have been allocated to meet this requirement.
reservation DomainProxy No No

The allocated reservation (assigned after the job has a reservation).
resourcesPerTask Map<String, JobResource> Yes No

Contains requirements for disk, memory, processors, swap, and generic resources. For disk, memory, and swap, the unit is MB. For each resource, the "dedicated" field can be set during POST.
taskCount Integer Yes No

The number of tasks (processors) required by this job.
tasksPerNode Integer Yes No

The number of tasks to map to each node. If you specify tasksPerNode, you must also specify taskCount.
totalDedicatedProcessors Integer No No

JobRequirementAttribute

Field Name Type POST PUT Description
comparator String Yes No

The comparison operator. Valid values:

  • >= - Greater than or equal to
  • > - Greater than
  • <= - Less than
  • < - Less than
  • %= - Equals
  • %! - Not equals
  • Null - Defaults to %=
  • = - (Deprecated) Equivalent to %=
displayValue String Yes No

The display value for the required attribute.
restriction JobRequirementAttributeRestriction Yes No

The restriction of this attribute. May be null, but defaults to JobRequirementAttributeRestriction.must.
value String Yes No

The value of the required attribute. During POST, if value is missing, blank, or null, do not provide a comparator.

JobRequirementAttributeRestriction

Represents a restriction for a job requirement attribute.

Value Description
must

JobRequirementFeaturesMode

Value Description
OR
AND

NodeAccessPolicy

This enumeration describes how node resources will be shared by various tasks.

Value Description
NONE
SHARED Tasks from any combination of jobs may utilize available resources.
SHAREDONLY Only jobs requesting shared node access may utilize available resources.
SINGLEJOB Tasks from a single job may utilize available resourceses.
SINGLETASK A single task from a single job may run on the node.
SINGLEUSER Tasks from any jobs owned by the same user may utilize available resources.
UNIQUEUSER Any number of tasks from a single job may allocate resources from a node but only if the user has no other jobs running on that node.
SINGLEGROUP Any number of tasks from the same group may utilize node.
SINGLEACCOUNT Any number of tasks from the same account may utilize node.
SINGLECLASS Any number of tasks from the same class may utilize node.
SINGLEQOS Any number of tasks from the same QOS (quality of service) may utilize node.

NodeAllocationPolicy

Node Allocation enumeration.

Value Description
FIRSTSET
MINGLOBAL
MINLOCAL
PLUGIN
NONE No node allocation policy is specified. Moab defaults to MINRESOURCE when this is the case.
FIRSTAVAILABLE Simple first come, first served algorithm where nodes are allocated in the order they are presented by the resource manager. This is a very simple, very fast algorithm.
LASTAVAILABLE This algorithm selects resources so as to minimize the amount of time after the job and before the trailing reservation. This algorithm is a best fit in time algorithm which minimizes the impact of reservation based node-time fragmentation. It is useful in systems where a large number of reservations (job, standing, or administrative) are in place.
MINRESOURCE This algorithm prioritizes nodes according to the configured resources on each node. Those nodes with the fewest configured resources which still meet the job's resource constraints are selected.
CPULOAD Nodes are selected which have the maximum amount of available, unused cpu power, i.e. [# of CPU's] - [CPU load]. Good algorithm for timesharing node systems. This algorithm is only applied to jobs starting immediately. For the purpose of future reservations, the MINRESOURCE algorithm is used.
LOCAL This will call the locally created contrib node allocation algorithm.
CONTIGUOUS This algorithm will allocate nodes in contiguous (linear) blocks as required by the Compaq RMS system.
MAXBALANCE This algorithm will attempt to allocate the most 'balanced' set of nodes possible to a job. In most cases, but not all, the metric for balance of the nodes is node speed. Thus, if possible, nodes with identical speeds will be allocated to the job. If identical speed nodes cannot be found, the algorithm will allocate the set of nodes with the minimum node speed 'span' or range.
PRIORITY This algorithm allows a site to specify the priority of various static and dynamic aspects of compute nodes and allocate them with preference for higher priority nodes. It is highly flexible allowing node attribute and usage information to be combined with reservation affinity.
FASTEST This algorithm will select nodes in 'fastest node first' order. Nodes will be selected by node speed if specified. If node speed is not specified, nodes will be selected by processor speed. If neither is specified, nodes will be selected in a random order.
PROCESSORLOAD Alias for CPULOAD.
NODESPEED Alias for FASTEST.
INREPORTEDORDER Alias for FIRSTAVAILABLE.
INREVERSEREPORTEDORDER Alias for LASTAVAILABLE.
CUSTOMPRIORITY Alias for PRIORITY.
PROCESSORSPEEDBALANCE Alias for MAXBALANCE.
MINIMUMCONFIGUREDRESOURCES Alias for MINRESOURCE.
CRAY3DTORUS Enable topology awareness scheduling algorithm.

AllocatedNode

Field Name Type POST PUT Description
name String No No

taskCount Integer No No

JobResource

Represents counts of dedicated and utilized resources.

Field Name Type POST PUT Description
dedicated Integer No No

The amount of this resource that has been allocated for running workload.
utilized Integer No No

The amount of this resource that is currently reported as utilized by resource managers.

JobResourceFailPolicyType

Value Description
CANCEL
FAIL
HOLD
IGNORE
NOTIFY
REQUEUE

ResourceManager

Field Name Type POST PUT Description
isDestination Boolean No No

isSource Boolean No No

jobName String No No

name String No No

JobStateInformation

Field Name Type POST PUT Description
state JobState No No

stateExpected JobState No No

stateLastUpdatedDate Date No No

subState JobSubState No No

JobState

Value Description
Idle Eligible according to all resource manager constraints.
Starting Job is launching, executing prolog.
Running Job is executing.
Removed Job was canceled before executing.
Completed Job successfully completed execution.
Hold Job is blocked by hold.
Deferred Job has a temporary hold.
Vacated Job was canceled after partial execution.
NotQueued Job is not eligible for execution.
Unknown Job state is unknown.
Staging Staging of input/output data is currently underway.
Suspended Job is no longer executing and remains in memory on the allocated compute nodes.
Blocked

JobSubState

Value Description
Epilogue
Migrated
Preempted
Prologue

JobSystemJobType

Value Description
generic Generic system job (trigger attached).
osprovision Reprovision operating system.
osprovision2 Perform two-phase (base and virtual machine) operating system reprovision.
poweroff Power off node.
poweron Power on node.
reset Reboot node.
storage Dynamic storage allocation.
vmmap Map to virtual machine to track resource consumption.
vmmigrate Migrate virtual machine.
vmtracking Job for tracking a virtual machine.

JobActionType

Value Description
DESTROY
MIGRATE
MODIFY

VMUsagePolicy

This enumeration describes the virtual machine requirements of a job

Value Description
REQUIREPM Requires a physical machine.
PREFPM Prefers a physical machine.
CREATEVM Creates a virtual machine.
CREATEPERSISTENTVM Creates a virtual machine that doesn't go away after the job is done.
REQUIREVM Requires a virtual machine.
PREFVM Prefers a virtual machine.
ClosedAPI version 2

Job

This class represents a job in the Moab Workload Manager. A job is a request for compute resources (CPUs, memory, storage) with which the requester can do work for a given amount of time. In an HPC environment, this might be a batch script to perform a Monte Carlo simulation. In a cloud environment, this would be a virtual machine and its associated storage. Moab will evaluate the request and assign the requested resources to the requester based on policies, current demand, and other factors in the data center. A job will also usually have some process that Moab starts automatically at the assigned start time. In an HPC environment, this can be starting a batch script on the assigned nodes. In a cloud environment, this can be starting provisioning processes to create the virtual machine and storage and install software on it.

Field Name Type POST PUT Description
id String No No

The unique identifier of this job. Note: this field is not user-assigned and is generated by the database.
arrayIndex Long No No

If this job is a sub-job of a JobArray, this field contains the index of this job in the array. For example, if this job is Moab.1[2], the array index would be 2.
arrayMasterName String No No

If this job is a sub-job of a JobArray, this field contains the name of the job array master. For example, if this job is Moab.1[2], the array master name would be Moab.1.
attributes Set<String> Yes No

The list of generic attributes associated with this job.
blocks Set<JobBlock> No No

Reasons the job is blocked from running.
bypassCount Integer No No

The number of times the job has been backfilled.
cancelCount Integer No No

The number of times a job has received a cancel request.
commandFile String Yes No

The name of the job script file (absolute path). If commandFile is set and commandScript is not set, then MWS must have read access to the file. If commandFile and commandScript are both set, then MWS does not read the contents of the file, but it does provide the name of the file to Moab. Note that Moab changes the contents of the commandFile field and the contents of the file pointed to by commandFile. For the original path and file contents, see submitCommandFile.
commandLineArguments String Yes No

The command line arguments passed to the job script specified by commandFile or commandScript. Must be enclosed in quotes. Example: "commandLineArguments": "\"a b c\""
commandScript String Yes No

The contents of the job script. This field must be Base64-encoded.
completionCode Integer No No

The exit code from this job.
cpuTime Long No No

CPU usage time in seconds as reported by the resource manager.
credentials JobCredentials Yes Yes

The credentials (user and group, for example) associated with this job.
customName String Yes Yes

The user-specified name of this job. This field must not contain any spaces.
dates JobDates Yes Yes

Various dates associated with this job.
deferCount Integer No No

The number of times a job has been deferred.
dependencies Set<JobDependency> Yes No

Dependencies that must be fulfilled before the job can start.
description String No No

The description of the job. Can be set only in a job template.
duration Long Yes Yes

The length of time in seconds requested for the job. Note that it is possible to set duration to "INFINITY" if the AllowInfiniteJobs flag is set on the scheduler in the moab.cfg.
durationActive Long No No

The length of time in seconds the job has been active or running.
durationMinimum Long No No

Minimum duration of the job (used when automatically extending durations). See JOBEXTENDDURATION in the Moab Workload Manager Administrator Guide.
durationQueued Long No No

The length of time in seconds the job has been eligible to run in the queue.
durationRemaining Long No No

An estimate of the time remaining, in seconds, before the job will complete.
durationSuspended Long No No

The length of time in seconds the job has been suspended.
emailNotifyAddresses Set<String> Yes No

The list of addresses to whom email is sent by the execution server.
emailNotifyTypes Set<JobEmailNotifyType> Yes No

The list of email notify types attached to the job.
environmentRequested Boolean Yes No

Setting this field to true tells the Moab Workload Manager to set various variables, if populated, in the job's environment.
environmentVariables Map<String, Map> Yes No

The environment variables to set for this job. This field is defined only during POST. On GET, this field is an empty object. (See also: fullEnvironmentVariableList.)

epilogScript String Yes No

The path to the TORQUE epilog script.
flags Set<JobFlag> Yes Yes

The flags that are set on this job.
fullEnvironmentVariableList String No No

The full list of all environment variables for this job, including variables set by the resource manager, if any. (See also: environmentVariables.)

holdDate Date No No

The date the most recent hold was placed on the job.
holdReason JobHoldReason No No

The reason the job is on hold.
holds Set<JobHoldType> Yes Yes

The holds that are set on the job. The "User" hold type is valid during POST.
initialWorkingDirectory String Yes No

The path to the directory in which the job will be started.
isActive Boolean No No

True if the job is active, false if the job is complete.
jobGroup String Yes No

The job group to which this job belongs (different from credentials.group).
masterNode DomainProxy No No

The first node in the list of allocated nodes for this job. For TORQUE jobs, this represents the "mother superior."
memorySecondsDedicated Double No No

The memory seconds dedicated to the job as reported by its resource manager. Not all resource managers provide this information.
memorySecondsUtilized Double No No

The memory seconds utilized by the job as reported by its resource manager. Not all resource managers provide this information.
messages Set<Message> No Yes

The list of messages associated with the job. The "message" field is valid during PUT.
migrateCount Integer No No

The number of times the job has been migrated.
minimumPreemptTime Long No No

The minimum length of time, in seconds, an active job must be running before it is eligible for preemption.
mwmName String No No

The name of the Moab Workload Manager instance that owns this job.
name String No No

The name of this job. This name is unique per instance of Moab Workload Manager (i.e. not globally).
nodesExcluded Set<DomainProxy> Yes No

The list of nodes that should not be considered for this job.
nodesRequested Set<DomainProxy> Yes No

The exact set, superset, or subset of nodes on which this job must run. (See also: nodesRequestedPolicy.)

nodesRequestedPolicy JobHostListMode Yes No

Indicates an exact set, superset, or subset of nodes on which the job must run. Only relevant if nodesRequested is provided. (See also: nodesRequested.)

partitionAccessList Set<String> No No

The list of partitions that this job can access.
partitionAccessListRequested Set<String> Yes Yes

The list of partitions that this job has requested.
partitionAccessListScheduler Set<String> No No

The feasible partition access list built by the scheduler.
preemptCount Integer No No

The number of times the job has been preempted.
priorities JobPriority Yes Yes

The list of priorities for the job.
processorSecondsDedicated Double No No

The processor seconds dedicated to the job as reported by its resource manager. Not all resource managers provide this information.
processorSecondsLimit Double No No

The limit for processorSecondsUtilized.
processorSecondsUtilized Double No No

The processor seconds utilized by the job as reported by its resource manager. Not all resource managers provide this information.
prologScript String Yes No

The path to the TORQUE prolog script.
queueStatus JobQueueStatus No No

The status of the job in its queue.
rank Integer No No

The index of this job in the eligible queue.
rejectPolicies Set<JobRejectPolicy> No No

The list of policies enabled when a job is rejected.
requirements Set<JobRequirement> Yes Yes

The list of items required for this job to run. Only JobRequirement.features is valid during PUT.
reservationRequested DomainProxy Yes Yes

The reservation that the job requested.
resourceFailPolicy JobResourceFailPolicyType Yes No

The policy that dictates what should happen to the job if it is running and at least one of the resources it is using fails.
resourceManagerExtension String Yes No

If provided during POST, this string will be added to the resource manager extension section of the job submission. Example: "bandwidth=120;queuejob=false"
Note that the delimiter between resourceManagerExtension elements is the semicolon.
resourceManagers Set<ResourceManager> No No

The list of resource managers associated with this job.
shellName String Yes No

Declares the shell that interprets the job script.
standardErrorFilePath String Yes No

The path to the file containing the standard error of the job.
standardOutputFilePath String Yes No

The path to the file containing the standard output of the job.
startCount Integer No No

The number of times the job has been started.
states JobStateInformation No No

Information about the state of the job.
submitCommandFile String No No

This read-only field contains the path to the original commandFile as posted to MWS during job submission.
submitHost String No No

The host from which the job was submitted.
systemJobAction String No No

The action the system job will take.
systemJobType JobSystemJobType No No

The type of system job. In the Moab Cloud Suite, this will usually be "vmtracking" or "generic."
targetedJobAction JobActionType No No

The action that this job is performing on another job.
targetedJobName String No No

The name of the job on which this job is performing the targetedJobAction.
templates Set<DomainProxy> Yes No

The list of all job templates to be set on this job.
triggers Set<String> No No

The list of triggers associated with this job.
variables Map<String, Map> Yes Yes

The list of variables that this job owns or sets on completion.
virtualContainers Set<DomainProxy> Yes No

When submitting this job, add it to the specified existing virtual container. Valid during POST, but only one virtual container can be specified.
virtualMachines Set<DomainProxy> No No

The list of virtual machines that are allocated to this job.
vmUsagePolicy VMUsagePolicy Yes No

The requested Virtual Machine Usage Policy for this job.

JobBlock

Field Name Type POST PUT Description
category JobBlockCategory No No

createdDate Date No No

message String No No

partition String No No

type JobBlockType No No

JobBlockCategory

Value Description
depend
jobBlock
migrate

JobBlockType

Value Description
ActivePolicy
BadUser
Dependency
EState
FairShare
Hold
IdlePolicy
LocalPolicy
NoClass
NoData
NoResource
NoTime
PartitionAccess
Priority
RMSubmissionFailure
StartDate
State
SysLimits

JobCredentials

Moab Workload Manager supports the concept of credentials, which provide a means of attributing policy and resource access to entities such as users and groups. These credentials allow specification of job ownership, tracking of resource usage, enforcement of policies, and many other features.

Field Name Type POST PUT Description
account String Yes Yes

The account credential is also referred to as the project. This credential is generally associated with a group of users along the lines of a particular project for accounting and billing purposes.
group String Yes No

The group credential represents an aggregation of users. User-to-group mappings are often specified by the operating system or resource manager and typically map to a user's UNIX group ID. However, user-to-group mappings may also be provided by a security and identity management service, or you can specify such directly within Moab.
jobClass String Yes Yes

The concept of the class credential is derived from the resource manager class or queue object. Classes differ from other credentials in that they more directly impact job attributes. In standard HPC usage, a user submits a job to a class and this class imposes a number of factors on the job. The attributes of a class may be specified within the resource manager or directly within Moab.
qos String No No

The quality of service assigned to this job.

The concept of a quality of service (QoS) credential is unique to Moab and is not derived from any underlying concept or peer service. In most cases, the QoS credential is used to allow a site to set up a selection of service levels for end-users to choose from on a long-term or job-by-job basis. QoS's differ from other credentials in that they are centered around special access where this access may allow use of additional services, additional resources, or improved responsiveness. Unique to this credential, organizations may also choose to apply different charge rates to the varying levels of service available within each QoS. As QoS is an internal credential, all QoS configuration occurs within Moab.
qosRequested String Yes Yes

The quality of service requested for this job.
user String Yes No

The user credential is the fundamental credential within a workload manager; each job requires an association with exactly one user. In fact, the user credential is the only required credential in Moab; all others are optional. In most cases, the job's user credential is configured within or managed by the operating system itself, although Moab may be configured to obtain this information from an independent security and identity management service.

JobDates

Field Name Type POST PUT Description
completedDate Date No No

createdDate Date No No

deadlineDate Date Yes No

The deadline for completion of the job.
dispatchedDate Date No No

earliestRequestedStartDate Date Yes Yes

The job will start no sooner than this date.
earliestStartDate Date No No

eligibleDate Date No No

lastCanceledDate Date No No

lastChargedDate Date No No

lastPreemptedDate Date No No

lastUpdatedDate Date No No

startDate Date No No

submitDate Date No No

terminationDate Date No No

JobDependency

Field Name Type POST PUT Description
name String Yes No

The name of the object on on which the job is dependent.
type JobDependencyType Yes No

The type of job dependency. Only the "set" type is valid for POST.
value String No No

Optional string representation of the dependency (used with variable dependencies).

JobDependencyType

Represents the type of a job dependency. For now, only the "set" type is supported.

Value Description
set Job will wait until a variable on a Moab object is set before starting.

JobEmailNotifyType

Value Description
JobStart An email will be sent when the job starts.
JobEnd An email will be sent if the job successfully ends.
JobFail An email will be sent if the job fails.
All

JobFlag

This enumeration specifies the flag types of a job.

Value Description
NONE
BACKFILL The job is using backfill to run.
COALLOC The job can use resources from multiple resource managers and partitions.
ADVRES The job requires the use of a reservation.
NOQUEUE The job will attempt to execute immediately or fail.
ARRAYJOB The job is part of a job array.
ARRAYJOBPARLOCK This array job will only run in one partition.
ARRAYJOBPARSPAN This array job will span partitions (default).
ARRAYMASTER This job is the master of a job array.
BESTEFFORT The job will succeed if even partial resources are available.
RESTARTABLE The job is restartable.
SUSPENDABLE The job is suspendable.
HASPREEMPTED This job preempted other jobs to start.
PREEMPTEE The job is a preemptee and therefore can be preempted by other jobs.
PREEMPTOR The job is a preemptor and therefore can preempt other jobs.
RSVMAP The job is based on a reservation.
SPVIOLATION The job was started with a soft policy violation.
IGNNODEPOLICIES The job will ignore node policies.
IGNPOLICIES The job will ignore idle, active, class, partition, and system policies.
IGNNODESTATE The job will ignore node state in order to run.
IGNIDLEJOBRSV The job can ignore idle job reservations. The job granted access to all idle job reservations.
INTERACTIVE The job needs to interactive input from the user to run.
FSVIOLATION The job was started with a fairshare violation.
GLOBALQUEUE The job is directly submitted without doing any authentication.
NORESOURCES The job is a system job that does not need any resources.
NORMSTART The job will not query a resource manager to run.
CLUSTERLOCKED The job is locked into the current cluster and cannot be migrated elsewhere. This is for grid mode.
FRAGMENT The job can be run across multiple nodes in individual chunks.
FORCEPROVISION Job will provision nodes, whether they already have OS or not.
SYSTEMJOB The job is a system job which simply runs on the same node that Moab is running on. This is usually used for running scripts and other executables in workflows.
ADMINSETIGNPOLICIES The IGNPOLICIES flag was set by an administrator.
EXTENDSTARTWALLTIME The job duration (walltime) was extended at job start.
SHAREDMEM The job will share its memory across nodes.
BLOCKEDBYGRES The job's generic resource requirement caused the job to start later.
GRESONLY The job is requesting only generic resources, no compute resources.
TEMPLATESAPPLIED The job has had all applicable templates applied to it.
META META job, just a container around resources.
WIDERSVSEARCHALGO This job prefers the wide search algorithm.
VMTRACKING The job is a VMTracking job for an externally-created VM (via job template).
DESTROYTEMPLATESUBMITTED A destroy job has already been created from the template for this job.
PROCSPECIFIED The job requested processors on the command line.
CANCELONFIRSTFAILURE Cancel job array on first array job failure.
CANCELONFIRSTSUCCESS Cancel job array on first array job success.
CANCELONANYFAILURE Cancel job array on any array job failure.
CANCELONANYSUCCESS Cancel job array on any array job success.
CANCELONEXITCODE Cancel job array on a specific exit code.
NOVMMIGRATE Do not migrate the virtual machine that this job sets up.
VCMASTER Job is the master of a virtual container.
USEMOABJOBID Specifies whether to use the Moab job ID or the resource manager's job ID.
JOINSTDERRTOSTDOUT Join the stderr file to the stdout file.
JOINSTDOUTTOSTDERR Join the stdout file to the stderr file.
PURGEONSUCCESSONLY Only purge the job if it completed successfully
ALLPROCS Each job compute task requests all the procs on its node
COMMLOCAL Each job communications are localized, with minimal routing outside job shape
COMMTOLERANT Each job communications are low-intensity and insensitive to interference

JobHoldReason

Value Description
Admin
NoResources
SystemLimitsExceeded
BankFailure
CannotDebitAccount
InvalidAccount
RMFailure
RMReject Resource manager rejects job execution.
PolicyViolation Job violates job size policy.
CredAccess Job cannot access requested credential.
CredHold Credential hold in place.
PreReq Job prerequisite failed.
Data Data staging cannot be completed.
Security Job security cannot be established.
MissingDependency Dependency job cannot be found.

JobHoldType

Value Description
User The user has manually placed a hold on the job.
System The Moab Workload Manager has placed a hold on the job.
Batch The batch queue has placed a hold on the job.
Defer The job has been deferred.
All During GET, All means that all hold types are set. During PUT, All can be used to clear all hold types.

DomainProxy

A reference to an object contained within an object. For example, a Virtual Machine object contains a reference to the Node on which it is running. That reference is represented by this class.

Field Name Type POST PUT Description
name String Yes No

The name of the object.

Message

Field Name Type POST PUT Description
count Integer No No

The number of times this message has occurred.
createdDate Date No No

The date this message was created.
expireDate Date No No

The date this message expires.
message String No Yes

The message itself.

JobHostListMode

Value Description
superset
subset
exactset

JobPriority

Field Name Type POST PUT Description
run Long No No

start Long No No

system Long No No

user Long Yes Yes

The user-requested priority for the job. By default, the range is between -1024 and 0. To enable priority range from -1024 to +1023, set ENABLEPOSUSERPRIORITY in the moab.cfg file.

JobQueueStatus

Value Description
active A job is actively running in a queue.
blocked A job has been blocked because of a policy violation or because resource requirements cannot be met.
completed A job has completed running.
eligible A job is eligible to run but has not started yet.

JobRejectPolicy

Value Description
CANCEL
HOLD
IGNORE
MAIL
RETRY

JobRequirement

Field Name Type POST PUT Description
architecture String Yes No

The architecture required by the job.
attributes Map<String, JobRequirementAttribute> Yes No

Required node attributes with version number support.
dedicateAllProcessors Boolean No No

Within a requirement, if dedicateAllProcessors is true, then all processors on the node where the job runs will be dedicated to the job.
features Set<String> No Yes

The list of node features the job is scheduled against.
featuresExcluded Set<String> Yes No

Excluded node features. That is, do not select nodes with these features. (See also: featuresExcludedMode.)

featuresExcludedMode JobRequirementFeaturesMode Yes No

Indicates whether excluded features should be AND'ed or OR'd. The default is AND. Only relevant if featuresExcluded is provided. (See also: featuresExcluded.)

featuresRequested Set<String> Yes No

Requested node features. (See also: featuresRequestedMode.)

featuresRequestedMode JobRequirementFeaturesMode Yes No

Indicates whether requested features should be AND'ed or OR'd. The default is AND. Only relevant if featuresRequested is provided. (See also: featuresRequested.)

image String Yes No

The image required by the job.
index Integer No No

The index of the requirement, starting with 0.
metrics Map<String, Double> No No

Generic metrics associated with the job as reported by the resource manager.
nodeAccessPolicy NodeAccessPolicy Yes No

Specifies how node resources should be accessed. Note: If the job requirements array has more than one element that contains nodeAccessPolicy, only the first occurrence will be used.
nodeAllocationPolicy NodeAllocationPolicy Yes No

Specifies how node resources should be selected and allocated to the job. Note: If the job requirements array has more than one element that contains nodeAllocationPolicy, only the first occurrence will be used.
nodeCount Integer Yes No

The number of nodes required by the job.
nodeSet String Yes No

The requested node set of the job. This must follow the format SETSELECTION:SETTYPE[:SETLIST]

  • SETSELECTION - ANYOF, ONEOF, or FIRSTOF
  • SETTYPE - FEATURE or VARATTR
  • SETLIST - For FEATURE, a comma-separated list of features. For VARATTR, a key=value pair.
Examples:
  • ONEOF:FEATURE:fastos,hiprio,bigmem
  • FIRSTOF:VARATTR:datacenter=Provo:datacenter=SaltLake
nodes Set<AllocatedNode> No No

Nodes that have been allocated to meet this requirement.
reservation DomainProxy No No

The allocated reservation (assigned after the job has a reservation).
resourcesPerTask Map<String, JobResource> Yes No

Contains requirements for disk, memory, processors, swap, and generic resources. For disk, memory, and swap, the unit is MB. For each resource, the "dedicated" field can be set during POST.
taskCount Integer Yes No

The number of tasks (processors) required by this job.
tasksPerNode Integer Yes No

The number of tasks to map to each node. If you specify tasksPerNode, you must also specify taskCount.
totalDedicatedProcessors Integer No No

JobRequirementAttribute

Field Name Type POST PUT Description
comparator String Yes No

The comparison operator. Valid values:

  • >= - Greater than or equal to
  • > - Greater than
  • <= - Less than
  • < - Less than
  • %= - Equals
  • %! - Not equals
  • Null - Defaults to %=
  • = - (Deprecated) Equivalent to %=
displayValue String Yes No

The display value for the required attribute.
restriction JobRequirementAttributeRestriction Yes No

The restriction of this attribute. May be null, but defaults to JobRequirementAttributeRestriction.must.
value String Yes No

The value of the required attribute. During POST, if value is missing, blank, or null, do not provide a comparator.

JobRequirementAttributeRestriction

Represents a restriction for a job requirement attribute.

Value Description
must

JobRequirementFeaturesMode

Value Description
OR
AND

NodeAccessPolicy

This enumeration describes how node resources will be shared by various tasks.

Value Description
NONE
SHARED Tasks from any combination of jobs may utilize available resources.
SHAREDONLY Only jobs requesting shared node access may utilize available resources.
SINGLEJOB Tasks from a single job may utilize available resourceses.
SINGLETASK A single task from a single job may run on the node.
SINGLEUSER Tasks from any jobs owned by the same user may utilize available resources.
UNIQUEUSER Any number of tasks from a single job may allocate resources from a node but only if the user has no other jobs running on that node.
SINGLEGROUP Any number of tasks from the same group may utilize node.
SINGLEACCOUNT Any number of tasks from the same account may utilize node.
SINGLECLASS Any number of tasks from the same class may utilize node.
SINGLEQOS Any number of tasks from the same QOS (quality of service) may utilize node.

NodeAllocationPolicy

Node Allocation enumeration.

Value Description
FIRSTSET
MINGLOBAL
MINLOCAL
PLUGIN
NONE No node allocation policy is specified. Moab defaults to MINRESOURCE when this is the case.
FIRSTAVAILABLE Simple first come, first served algorithm where nodes are allocated in the order they are presented by the resource manager. This is a very simple, very fast algorithm.
LASTAVAILABLE This algorithm selects resources so as to minimize the amount of time after the job and before the trailing reservation. This algorithm is a best fit in time algorithm which minimizes the impact of reservation based node-time fragmentation. It is useful in systems where a large number of reservations (job, standing, or administrative) are in place.
MINRESOURCE This algorithm prioritizes nodes according to the configured resources on each node. Those nodes with the fewest configured resources which still meet the job's resource constraints are selected.
CPULOAD Nodes are selected which have the maximum amount of available, unused cpu power, i.e. [# of CPU's] - [CPU load]. Good algorithm for timesharing node systems. This algorithm is only applied to jobs starting immediately. For the purpose of future reservations, the MINRESOURCE algorithm is used.
LOCAL This will call the locally created contrib node allocation algorithm.
CONTIGUOUS This algorithm will allocate nodes in contiguous (linear) blocks as required by the Compaq RMS system.
MAXBALANCE This algorithm will attempt to allocate the most 'balanced' set of nodes possible to a job. In most cases, but not all, the metric for balance of the nodes is node speed. Thus, if possible, nodes with identical speeds will be allocated to the job. If identical speed nodes cannot be found, the algorithm will allocate the set of nodes with the minimum node speed 'span' or range.
PRIORITY This algorithm allows a site to specify the priority of various static and dynamic aspects of compute nodes and allocate them with preference for higher priority nodes. It is highly flexible allowing node attribute and usage information to be combined with reservation affinity.
FASTEST This algorithm will select nodes in 'fastest node first' order. Nodes will be selected by node speed if specified. If node speed is not specified, nodes will be selected by processor speed. If neither is specified, nodes will be selected in a random order.
PROCESSORLOAD Alias for CPULOAD.
NODESPEED Alias for FASTEST.
INREPORTEDORDER Alias for FIRSTAVAILABLE.
INREVERSEREPORTEDORDER Alias for LASTAVAILABLE.
CUSTOMPRIORITY Alias for PRIORITY.
PROCESSORSPEEDBALANCE Alias for MAXBALANCE.
MINIMUMCONFIGUREDRESOURCES Alias for MINRESOURCE.
CRAY3DTORUS Enable topology awareness scheduling algorithm.

AllocatedNode

Field Name Type POST PUT Description
name String No No

taskCount Integer No No

JobResource

Represents counts of dedicated and utilized resources.

Field Name Type POST PUT Description
dedicated Integer No No

The amount of this resource that has been allocated for running workload.
utilized Integer No No

The amount of this resource that is currently reported as utilized by resource managers.

JobResourceFailPolicyType

Value Description
CANCEL
FAIL
HOLD
IGNORE
NOTIFY
REQUEUE

ResourceManager

Field Name Type POST PUT Description
isDestination Boolean No No

isSource Boolean No No

jobName String No No

name String No No

JobStateInformation

Field Name Type POST PUT Description
state JobState No No

stateExpected JobState No No

stateLastUpdatedDate Date No No

subState JobSubState No No

JobState

Value Description
Idle Eligible according to all resource manager constraints.
Starting Job is launching, executing prolog.
Running Job is executing.
Removed Job was canceled before executing.
Completed Job successfully completed execution.
Hold Job is blocked by hold.
Deferred Job has a temporary hold.
Vacated Job was canceled after partial execution.
NotQueued Job is not eligible for execution.
Unknown Job state is unknown.
Staging Staging of input/output data is currently underway.
Suspended Job is no longer executing and remains in memory on the allocated compute nodes.
Blocked

JobSubState

Value Description
Epilogue
Migrated
Preempted
Prologue

JobSystemJobType

Value Description
generic Generic system job (trigger attached).
osprovision Reprovision operating system.
osprovision2 Perform two-phase (base and virtual machine) operating system reprovision.
poweroff Power off node.
poweron Power on node.
reset Reboot node.
storage Dynamic storage allocation.
vmmap Map to virtual machine to track resource consumption.
vmmigrate Migrate virtual machine.
vmtracking Job for tracking a virtual machine.

JobActionType

Value Description
DESTROY
MIGRATE
MODIFY

VMUsagePolicy

This enumeration describes the virtual machine requirements of a job

Value Description
REQUIREPM Requires a physical machine.
PREFPM Prefers a physical machine.
CREATEVM Creates a virtual machine.
CREATEPERSISTENTVM Creates a virtual machine that doesn't go away after the job is done.
REQUIREVM Requires a virtual machine.
PREFVM Prefers a virtual machine.

Related Topics 

© 2016 Adaptive Computing