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]](figures/note.png) | 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 |