# Class CIM_BasicExecutionService
extends CIM_Service

The basic execution service (BES)is a service to which clients can send requests to initiate, monitor, and manage computational activities and access information about the BES. A BasicExecutionService can act on one or more execution environments - modeled, profiled, and instantiated as a ComputerSystem. There is no requirement that a BasicExecutionService reside on the node of a ComputerSystem on which it acts. The associations ServiceAvailToElement and ServiceAffectsElement relate the BasicExecutionService to ComputerSystem. The association HostedDependency expresses the concept that an execution environment may be contained within another execution environment. For example, in a grid or distributed/virtualized environment the whole point for not explicitly stating which execution environment to use up front is to allow some client software, e.g. scheduler, orchestrator, provisioner, application, to determine where to place the activity (in which execution environment) based on the input activity document (that activity's environment/resource requirements).

### Table of Contents
Hierarchy
Direct Known Subclasses
Class Qualifiers
Class Properties
Class Methods

## Class Hierarchy

CIM_ManagedElement
|
+--CIM_ManagedSystemElement
|
+--CIM_LogicalElement
|
+--CIM_EnabledLogicalElement
|
+--CIM_Service
|
+--CIM_BasicExecutionService

## Direct Known Subclasses

## Class Qualifiers

Name | Data Type | Value
--- | --- | ---
Description | string | The basic execution service (BES)is a service to which clients can send requests to initiate, monitor, and manage computational activities and access information about the BES. A BasicExecutionService can act on one or more execution environments - modeled, profiled, and instantiated as a ComputerSystem. There is no requirement that a BasicExecutionService reside on the node of a ComputerSystem on which it acts. The associations ServiceAvailToElement and ServiceAffectsElement relate the BasicExecutionService to ComputerSystem. The association HostedDependency expresses the concept that an execution environment may be contained within another execution environment. For example, in a grid or distributed/virtualized environment the whole point for not explicitly stating which execution environment to use up front is to allow some client software, e.g. scheduler, orchestrator, provisioner, application, to determine where to place the activity (in which execution environment) based on the input activity document (that activity's environment/resource requirements).
Experimental | boolean | true
UMLPackagePath | string | CIM::Core::Grid
Version | string | 2.16.0

## Class Properties

### Inherited Properties

Name | Data Type | Class Origin
--- | --- | ---
Caption | string | CIM_ManagedElement
CommunicationStatus | uint16 | CIM_ManagedSystemElement
CreationClassName | string | CIM_Service
Description | string | CIM_ManagedElement
DetailedStatus | uint16 | CIM_ManagedSystemElement
ElementName | string | CIM_ManagedElement
EnabledDefault | uint16 | CIM_EnabledLogicalElement
EnabledState | uint16 | CIM_EnabledLogicalElement
Generation | uint64 | CIM_ManagedElement
HealthState | uint16 | CIM_ManagedSystemElement
InstallDate | datetime | CIM_ManagedSystemElement
InstanceID | string | CIM_ManagedElement
Name | string | CIM_Service
OperatingStatus | uint16 | CIM_ManagedSystemElement
OtherEnabledState | string | CIM_EnabledLogicalElement
PrimaryOwnerContact | string | CIM_Service
PrimaryOwnerName | string | CIM_Service
PrimaryStatus | uint16 | CIM_ManagedSystemElement
RequestedState | uint16 | CIM_EnabledLogicalElement
Started | boolean | CIM_Service
StartMode | string | CIM_Service
Status | string | CIM_ManagedSystemElement
SystemCreationClassName | string | CIM_Service
SystemName | string | CIM_Service
TimeOfLastStateChange | datetime | CIM_EnabledLogicalElement
TransitioningToState | uint16 | CIM_EnabledLogicalElement
AvailableRequestedStates | uint16[] | CIM_EnabledLogicalElement
OperationalStatus | uint16[] | CIM_ManagedSystemElement
StatusDescriptions | string[] | CIM_ManagedSystemElement

## Class Methods

### Local Class Methods

#### CreateActivity (uint32)

#### Method Qualifiers (CreateActivity)

Name | Data Type | Value
--- | --- | ---
Description | string | This operation adds requests to the execution environment. For example, within the context of the OGSA Basic Execution Services, this means that a new activity is added to an execution environment, and the operation maps to the CreateActivity() interface. CreateActivity establishes the 'binding' between the activity and the execution environment that will contain it. Selection / implementation of how an execution environment is outside the scope of basic execution service. In a grid or distributed environment, this allows other clients, e.g. schedulers, orchestrators, applications, to make decisions on which execution environment to select (place activity) based on the JSDL job description (the input activity document that describes that activity's environment/resource requirements. The return value should be 0 if the request was successfully executed and some other value if an error occurred. The output the CreateActivity method is an identifier which is used as input to other methods in this class to identify the activity being acted upon.
MappingStrings | string | MIF.OGF|GFD.108|CreateActivity.Faults
ValueMap | string | 0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 32768..65535
Values | string | Operation Completed with No Error, Not Supported, Unknown, Not Authorized, Not Accepting New Activities, Unsupported Feature, Invalid Request Message, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

#### Method Parameters (CreateActivity)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
Identifier | string
Description | string | Identifier associated with the requested execution. This Identifier is used as input to other Basic Execution service methods.
IN | boolean | false
MappingStrings | string | MIF.OGF|GFD.108|CreateActivity.Response, MIF.OASIS|WS-Addressing, MIF.OGF|GFD.56|jsdl:JobDefinition
OUT | boolean | true
Request | string
Description | string | Describes a single request that is to be executed by an execution environment.
IN | boolean | true
MappingStrings | string | MIF.OGF|GFD.108|CreateActivity.ActivityDocument, MIF.OGF|GFD.56|jsdl:JobDefinition
Job | REF CIM_ConcreteJob
Description | string | Reference to the job (can be null if the task is completed).
IN | boolean | false
OUT | boolean | true

#### TerminateActivity (uint32)

#### Method Qualifiers (TerminateActivity)

Name | Data Type | Value
--- | --- | ---
Description | string | This operation requests that one or more items in an execution environment be terminated. For example, within the context of the OGSA Basic Execution Services, this means that a new or existing activity in the container can be requested to be terminated, and the operation maps to the TerminateActivities() interface. The return value should be 0 if the request was successfully executed and some other value if an error occurred. The return code Invalid Request Message refers to the input of an invalid identifier.
MappingStrings | string | MIF.OGF|GFD.108|TerminateActivities.Faults
ValueMap | string | 0, 1, 2, 3, .., 4096, 4097..32767, 32768..65535
Values | string | Operation Completed with No Error, Not Supported, Unknown, Invalid Activity Identifer, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

#### Method Parameters (TerminateActivity)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
Identifier | string[]
Description | string | Identifies one or more items in an execution environment that are to be terminated.
IN | boolean | true
MappingStrings | string | MIF.OGF|GFD.108|TerminateActivities.ActivityIdentifiers, MIF.OASIS|WS-Addressing
Response | boolean[]
Description | string | Boolean response value for each requested termination. A value of TRUE indicates successful termination.
IN | boolean | false
MappingStrings | string | MIF.OGF|GFD.108|TerminateActivities.Response
OUT | boolean | true
Job | REF CIM_ConcreteJob
Description | string | Reference to the job (can be null if the task is completed).
IN | boolean | false
OUT | boolean | true

#### GetActivityStatus (uint32)

#### Method Qualifiers (GetActivityStatus)

Name | Data Type | Value
--- | --- | ---
Description | string | This operation requests the status of one or more items in an execution environment. For example, within the context of the OGSA Basic Execution Services, this means that the status of one or more activities within an execution environment can be obtained, and the operation maps to the GetActivityStatuses() interface. The return value should be 0 if the request was successfully executed and some other value if an error occurred. The return code Invalid Request Message refers to the input of an invalid identifier.
MappingStrings | string | MIF.OGF|GFD.108|GetActivityStatuses.Faults
ValueMap | string | 0, 1, 2, 3, .., 4096, 4097..32767, 32768..65535
Values | string | Operation Completed with No Error, Not Supported, Unknown, Invalid Activity Identifier, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

#### Method Parameters (GetActivityStatus)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
Identifier | string[]
Description | string | Identifies one or more items in an execution environment whose status will be obtained.
IN | boolean | true
MappingStrings | string | MIF.OGF|GFD.108|GetActivityStatuses.ActivityIdentifiers, MIF.OASIS|WS-Addressing
StatusResponse | string[]
Description | string | A response for each requested status.
IN | boolean | false
MappingStrings | string | MIF.OGF|GFD.108|GetActivityStatuses.Response
OUT | boolean | true
Job | REF CIM_ConcreteJob
Description | string | Reference to the job (can be null if the task is completed).
IN | boolean | false
OUT | boolean | true

#### GetActivityDocuments (uint32)

#### Method Qualifiers (GetActivityDocuments)

Name | Data Type | Value
--- | --- | ---
Description | string | This operation requests activity document descriptions for a set of specified set of activities. These activity documents may be different from those initially input in the CreateActivity operation since this service may alter its contents to reflect policy or process within the service. The return code Invalid Request Message refers to the input of an invalid identifier.
MappingStrings | string | MIF.OGF|GFD.108|GetActivityDocuments.Faults
ValueMap | string | 0, 1, 2, 3, .., 4096, 4097..32767, 32768..65535
Values | string | Operation Completed with No Error, Not Supported, Unknown, Invalid Activity Identifier, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

#### Method Parameters (GetActivityDocuments)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
Identifier | string[]
Description | string | Identifies one or more activities for which activity documents are requested.
IN | boolean | true
MappingStrings | string | MIF.OGF|GFD.108|GetActivityDocuments.ActivityIdentifiers, MIF.OASIS|WS-Addressing
Response | string[]
Description | string | An array of activity document response elements.
IN | boolean | false
MappingStrings | string | MIF.OGF|GFD.108|GetActivityDocuments.Response
OUT | boolean | true
Job | REF CIM_ConcreteJob
Description | string | Reference to the job (can be null if the task is completed).
IN | boolean | false
OUT | boolean | true

#### GetAttributesDocument (uint32)

#### Method Qualifiers (GetAttributesDocument)

Name | Data Type | Value
--- | --- | ---
Description | string | This operation requests a document containing the basic execution service management attributes.The return code Invalid Request Message refers to the input of an invalid identifier.
MappingStrings | string | MIF.OGF|GFD.108|GetAttributesDocument.Faults
ValueMap | string | 0, 1, 2, .., 4096, 4097..32767, 32768..65535
Values | string | Operation Completed with No Error, Not Supported, Unknown, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

#### Method Parameters (GetAttributesDocument)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
AttrsDoc | string[]
Description | string | A XML document containing the various attributes within its associated container.
IN | boolean | false
MappingStrings | string | MIF.OGF|GFD.108|GetAttributesDocument.BESResourceAttributesDocument, MIF.OGF|GFD.56|JSDL Core Element Set and Appendix 1
OUT | boolean | true
Job | REF CIM_ConcreteJob
Description | string | Reference to the job (can be null if the task is completed).
IN | boolean | false
OUT | boolean | true

### Inherited Class Methods

Name | Return Type | Class Origin
--- | --- | ---
ChangeAffectedElementsAssignedSequence | uint32 | CIM_Service
RequestStateChange | uint32 | CIM_EnabledLogicalElement
StartService | uint32 | CIM_Service
StopService | uint32 | CIM_Service