OnFailStep Property

この機能は、将来のバージョンの Microsoft SQL Server では削除される予定です。新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。

The OnFailStep property identifies the SQL Server Agent job step executed after failure of the referenced step.

構文

object
.OnFailStep [= value]

Parts

  • object
    An expression that evaluates to an object in the Applies To list
  • value
    A long integer that specifies a job step by ordinal number

Data Type

Long

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetOnFailStep(LPLONG pRetVal);
HRESULT SetOnFailStep(long NewValue);

解説

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.

To direct job failure logic to a specific step

  1. Set OnFailStep to indicate the job step that should execute.

  2. Set the OnFailAction property to SQLDMOJobStepAction_/GotoStep.

Applies To:

JobStep Object