forked from docs/doc-exports
chenxiaoxiong
f9e2808b7c
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com> Co-authored-by: chenxiaoxiong <chenxiaoxiong@huawei.com> Co-committed-by: chenxiaoxiong <chenxiaoxiong@huawei.com>
111 lines
15 KiB
HTML
111 lines
15 KiB
HTML
<a name="dataartsstudio_01_0467"></a><a name="dataartsstudio_01_0467"></a>
|
|
|
|
<h1 class="topictitle1">Subjob</h1>
|
|
<div id="body8662426"><div class="section" id="dataartsstudio_01_0467__en-us_topic_0157404961_section19542113151719"><h4 class="sectiontitle">Function</h4><p id="dataartsstudio_01_0467__en-us_topic_0157404961_p3484163316171">The Subjob node is used to call the batch job that does not contain the subjob node.</p>
|
|
</div>
|
|
<div class="section" id="dataartsstudio_01_0467__en-us_topic_0157404961_section55641359184"><h4 class="sectiontitle">Parameter</h4><p id="dataartsstudio_01_0467__en-us_topic_0157404961_p213913791810"><a href="#dataartsstudio_01_0467__en-us_topic_0157404961_table3764823994826">Table 1</a> and <a href="#dataartsstudio_01_0467__en-us_topic_0157404961_table58040457102411">Table 2</a> describe the parameters of the Subjob node.</p>
|
|
|
|
<div class="tablenoborder"><a name="dataartsstudio_01_0467__en-us_topic_0157404961_table3764823994826"></a><a name="en-us_topic_0157404961_table3764823994826"></a><table cellpadding="4" cellspacing="0" summary="" id="dataartsstudio_01_0467__en-us_topic_0157404961_table3764823994826" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters of subjob nodes</caption><thead align="left"><tr id="dataartsstudio_01_0467__en-us_topic_0157404961_row3170822394826"><th align="left" class="cellrowborder" valign="top" width="28.07%" id="mcps1.3.2.3.2.4.1.1"><p id="dataartsstudio_01_0467__en-us_topic_0157404961_p2984581994826">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15.659999999999998%" id="mcps1.3.2.3.2.4.1.2"><p id="dataartsstudio_01_0467__en-us_topic_0157404961_p159227094826">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="56.269999999999996%" id="mcps1.3.2.3.2.4.1.3"><p id="dataartsstudio_01_0467__en-us_topic_0157404961_p6186505494826">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dataartsstudio_01_0467__en-us_topic_0157404961_row1991457694826"><td class="cellrowborder" valign="top" width="28.07%" headers="mcps1.3.2.3.2.4.1.1 "><p id="dataartsstudio_01_0467__en-us_topic_0157404961_p246794194826">Node Name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.659999999999998%" headers="mcps1.3.2.3.2.4.1.2 "><p id="dataartsstudio_01_0467__en-us_topic_0157404961_p6568554794826">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.269999999999996%" headers="mcps1.3.2.3.2.4.1.3 "><p id="dataartsstudio_01_0467__en-us_topic_0157404961_p1892909794826">Name of a <span id="dataartsstudio_01_0467__en-us_topic_0099822521_text44323307153939">node</span>. The name must contain 1 to 128 characters, including only letters, numbers, underscores (_), hyphens (-), slashes (/), less-than signs (<), and greater-than signs (>).</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_0467__en-us_topic_0157404961_row824216571514"><td class="cellrowborder" valign="top" width="28.07%" headers="mcps1.3.2.3.2.4.1.1 "><p id="dataartsstudio_01_0467__en-us_topic_0157404961_p1143912012225">Subjob Name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.659999999999998%" headers="mcps1.3.2.3.2.4.1.2 "><p id="dataartsstudio_01_0467__en-us_topic_0157404961_p9438150152210">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.269999999999996%" headers="mcps1.3.2.3.2.4.1.3 "><p id="dataartsstudio_01_0467__en-us_topic_0157404961_p9437901223">Select the name of the subjob to be called.</p>
|
|
<div class="note" id="dataartsstudio_01_0467__en-us_topic_0157404961_note1524524523816"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dataartsstudio_01_0467__en-us_topic_0157404961_p1024511457386">You can only select the name of an existing batch job that does not contain the Subjob node.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_0467__en-us_topic_0157404961_row19710715192314"><td class="cellrowborder" valign="top" width="28.07%" headers="mcps1.3.2.3.2.4.1.1 "><p id="dataartsstudio_01_0467__en-us_topic_0157404961_p67111615142312">Subjob Parameter</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.659999999999998%" headers="mcps1.3.2.3.2.4.1.2 "><p id="dataartsstudio_01_0467__en-us_topic_0157404961_p471171592313">Yes/No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.269999999999996%" headers="mcps1.3.2.3.2.4.1.3 "><ul id="dataartsstudio_01_0467__en-us_topic_0157404961_ul1619814105495"><li id="dataartsstudio_01_0467__en-us_topic_0157404961_li18952912184912">If the subjob parameters are left unspecified, the subjob is executed with its own parameter variables. The <span class="parmname" id="dataartsstudio_01_0467__en-us_topic_0157404961_parmname2952112184912"><b>Subjob Parameter Name</b></span> of the parent job is not displayed.</li><li id="dataartsstudio_01_0467__en-us_topic_0157404961_li1719871017490">If the subjob parameters are specified, the subjob is executed with the configured parameter values. In this case, the <span class="parmname" id="dataartsstudio_01_0467__en-us_topic_0157404961_parmname116266305416"><b>Subjob Parameter Name</b></span> of the parent job is displayed, and the data or EL expression configured for the subjob is accessed and replaced according to the environment variable of the parent job.</li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="dataartsstudio_01_0467__en-us_topic_0157404961_table58040457102411"></a><a name="en-us_topic_0157404961_table58040457102411"></a><table cellpadding="4" cellspacing="0" summary="" id="dataartsstudio_01_0467__en-us_topic_0157404961_table58040457102411" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Advanced parameters</caption><thead align="left"><tr id="dataartsstudio_01_0467__en-us_topic_0099822521_row27216578102411"><th align="left" class="cellrowborder" valign="top" width="28.07%" id="mcps1.3.2.4.2.4.1.1"><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p57059205102411">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15.659999999999998%" id="mcps1.3.2.4.2.4.1.2"><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p58392901102411">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="56.269999999999996%" id="mcps1.3.2.4.2.4.1.3"><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p32204521102411">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dataartsstudio_01_0467__en-us_topic_0099822521_row51612113175"><td class="cellrowborder" valign="top" width="28.07%" headers="mcps1.3.2.4.2.4.1.1 "><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p416115112178">Node Status Polling Interval (s)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.659999999999998%" headers="mcps1.3.2.4.2.4.1.2 "><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p101615110176">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.269999999999996%" headers="mcps1.3.2.4.2.4.1.3 "><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p4161191101716">How often the system check completeness of the <span id="dataartsstudio_01_0467__en-us_topic_0099822521_text1526241235118">node</span>. The value ranges from 1 to 60 seconds.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_0467__en-us_topic_0099822521_row5101045193916"><td class="cellrowborder" valign="top" width="28.07%" headers="mcps1.3.2.4.2.4.1.1 "><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p147314419397">Max. Node Execution Duration</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.659999999999998%" headers="mcps1.3.2.4.2.4.1.2 "><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p610124511390">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.269999999999996%" headers="mcps1.3.2.4.2.4.1.3 "><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p11011456393">Execution timeout interval for the <span id="dataartsstudio_01_0467__en-us_topic_0099822521_text6930195917115">node</span>. If retry is configured and the execution is not complete within the timeout interval, the <span id="dataartsstudio_01_0467__en-us_topic_0099822521_text2930205914118">node</span> will be executed again.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_0467__en-us_topic_0099822521_row58429402102411"><td class="cellrowborder" valign="top" width="28.07%" headers="mcps1.3.2.4.2.4.1.1 "><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p5533912102858">Retry upon Failure</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.659999999999998%" headers="mcps1.3.2.4.2.4.1.2 "><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p45593742102858">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.269999999999996%" headers="mcps1.3.2.4.2.4.1.3 "><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p2105628102858">Whether to re-execute a <span id="dataartsstudio_01_0467__en-us_topic_0099822521_text29185571161243">node</span> if it fails to be executed. Possible values:</p>
|
|
<ul id="dataartsstudio_01_0467__en-us_topic_0099822521_ul18950660102858"><li id="dataartsstudio_01_0467__en-us_topic_0099822521_li36338219102858"><strong id="dataartsstudio_01_0467__en-us_topic_0099822521_b67992121590">Yes</strong>: The <span id="dataartsstudio_01_0467__en-us_topic_0099822521_text19139245161248">node</span> will be re-executed, and the following parameters must be configured:<ul id="dataartsstudio_01_0467__en-us_topic_0099822521_ul58608523102858"><li id="dataartsstudio_01_0467__en-us_topic_0099822521_li17370115484319"><strong id="dataartsstudio_01_0467__en-us_topic_0099822521_b18610151101714">Retry upon Timeout</strong></li><li id="dataartsstudio_01_0467__en-us_topic_0099822521_li44375787102858"><strong id="dataartsstudio_01_0467__en-us_topic_0099822521_b18404183512913">Maximum Retries</strong></li><li id="dataartsstudio_01_0467__en-us_topic_0099822521_li63837764102858"><strong id="dataartsstudio_01_0467__en-us_topic_0099822521_b1484216373917">Retry Interval (seconds)</strong></li></ul>
|
|
</li><li id="dataartsstudio_01_0467__en-us_topic_0099822521_li37668971102858"><strong id="dataartsstudio_01_0467__en-us_topic_0099822521_b0109154414913">No</strong>: The <span id="dataartsstudio_01_0467__en-us_topic_0099822521_text1328324161254">node</span> will not be re-executed. This is the default setting.<div class="note" id="dataartsstudio_01_0467__en-us_topic_0099822521_note845010501289"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p194511050132816">If retry is configured for a job node and the timeout duration is configured, the system allows you to retry a node when the node execution times out.</p>
|
|
<p id="dataartsstudio_01_0467__en-us_topic_0099822521_p1313284812516">If a node is not re-executed when it fails upon timeout, you can go to the <strong id="dataartsstudio_01_0467__en-us_topic_0099822521_b4476194112483">Default Configuration</strong> page to modify this policy.</p>
|
|
<p id="dataartsstudio_01_0467__en-us_topic_0099822521_p15946155074317"><strong id="dataartsstudio_01_0467__en-us_topic_0099822521_b128994567172">Retry upon Timeout</strong> is displayed only when <strong id="dataartsstudio_01_0467__en-us_topic_0099822521_b7899656131716">Retry upon Failure</strong> is set to <strong id="dataartsstudio_01_0467__en-us_topic_0099822521_b1899155620179">Yes</strong>.</p>
|
|
</div></div>
|
|
</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_0467__en-us_topic_0099822521_row29541959102411"><td class="cellrowborder" valign="top" width="28.07%" headers="mcps1.3.2.4.2.4.1.1 "><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p13154928102858">Policy for Handling Subsequent Nodes If the Current Node Fails</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.659999999999998%" headers="mcps1.3.2.4.2.4.1.2 "><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p58916261102858">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.269999999999996%" headers="mcps1.3.2.4.2.4.1.3 "><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p7487822102858">Operation that will be performed if the <span id="dataartsstudio_01_0467__en-us_topic_0099822521_text5371194616130">node</span> fails to be executed. Possible values:</p>
|
|
<ul id="dataartsstudio_01_0467__en-us_topic_0099822521_ul281538102858"><li id="dataartsstudio_01_0467__en-us_topic_0099822521_li867222192212"><strong id="dataartsstudio_01_0467__en-us_topic_0099822521_b63511334183">Suspend execution plans of the subsequent nodes</strong>: stops running subsequent nodes. The job instance status is <strong id="dataartsstudio_01_0467__en-us_topic_0099822521_b635117371819">Failed</strong>.</li><li id="dataartsstudio_01_0467__en-us_topic_0099822521_li2533844102858"><strong id="dataartsstudio_01_0467__en-us_topic_0099822521_b31833716587">End the current job execution plan</strong>: stops running the current job. The job instance status is <strong id="dataartsstudio_01_0467__en-us_topic_0099822521_b1521193765820">Failed</strong>.</li><li id="dataartsstudio_01_0467__en-us_topic_0099822521_li22804597102858"><strong id="dataartsstudio_01_0467__en-us_topic_0099822521_b72771223151916">Go to the next node</strong>: ignores the execution failure of the current node. The job instance status is <strong id="dataartsstudio_01_0467__en-us_topic_0099822521_b1727710236199">Failure ignored</strong>.</li><li id="dataartsstudio_01_0467__en-us_topic_0099822521_li1657745411173"><strong id="dataartsstudio_01_0467__en-us_topic_0099822521_b99581526191817">Suspend the current job execution plan</strong>: If the current job instance is in abnormal state, the subsequent nodes of this node and the subsequent job instances that depend on the current job are in waiting state.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_0467__en-us_topic_0099822521_row230711409176"><td class="cellrowborder" valign="top" width="28.07%" headers="mcps1.3.2.4.2.4.1.1 "><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p143081740131711">Enable Dry Run</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.659999999999998%" headers="mcps1.3.2.4.2.4.1.2 "><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p030844011714">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.269999999999996%" headers="mcps1.3.2.4.2.4.1.3 "><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p19929151141017">If you select this option, the node will not be executed, and a success message will be returned.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_0467__en-us_topic_0099822521_row116622012182617"><td class="cellrowborder" valign="top" width="28.07%" headers="mcps1.3.2.4.2.4.1.1 "><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p1336551322619">Task Groups</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.659999999999998%" headers="mcps1.3.2.4.2.4.1.2 "><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p7365181320261">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.269999999999996%" headers="mcps1.3.2.4.2.4.1.3 "><p id="dataartsstudio_01_0467__en-us_topic_0099822521_p236512139269">Select a task group. If you select a task group, you can control the maximum number of concurrent nodes in the task group in a fine-grained manner in scenarios where a job contains multiple nodes, a data patching task is ongoing, or a job is rerunning.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="dataartsstudio_01_0441.html">Node Reference</a></div>
|
|
</div>
|
|
</div>
|
|
|