HP 3PAR CIM API Programming Reference (OS 3.1.2 MU2) (QL226-97015, June 2013)

• Promote virtual copy
• Update snapshot space
TPD_ConcreteJob
This is a new class, and each instance of this class represents a task.
RequestStateChange() Method
This method can be used to cancel a task. The input parameter RequestedState can only be
set to Terminate(4), since the InformOS task framework only supports task canceling.
uint32 RequestStateChange(
[In, REQ,
Values {"Start", "Suspend", "Terminate", "Kill", "Service"},
ValueMap {"2", "3", "4", "5", "6"}]
Uint16 RequestedState,
[In] dateTime TimeoutPeriod);
• RequestedState: Changes the state of a job.
◦
◦ Start: changes the state to running; not supported.
◦ Suspend: stops the job temporarily which can be resumed; not supported.
◦ Terminate: stops the job cleanly and orderly; this is the only supported value.
◦ Kill: terminate the job immediately; not supported.
◦ Service: puts the job into a service state; not supported.
• TimeoutPeriod: A timeout period that specifies the maximum amount of time that the client
expects the transition to the new state to take. This is not supported and must be NULL.
Table 58 Return Values for RequestStateChange() Operation
Explanation/NotesValuesValueMap
RequestedState not supported.Not supported1
Failed4
Invalid Parameter5
This is the normal successful return case,
as a task may not be terminated
immediately.
Method Parameters Checked -
Transition Started
4096
If TimeoutPeriod parameter is not NULL.Use of Timeout Parameter Not
Supported
4098
GetError() Method
When the job is executing or has terminated without error, then this method returns no CIM_Error
instance. However, if the job has failed because of some internal error, then a CIM_Error instance
is returned. This method is only used to fetch the failure reason for jobs that failed on their own,
i.e., not jobs that are canceled by the user.
uint32 GetError(
[Out,
Copy Services Subprofile 71