Groovy Documentation

com.ace.mws.reservations
[Groovy] Class Reservation

java.lang.Object
  com.ace.mws.reservations.Reservation

class Reservation

A reservation is the mechanism by which Moab guarantees the availability of a set of resources at a particular time. Each reservation consists of three major components: (1) a set of resources, (2) a time frame, and (3) an access control list. It is a scheduler role to ensure that the access control list is not violated during the reservation's lifetime (that is, its time frame) on the resources listed. For example, a reservation may specify that node002 is reserved for user Tom on Friday. The scheduler is thus constrained to make certain that only Tom's jobs can use node002 at any time on Friday.


Field Summary
private String accountingAccount

Accountable Account.

private String accountingGroup

Accountable Group.

private String accountingQOS

Accountable QOS.

private String accountingUser

Accountable User.

private Set aclRules

(AclRule collection) The set of access control rules associated with this reservation.

private Integer allocatedNodeCount

The number of allocated nodes for this reservation.

private Set allocatedNodes

(Node collection) The nodes allocated to the reservation.

private Integer allocatedProcessorCount

The number of allocated processors.

private Integer allocatedTaskCount

The number of allocated tasks.

private String comments

Reservation's comments or description.

private Date creationDate

Creation date.

private Long duration

The duration of the reservation (in seconds).

private Date endDate

The end date of the reservation.

private Set excludeJobs

(String collection) The list of jobs to exclude.

private Date expireDate

The date/time when the reservation expires and vacates.

private Set flags

(ReservationFlag collection) The flags associated with the reservation.

private String globalId

Global reservation ID.

private String hostListExpression

The list of nodes a user can select to reserve.

private String id

The unique ID of the reservation.

private String idPrefix

The user-specified prefix for this reservation.

private Boolean isActive

State whether or not this reservation is currently active.

private Boolean isTracked

States whether reservation resource usage is tracked.

private String label

When a label is assigned to a reservation, the reservation can then be referenced by that label as well as by the reservation name.

private Integer maxTasks

The maximum number of tasks for this reservation.

private Set messages

(Message collection) Messages for the reservation.

private Credential owner

The owner of the reservation Valid during POST.

private String partitionId

The ID of the partition this reservation is for.

private String profile

The profile that this reservation is using.

private ReservationRequirement requirements

The reservation's requirements.

private String reservationGroup

The reservation group to which the reservation belongs.

private Map resources

(Map of String => Integer) The reservation's resources.

private Date startDate

The start time for the reservation.

private ReservationStatistics statistics

The reservation's statistical information.

private String subType

The reservation sub-type.

private Integer taskCount

The number of tasks that must be allocated to satisfy the reservation request.

private Trigger trigger

Trigger for reservation.

private Set triggerIds

(String collection) The IDs of the triggers attached to this reservation.

private String uniqueIndex

The globally-unique reservation index.

private Map variables

(Map of String => String) The set of variables for this reservation.

 
Constructor Summary
Reservation()

 
Method Summary
String getAccountingAccount()

Accountable Account.

String getAccountingGroup()

Accountable Group.

String getAccountingQOS()

Accountable QOS.

String getAccountingUser()

Accountable User.

Set getAclRules()

(AclRule collection) The set of access control rules associated with this reservation.

Integer getAllocatedNodeCount()

The number of allocated nodes for this reservation.

Set getAllocatedNodes()

(Node collection) The nodes allocated to the reservation.

Integer getAllocatedProcessorCount()

The number of allocated processors.

Integer getAllocatedTaskCount()

The number of allocated tasks.

String getComments()

Reservation's comments or description.

Date getCreationDate()

Creation date.

Long getDuration()

The duration of the reservation (in seconds).

Date getEndDate()

The end date of the reservation.

Set getExcludeJobs()

(String collection) The list of jobs to exclude.

Date getExpireDate()

The date/time when the reservation expires and vacates.

Set getFlags()

(ReservationFlag collection) The flags associated with the reservation.

String getGlobalId()

Global reservation ID.

String getHostListExpression()

The list of nodes a user can select to reserve.

String getId()

The unique ID of the reservation.

String getIdPrefix()

The user-specified prefix for this reservation.

Boolean getIsActive()

State whether or not this reservation is currently active.

Boolean getIsTracked()

States whether reservation resource usage is tracked.

String getLabel()

When a label is assigned to a reservation, the reservation can then be referenced by that label as well as by the reservation name.

Integer getMaxTasks()

The maximum number of tasks for this reservation.

Set getMessages()

(Message collection) Messages for the reservation.

Credential getOwner()

The owner of the reservation Valid during POST.

String getPartitionId()

The ID of the partition this reservation is for.

String getProfile()

The profile that this reservation is using.

ReservationRequirement getRequirements()

The reservation's requirements.

String getReservationGroup()

The reservation group to which the reservation belongs.

Map getResources()

(Map of String => Integer) The reservation's resources.

Date getStartDate()

The start time for the reservation.

ReservationStatistics getStatistics()

The reservation's statistical information.

String getSubType()

The reservation sub-type.

Integer getTaskCount()

The number of tasks that must be allocated to satisfy the reservation request.

Trigger getTrigger()

Trigger for reservation.

Set getTriggerIds()

(String collection) The IDs of the triggers attached to this reservation.

String getUniqueIndex()

The globally-unique reservation index.

Map getVariables()

(Map of String => String) The set of variables for this reservation.

void setAccountingAccount(String accountingAccount)

Accountable Account.

void setAccountingGroup(String accountingGroup)

Accountable Group.

void setAccountingQOS(String accountingQOS)

Accountable QOS.

void setAccountingUser(String accountingUser)

Accountable User.

void setAclRules(Set aclRules)

(AclRule collection) The set of access control rules associated with this reservation.

void setAllocatedNodeCount(Integer allocatedNodeCount)

The number of allocated nodes for this reservation.

void setAllocatedNodes(Set allocatedNodes)

(Node collection) The nodes allocated to the reservation.

void setAllocatedProcessorCount(Integer allocatedProcessorCount)

The number of allocated processors.

void setAllocatedTaskCount(Integer allocatedTaskCount)

The number of allocated tasks.

void setComments(String comments)

Reservation's comments or description.

void setCreationDate(Date creationDate)

Creation date.

void setDuration(Long duration)

The duration of the reservation (in seconds).

void setEndDate(Date endDate)

The end date of the reservation.

void setExcludeJobs(Set excludeJobs)

(String collection) The list of jobs to exclude.

void setExpireDate(Date expireDate)

The date/time when the reservation expires and vacates.

void setFlags(Set flags)

(ReservationFlag collection) The flags associated with the reservation.

void setGlobalId(String globalId)

Global reservation ID.

void setHostListExpression(String hostListExpression)

The list of nodes a user can select to reserve.

void setId(String id)

The unique ID of the reservation.

void setIdPrefix(String idPrefix)

The user-specified prefix for this reservation.

void setIsActive(Boolean isActive)

State whether or not this reservation is currently active.

void setIsTracked(Boolean isTracked)

States whether reservation resource usage is tracked.

void setLabel(String label)

When a label is assigned to a reservation, the reservation can then be referenced by that label as well as by the reservation name.

void setMaxTasks(Integer maxTasks)

The maximum number of tasks for this reservation.

void setMessages(Set messages)

(Message collection) Messages for the reservation.

void setOwner(Credential owner)

The owner of the reservation Valid during POST.

void setPartitionId(String partitionId)

The ID of the partition this reservation is for.

void setProfile(String profile)

The profile that this reservation is using.

void setRequirements(ReservationRequirement requirements)

The reservation's requirements.

void setReservationGroup(String reservationGroup)

The reservation group to which the reservation belongs.

void setResources(Map resources)

(Map of String => Integer) The reservation's resources.

void setStartDate(Date startDate)

The start time for the reservation.

void setStatistics(ReservationStatistics statistics)

The reservation's statistical information.

void setSubType(String subType)

The reservation sub-type.

void setTaskCount(Integer taskCount)

The number of tasks that must be allocated to satisfy the reservation request.

void setTrigger(Trigger trigger)

Trigger for reservation.

void setTriggerIds(Set triggerIds)

(String collection) The IDs of the triggers attached to this reservation.

void setUniqueIndex(String uniqueIndex)

The globally-unique reservation index.

void setVariables(Map variables)

(Map of String => String) The set of variables for this reservation.

String toString()

 
Methods inherited from class Object
wait, wait, wait, equals, toString, hashCode, getClass, notify, notifyAll
 

Field Detail

accountingAccount

private String accountingAccount
Accountable Account. Valid during POST.


accountingGroup

private String accountingGroup
Accountable Group. Valid during POST.


accountingQOS

private String accountingQOS
Accountable QOS. Valid during POST.


accountingUser

private String accountingUser
Accountable User. Valid during POST.


aclRules

private Set aclRules
(AclRule collection) The set of access control rules associated with this reservation. Valid during POST.
See Also:
AclRule


allocatedNodeCount

private Integer allocatedNodeCount
The number of allocated nodes for this reservation.


allocatedNodes

private Set allocatedNodes
(Node collection) The nodes allocated to the reservation.
See Also:
Node


allocatedProcessorCount

private Integer allocatedProcessorCount
The number of allocated processors.


allocatedTaskCount

private Integer allocatedTaskCount
The number of allocated tasks.


comments

private String comments
Reservation's comments or description. Valid during POST.


creationDate

private Date creationDate
Creation date. Automatically set by Moab when a user creates the reservation.


duration

private Long duration
The duration of the reservation (in seconds). Valid during POST.


endDate

private Date endDate
The end date of the reservation. This is especially useful for one-time reservations, which have an exact time for when a reservation ends. Valid during POST.


excludeJobs

private Set excludeJobs
(String collection) The list of jobs to exclude. Client must also set the IGNJOBRSV reservation flag. Otherwise, results are undefined. Used only during reservation creation. Valid during POST.
See Also:
String


expireDate

private Date expireDate
The date/time when the reservation expires and vacates.


flags

private Set flags
(ReservationFlag collection) The flags associated with the reservation. Valid during POST.
See Also:
ReservationFlag


globalId

private String globalId
Global reservation ID.


hostListExpression

private String hostListExpression
The list of nodes a user can select to reserve. This may or may not be the nodes that are currently allocated to this reservation. Note: Either hostListExpression or taskCount must be set to create a reservation. Valid during POST.


id

private String id
The unique ID of the reservation.


idPrefix

private String idPrefix
The user-specified prefix for this reservation. If provided, Moab combines the idPrefix with an integer, and the combination is the unique identifier for this reservation. Valid during POST.


isActive

private Boolean isActive
State whether or not this reservation is currently active.


isTracked

private Boolean isTracked
States whether reservation resource usage is tracked.


label

private String label
When a label is assigned to a reservation, the reservation can then be referenced by that label as well as by the reservation name. Valid during POST.


maxTasks

private Integer maxTasks
The maximum number of tasks for this reservation.


messages

private Set messages
(Message collection) Messages for the reservation.
See Also:
Message


owner

private Credential owner
The owner of the reservation Valid during POST.


partitionId

private String partitionId
The ID of the partition this reservation is for. Valid during POST.


profile

private String profile
The profile that this reservation is using. A profile is a specification of attributes that all reservations share. Used only during reservation creation. Valid during POST.


requirements

private ReservationRequirement requirements
The reservation's requirements. Valid during POST.


reservationGroup

private String reservationGroup
The reservation group to which the reservation belongs. Valid during POST.


resources

private Map resources
(Map of String => Integer) The reservation's resources. This field is a map, where the key is PROCS, MEM DISK, SWAP, or one or more user-defined keys. Valid during POST.
See Also:
Integer


startDate

private Date startDate
The start time for the reservation. This is especially useful for one-time reservations, which have an exact time for when a reservation starts. Valid during POST.


statistics

private ReservationStatistics statistics
The reservation's statistical information.


subType

private String subType
The reservation sub-type. Valid during POST.


taskCount

private Integer taskCount
The number of tasks that must be allocated to satisfy the reservation request. Note: Either hostListExpression or taskCount must be set to create a reservation.


trigger

private Trigger trigger
Trigger for reservation. Used only during reservation creation. Valid during POST.


triggerIds

private Set triggerIds
(String collection) The IDs of the triggers attached to this reservation.
See Also:
String


uniqueIndex

private String uniqueIndex
The globally-unique reservation index.


variables

private Map variables
(Map of String => String) The set of variables for this reservation. Valid during PUT. Valid during POST.
See Also:
Map


 
Constructor Detail

Reservation

Reservation()


 
Method Detail

getAccountingAccount

String getAccountingAccount()
Accountable Account. Valid during POST.


getAccountingGroup

String getAccountingGroup()
Accountable Group. Valid during POST.


getAccountingQOS

String getAccountingQOS()
Accountable QOS. Valid during POST.


getAccountingUser

String getAccountingUser()
Accountable User. Valid during POST.


getAclRules

Set getAclRules()
(AclRule collection) The set of access control rules associated with this reservation. Valid during POST.
See Also:
AclRule


getAllocatedNodeCount

Integer getAllocatedNodeCount()
The number of allocated nodes for this reservation.


getAllocatedNodes

Set getAllocatedNodes()
(Node collection) The nodes allocated to the reservation.
See Also:
Node


getAllocatedProcessorCount

Integer getAllocatedProcessorCount()
The number of allocated processors.


getAllocatedTaskCount

Integer getAllocatedTaskCount()
The number of allocated tasks.


getComments

String getComments()
Reservation's comments or description. Valid during POST.


getCreationDate

Date getCreationDate()
Creation date. Automatically set by Moab when a user creates the reservation.


getDuration

Long getDuration()
The duration of the reservation (in seconds). Valid during POST.


getEndDate

Date getEndDate()
The end date of the reservation. This is especially useful for one-time reservations, which have an exact time for when a reservation ends. Valid during POST.


getExcludeJobs

Set getExcludeJobs()
(String collection) The list of jobs to exclude. Client must also set the IGNJOBRSV reservation flag. Otherwise, results are undefined. Used only during reservation creation. Valid during POST.
See Also:
String


getExpireDate

Date getExpireDate()
The date/time when the reservation expires and vacates.


getFlags

Set getFlags()
(ReservationFlag collection) The flags associated with the reservation. Valid during POST.
See Also:
ReservationFlag


getGlobalId

String getGlobalId()
Global reservation ID.


getHostListExpression

String getHostListExpression()
The list of nodes a user can select to reserve. This may or may not be the nodes that are currently allocated to this reservation. Note: Either hostListExpression or taskCount must be set to create a reservation. Valid during POST.


getId

String getId()
The unique ID of the reservation.


getIdPrefix

String getIdPrefix()
The user-specified prefix for this reservation. If provided, Moab combines the idPrefix with an integer, and the combination is the unique identifier for this reservation. Valid during POST.


getIsActive

Boolean getIsActive()
State whether or not this reservation is currently active.


getIsTracked

Boolean getIsTracked()
States whether reservation resource usage is tracked.


getLabel

String getLabel()
When a label is assigned to a reservation, the reservation can then be referenced by that label as well as by the reservation name. Valid during POST.


getMaxTasks

Integer getMaxTasks()
The maximum number of tasks for this reservation.


getMessages

Set getMessages()
(Message collection) Messages for the reservation.
See Also:
Message


getOwner

Credential getOwner()
The owner of the reservation Valid during POST.


getPartitionId

String getPartitionId()
The ID of the partition this reservation is for. Valid during POST.


getProfile

String getProfile()
The profile that this reservation is using. A profile is a specification of attributes that all reservations share. Used only during reservation creation. Valid during POST.


getRequirements

ReservationRequirement getRequirements()
The reservation's requirements. Valid during POST.


getReservationGroup

String getReservationGroup()
The reservation group to which the reservation belongs. Valid during POST.


getResources

Map getResources()
(Map of String => Integer) The reservation's resources. This field is a map, where the key is PROCS, MEM DISK, SWAP, or one or more user-defined keys. Valid during POST.
See Also:
Integer


getStartDate

Date getStartDate()
The start time for the reservation. This is especially useful for one-time reservations, which have an exact time for when a reservation starts. Valid during POST.


getStatistics

ReservationStatistics getStatistics()
The reservation's statistical information.


getSubType

String getSubType()
The reservation sub-type. Valid during POST.


getTaskCount

Integer getTaskCount()
The number of tasks that must be allocated to satisfy the reservation request. Note: Either hostListExpression or taskCount must be set to create a reservation.


getTrigger

Trigger getTrigger()
Trigger for reservation. Used only during reservation creation. Valid during POST.


getTriggerIds

Set getTriggerIds()
(String collection) The IDs of the triggers attached to this reservation.
See Also:
String


getUniqueIndex

String getUniqueIndex()
The globally-unique reservation index.


getVariables

Map getVariables()
(Map of String => String) The set of variables for this reservation. Valid during PUT. Valid during POST.
See Also:
Map


setAccountingAccount

void setAccountingAccount(String accountingAccount)
Accountable Account. Valid during POST.


setAccountingGroup

void setAccountingGroup(String accountingGroup)
Accountable Group. Valid during POST.


setAccountingQOS

void setAccountingQOS(String accountingQOS)
Accountable QOS. Valid during POST.


setAccountingUser

void setAccountingUser(String accountingUser)
Accountable User. Valid during POST.


setAclRules

void setAclRules(Set aclRules)
(AclRule collection) The set of access control rules associated with this reservation. Valid during POST.
See Also:
AclRule


setAllocatedNodeCount

void setAllocatedNodeCount(Integer allocatedNodeCount)
The number of allocated nodes for this reservation.


setAllocatedNodes

void setAllocatedNodes(Set allocatedNodes)
(Node collection) The nodes allocated to the reservation.
See Also:
Node


setAllocatedProcessorCount

void setAllocatedProcessorCount(Integer allocatedProcessorCount)
The number of allocated processors.


setAllocatedTaskCount

void setAllocatedTaskCount(Integer allocatedTaskCount)
The number of allocated tasks.


setComments

void setComments(String comments)
Reservation's comments or description. Valid during POST.


setCreationDate

void setCreationDate(Date creationDate)
Creation date. Automatically set by Moab when a user creates the reservation.


setDuration

void setDuration(Long duration)
The duration of the reservation (in seconds). Valid during POST.


setEndDate

void setEndDate(Date endDate)
The end date of the reservation. This is especially useful for one-time reservations, which have an exact time for when a reservation ends. Valid during POST.


setExcludeJobs

void setExcludeJobs(Set excludeJobs)
(String collection) The list of jobs to exclude. Client must also set the IGNJOBRSV reservation flag. Otherwise, results are undefined. Used only during reservation creation. Valid during POST.
See Also:
String


setExpireDate

void setExpireDate(Date expireDate)
The date/time when the reservation expires and vacates.


setFlags

void setFlags(Set flags)
(ReservationFlag collection) The flags associated with the reservation. Valid during POST.
See Also:
ReservationFlag


setGlobalId

void setGlobalId(String globalId)
Global reservation ID.


setHostListExpression

void setHostListExpression(String hostListExpression)
The list of nodes a user can select to reserve. This may or may not be the nodes that are currently allocated to this reservation. Note: Either hostListExpression or taskCount must be set to create a reservation. Valid during POST.


setId

void setId(String id)
The unique ID of the reservation.


setIdPrefix

void setIdPrefix(String idPrefix)
The user-specified prefix for this reservation. If provided, Moab combines the idPrefix with an integer, and the combination is the unique identifier for this reservation. Valid during POST.


setIsActive

void setIsActive(Boolean isActive)
State whether or not this reservation is currently active.


setIsTracked

void setIsTracked(Boolean isTracked)
States whether reservation resource usage is tracked.


setLabel

void setLabel(String label)
When a label is assigned to a reservation, the reservation can then be referenced by that label as well as by the reservation name. Valid during POST.


setMaxTasks

void setMaxTasks(Integer maxTasks)
The maximum number of tasks for this reservation.


setMessages

void setMessages(Set messages)
(Message collection) Messages for the reservation.
See Also:
Message


setOwner

void setOwner(Credential owner)
The owner of the reservation Valid during POST.


setPartitionId

void setPartitionId(String partitionId)
The ID of the partition this reservation is for. Valid during POST.


setProfile

void setProfile(String profile)
The profile that this reservation is using. A profile is a specification of attributes that all reservations share. Used only during reservation creation. Valid during POST.


setRequirements

void setRequirements(ReservationRequirement requirements)
The reservation's requirements. Valid during POST.


setReservationGroup

void setReservationGroup(String reservationGroup)
The reservation group to which the reservation belongs. Valid during POST.


setResources

void setResources(Map resources)
(Map of String => Integer) The reservation's resources. This field is a map, where the key is PROCS, MEM DISK, SWAP, or one or more user-defined keys. Valid during POST.
See Also:
Integer


setStartDate

void setStartDate(Date startDate)
The start time for the reservation. This is especially useful for one-time reservations, which have an exact time for when a reservation starts. Valid during POST.


setStatistics

void setStatistics(ReservationStatistics statistics)
The reservation's statistical information.


setSubType

void setSubType(String subType)
The reservation sub-type. Valid during POST.


setTaskCount

void setTaskCount(Integer taskCount)
The number of tasks that must be allocated to satisfy the reservation request. Note: Either hostListExpression or taskCount must be set to create a reservation.


setTrigger

void setTrigger(Trigger trigger)
Trigger for reservation. Used only during reservation creation. Valid during POST.


setTriggerIds

void setTriggerIds(Set triggerIds)
(String collection) The IDs of the triggers attached to this reservation.
See Also:
String


setUniqueIndex

void setUniqueIndex(String uniqueIndex)
The globally-unique reservation index.


setVariables

void setVariables(Map variables)
(Map of String => String) The set of variables for this reservation. Valid during PUT. Valid during POST.
See Also:
Map


toString

String toString()


 

Groovy Documentation