OnFailAction Property

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