Skip to content

/AWS1/CL_EMRSTEPCONFIG

Specification for a cluster (job flow) step.

CONSTRUCTOR

IMPORTING

Required arguments:

iv_name TYPE /AWS1/EMRXMLSTRINGMAXLEN256 /AWS1/EMRXMLSTRINGMAXLEN256

The name of the step.

io_hadoopjarstep TYPE REF TO /AWS1/CL_EMRHADOOPJARSTEPCFG /AWS1/CL_EMRHADOOPJARSTEPCFG

The JAR file used for the step.

Optional arguments:

iv_actiononfailure TYPE /AWS1/EMRACTIONONFAILURE /AWS1/EMRACTIONONFAILURE

The action to take when the step fails. Use one of the following values:

  • TERMINATE_CLUSTER - Shuts down the cluster.

  • CANCEL_AND_WAIT - Cancels any pending steps and returns the cluster to the WAITING state.

  • CONTINUE - Continues to the next step in the queue.

  • TERMINATE_JOB_FLOW - Shuts down the cluster. TERMINATE_JOB_FLOW is provided for backward compatibility. We recommend using TERMINATE_CLUSTER instead.

If a cluster's StepConcurrencyLevel is greater than 1, do not use AddJobFlowSteps to submit a step with this parameter set to CANCEL_AND_WAIT or TERMINATE_CLUSTER. The step is not submitted and the action fails with a message that the ActionOnFailure setting is not valid.

If you change a cluster's StepConcurrencyLevel to be greater than 1 while a step is running, the ActionOnFailure parameter may not behave as you expect. In this case, for a step that fails with this parameter set to CANCEL_AND_WAIT, pending steps and the running step are not canceled; for a step that fails with this parameter set to TERMINATE_CLUSTER, the cluster does not terminate.

io_stepmonitoringconf TYPE REF TO /AWS1/CL_EMRSTEPMONITORINGCONF /AWS1/CL_EMRSTEPMONITORINGCONF

Object that holds configuration properties for logging.

Queryable Attributes

Name

The name of the step.

Accessible with the following methods

Method Description
GET_NAME() Getter for NAME, with configurable default
ASK_NAME() Getter for NAME w/ exceptions if field has no value
HAS_NAME() Determine if NAME has a value

ActionOnFailure

The action to take when the step fails. Use one of the following values:

  • TERMINATE_CLUSTER - Shuts down the cluster.

  • CANCEL_AND_WAIT - Cancels any pending steps and returns the cluster to the WAITING state.

  • CONTINUE - Continues to the next step in the queue.

  • TERMINATE_JOB_FLOW - Shuts down the cluster. TERMINATE_JOB_FLOW is provided for backward compatibility. We recommend using TERMINATE_CLUSTER instead.

If a cluster's StepConcurrencyLevel is greater than 1, do not use AddJobFlowSteps to submit a step with this parameter set to CANCEL_AND_WAIT or TERMINATE_CLUSTER. The step is not submitted and the action fails with a message that the ActionOnFailure setting is not valid.

If you change a cluster's StepConcurrencyLevel to be greater than 1 while a step is running, the ActionOnFailure parameter may not behave as you expect. In this case, for a step that fails with this parameter set to CANCEL_AND_WAIT, pending steps and the running step are not canceled; for a step that fails with this parameter set to TERMINATE_CLUSTER, the cluster does not terminate.

Accessible with the following methods

Method Description
GET_ACTIONONFAILURE() Getter for ACTIONONFAILURE, with configurable default
ASK_ACTIONONFAILURE() Getter for ACTIONONFAILURE w/ exceptions if field has no val
HAS_ACTIONONFAILURE() Determine if ACTIONONFAILURE has a value

HadoopJarStep

The JAR file used for the step.

Accessible with the following methods

Method Description
GET_HADOOPJARSTEP() Getter for HADOOPJARSTEP

StepMonitoringConfiguration

Object that holds configuration properties for logging.

Accessible with the following methods

Method Description
GET_STEPMONITORINGCONF() Getter for STEPMONITORINGCONFIGURATION

Public Local Types In This Class

Internal table types, representing arrays and maps of this class, are defined as local types:

TT_STEPCONFIGLIST

TYPES TT_STEPCONFIGLIST TYPE STANDARD TABLE OF REF TO /AWS1/CL_EMRSTEPCONFIG WITH DEFAULT KEY
.