/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 theWAITING
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 usingTERMINATE_CLUSTER
instead.If a cluster's
StepConcurrencyLevel
is greater than1
, do not useAddJobFlowSteps
to submit a step with this parameter set toCANCEL_AND_WAIT
orTERMINATE_CLUSTER
. The step is not submitted and the action fails with a message that theActionOnFailure
setting is not valid.If you change a cluster's
StepConcurrencyLevel
to be greater than 1 while a step is running, theActionOnFailure
parameter may not behave as you expect. In this case, for a step that fails with this parameter set toCANCEL_AND_WAIT
, pending steps and the running step are not canceled; for a step that fails with this parameter set toTERMINATE_CLUSTER
, the cluster does not terminate.
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 theWAITING
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 usingTERMINATE_CLUSTER
instead.If a cluster's
StepConcurrencyLevel
is greater than1
, do not useAddJobFlowSteps
to submit a step with this parameter set toCANCEL_AND_WAIT
orTERMINATE_CLUSTER
. The step is not submitted and the action fails with a message that theActionOnFailure
setting is not valid.If you change a cluster's
StepConcurrencyLevel
to be greater than 1 while a step is running, theActionOnFailure
parameter may not behave as you expect. In this case, for a step that fails with this parameter set toCANCEL_AND_WAIT
, pending steps and the running step are not canceled; for a step that fails with this parameter set toTERMINATE_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 |
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
.