OnFailAction Property
この機能は、将来のバージョンの Microsoft SQL Server では削除される予定です。新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。
The OnFailAction property controls the behavior of a SQL Server Agent job when the referenced step fails execution.
構文
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. |
解説
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.
Applies To:
|