Home | Table of Contents | KillGraph | CloverETL 4.6.1
--- | --- | ---
Prev | Job Control | Next

## KillGraph

# Jobflow Component

Short Description
Ports
Metadata
KillGraph Attributes
Details
See also

### Short Description

KillGraph aborts specified graphs and passes their final status to output port.

| Note
To be able to use this component, you need a separate jobflow license. Also, the component requires your project is executed on CloverETL Server.

Component | Same input metadata | Sorted inputs | Inputs | Outputs | Each to all outputs | Java | CTL | Auto-propagated metadata
--- | --- | --- | --- | --- | --- | --- | --- | ---
KillGraph |  |  | 0-1 | 0-1 |  |  |  |

### Icon

### Ports

Port type | Number | Required | Description | Metadata
--- | --- | --- | --- | ---
Input | 0 |  | Input tokens with identifications of interrupted graphs. | Any
Output | 0 |  | Final graph execution status. | Any

### Metadata

KillGraph does not propagate metadata from left to right or from right to left.

This component has metadata templates. The templates are described in Details. General details on metadata templates are available in Metadata Templates.

### KillGraph Attributes

Attribute | Req | Description | Possible values
--- | --- | --- | ---
Basic
Run ID | no | Specifies run ID of interrupted graph. Has higher priority than 'Execution group' attribute. This attribute can be overridden in input mapping. | long
Execution group | no | All graphs belonging to the specified execution group are interrupted. 'Run ID' attribute has higher priority. This attribute can be overridden in input mapping. | string
Kill daemon children | no | Specifies whether even daemon children are interrupted. Non-daemon children are aborted in any case. This attribute can be overridden in input mapping. | false (default) | true
Input mapping | no | Input mapping defines how to extract run ID or execution group to be interrupted from incoming token. See Input mapping. | CTL transformation
Output mapping | no | Output mapping defines how to populate the output token by final graph status of interrupted graph. See Output mapping. | CTL transformation

### Details

The KillGraph component aborts graphs specified by run ID or by execution group (all graphs belonging to the execution group are aborted). Final execution status of interrupted graphs is passed to output port or just printed out to log. Moreover, you can choose if even daemon children of interrupted graphs are aborted (non-daemon children are interrupted in any case) - see Execute graph as daemon attribute of ExecuteGraph.

The component reads input token, extracts run ID or execution group from incoming data (see Input mapping attribute), interrupts the requested graphs and writes final status of interrupted graph to the output port (see Output mapping attribute).

In case the input port is not attached, just the graphs specified in Run ID attribute or in Execution group attribute are interrupted.

#### Input mapping

Input mapping is regular CTL transformation which is executed for each input token to extract run ID or execution group to be interrupted. Output record has following structure:

Field Name | Type | Description
--- | --- | ---
runId | long | Overrides component attribute Run ID
executionGroup | string | Overrides component attribute Execution group
killDaemonChildren | boolean | Overrides component attribute Kill daemon children

#### Output mapping

Output mapping is regular CTL transformation which is executed for interrupted graph to populate the output token. Available input data has following structure:

Field Name | Type | Description
--- | --- | ---
runId | long | run ID of interrupted graph
originalJobURL | string | path to interrupted graph
version | string | version of interrupted graph
startTime | date | time of graph execution
endTime | date | time of graph finish
duration | long | graph run execution time in milliseconds (endTime - startTime)
status | string | final graph execution status (FINISHED_OK | ERROR | ABORTED | TIMEOUT)
errException | string | cause exception for failed graphs
errMessage | string | error message for failed graphs
errComponent | string | component ID which caused graph fail
errComponentType | string | type of component which caused graph fail

### See also

Common Properties of Components
Specific Attribute Types
Common Properties of Job Control
Job control Comparison

Prev | Up | Next
GetJobInput | Home | Table of Contents | KillJobflow