Compartir a través de

OnFailAction Property

  • Artículo

Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.

The OnFailAction property controls the behavior of a SQL Server Agent job when the referenced step fails execution.

Sintaxis

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.

Notas

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:

JobStep Object