HP 3PAR StoreServ 7200 2-node HP 3PAR CIM API Programming Reference (OS 3.1.2 - Page 71
TPD_ConcreteJob, RequestStateChange() Method, GetError() Method
View all HP 3PAR StoreServ 7200 2-node manuals
Add to My Manuals
Save this manual to your list of manuals |
Page 71 highlights
• 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 ValueMap 1 4 5 4096 4098 Values Not supported Failed Invalid Parameter Method Parameters Checked Transition Started Use of Timeout Parameter Not Supported Explanation/Notes RequestedState not supported. This is the normal successful return case, as a task may not be terminated immediately. If TimeoutPeriod parameter is not NULL. 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