OnFailAction Property
Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam.
The OnFailAction property controls the behavior of a SQL Server Agent job when the referenced step fails execution.
Sintaxe
object
.OnFailAction [= value]
Parts
object
An expression that evaluates to an object in the Applies To list.value
A long integer that specifies job logic as described in Settings.
Data Type
Long, enumerated
Modifiable
Read/write
Prototype (C/C++)
HRESULT GetOnFailAction(SQLDMO_JOBSTEPACTION_TYPE* pRetVal);
HRESULT SetOnFailAction(SQLDMO_JOBSTEPACTION_TYPE NewValue);
Settings
Constant |
Value |
Description |
|---|---|---|
SQLDMOJobStepAction_/GotoNextStep |
3 |
Continues execution at the next sequential step. |
SQLDMOJobStepAction_/GotoStep |
4 |
Continues execution at the next identified step. |
SQLDMOJobStepAction_/QuitWithFailure |
2 |
Stops job execution, reporting failure. |
SQLDMOJobStepAction_/QuitWithSuccess |
1 |
Stops job execution, reporting success. |
SQLDMOJobStepAction_/Unknown |
0 |
Job step logic is unassigned for the referenced job step. |
Comentários
On failure of a job step, SQL Server Agent can stop the job (reporting success or failure), or if the job has more than a single step, it can attempt to execute the next step or another step in the job.
When using SQLDMOJobStepAction_/GotoStep to direct execution to a specific step, set the OnFailStep property to identify the job step executed on failure.