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

ConsumerService

Operation: GetConsumerTree This operation is used to retrieve the current consumer tree for the EGO cluster. This includes both configured parameters and some of the run time information that drives the allocation algorithm.
Input Message

Currently, the request message for GetConsumerTree contains these sub-elements:

  • Role - as which the tree is requested. Currently consumer_user and consumer_admin are the only valid names.
Output Message

The response message contains a DistributionPolicyConfiguration.


Operation: SetConsumerTree This operation allows an EGO administrator to manipulate the current consumer tree. The given ConsumerTree is "spliced" onto the existing ConsumerTree at the point indicated by ConsumerName.
Input Message

The request contains these sub-elements:

  • ConsumerID - the point in the existing consumer tree where the new tree will be "spliced".
  • DistributionPolicyConfiguration - the Conumer hierarchy sub-tree to be added to the existing consumer tree along with the distribution tree.
Output Message

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


Operation: ManageConsumer This operation allows an administrator to manipulate the properties of nodes within the consumer tree. The operation is chosen using the ManageConsumerOperation element.
Input Message

The request contains the following sub-elements:

  • ManageConsumerOperation - one of the strings "add", "delete" or "set" depending on which operation is desired.
  • ConsumerName - the point in the tree that is to be modified.
  • Consumer - the properties that are to be defined at this node in the tree. If the operation is "delete", then the Consumer element should not be specified.
  • DistributionTreeName - an array of distribution tree names used in add and set operations.
Output Message

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


Operation: GetConsumerAllocInfo This operation allows a normal user to get the allocation information of a consumer tree. The operation is chosen using the GetConsumerAllocInfo element.
Input Message

The request contains one element:the name of an existing consumer.

Output Message

The response message from GetConsumerAllocInfo contains a sequence of allocation information blocks.


Operation: GetConsumerHosts This operation allows a consumer user to get the hosts allocated to a particular consumer.The operation is chosen using the GetConsumerHostsInfo element.
Input Message

The request contains one element:the pathname of an existing consumer.

Output Message

The response message from GetConsumerHosts which contains a sequence of host blocks.




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.