Visit Platform at http://www.platform.com

AllocationService

Operation: RequestAllocation The RequestAllocation operation is used by an EGO client to make a request for resources. The client must be registered before being able to use this operation.
Input Message

The request contains the following sub-elements:

  • ClientName - the name of a successfully registered EGO client.
  • AllocationSpecification - a description of the requested allocation.
  • Option - the following options are supported:
    • EGO_ALLOC_EXCLUSIVE - for cpu slot allocations, this flag tells vemkd to allocate a host exclusively to this allocation. That is, no other allocations can claim slots from the hosts that are part of this allocation.
Output Message

The response message contains the AllocationID of a successfully created allocation.


Operation: ModifyAllocation This operation is used to modify the parameters of an existing allocation.
Input Message

The request message contains the following sub-elements:

  • ClientName - the name of a successfully registered EGO client.
  • AllocationID - the allocation that is to be modified.
  • AllocationSpecification - a description of the parameters to change within the existing allocation.
  • Option - the following options are supported:
    • EGO_REALLOC_DELTA - the minResources and maxResources elements that are within the provided AllocationSpecification will be interpreted as deltas to the original request, rather than absolute values.
Output Message

Currently, the response message from ModifyAllocation is an empty element tag (<ModifyAllocationResponse/>).


Operation: CancelAllocation This operation is used to cancel an existing allocation. Cancelling an allocation implies that all resources assigned to the allocation are reclaimed by EGO, and that all activities running within these allocations are terminated.
Input Message

The request message contains the following sub-elements:

  • ClientName - the name of a successfully registered EGO client.
  • AllocationID - the allocation that is to be cancelled.
Output Message

Currently, the response message from CancelAllocation is an empty element tag (<CancelAllocationResponse/>).


Operation: ReleaseResource This operation is used to release or replace a Resource that has been assigned to an allocation.
Input Message

The request message has the following sub-elements:

  • ClientName - the name of a successfully registered EGO client.
  • AllocationID - the allocation from which resources are to be released.
  • ResourceEntry - one or more elements describing which resources to remove from the allocation. They must be part of the existing allocation to be released.
  • Option - the following options are supported:
    • EGO_RELEASE_AUTOADJ - when this option is set, EGO will adjust the parameters of the allocation such that the new value of MaxResources will be set to the current number of resources allocated. This has the effect of stopping EGO from replacing the released resource. It takes precedence over EGO_RELEASE_MODIFY if both are used together.
    • EGO_RELEASE_MODIFY - when this option is set, EGO will adjust the parameters of the allocation such that the new value of MaxResources will be decremented by the number of resources being released. If the minimum becomes larger than the maximum then it will be set equal to the maximum. It is superceeded by EGO_RELEASE_AUTOADJ if both are used together.
    • EGO_RELEASE_BLOCKED - when this option is set, EGO will not replace the released resource with the same resource. This is useful to set if some application related problem caused the named resource to be unuseable by the EGO client (for example, a library version mismatch).
Output Message

Currently, the response message from ReleaseResource is an empty element tag (<ReleaseResourceResponse/>).


Operation: ListAllocations This operation is unimplemented at this time.
Input Message
Output Message

Operation: AllocationPreference The operation removes resources from BLOCK list.
Input Message

The request message has the following sub-elements:

  • ClientName - the name of a successfully registered EGO client.
  • AllocationID - the allocation that is to be modified.
  • AllocationPreference - array of allocation preferences.
Output Message

Currently, the response message from AllocationPreference is an empty element tag (<AllocationPreferenceResponse/>).




Date Modified: 26 Nov 2007
Platform Computing: www.platform.com

Platform Support: support@platform.com
Platform Information Development: doc@platform.com

Copyright © 1994-2007 Platform Computing Corporation. All rights reserved.