From d68eb8a71ac5cd9cac2ef3cc0cd96e8a2e3c734d Mon Sep 17 00:00:00 2001
From: Jim DeFabia <jamesdefabia@lexisnexis.com>
Date: Thu, 21 Sep 2023 13:11:20 -0400
Subject: [PATCH] HPCC-18650 Document LABEL attribute on INDEPENDENT, PERSIST,
 FAILURE, & SUCCESS

Signed-off-by: Jim DeFabia <jamesdefabia@lexisnexis.com>
---
 .../ECLR_mods/WkFlo-FAILURE.xml               | 20 +++++++++++--
 .../ECLR_mods/WkFlo-INDEPENDENT.xml           | 28 +++++++++++++++----
 .../ECLR_mods/WkFlo-PERSIST.xml               | 20 +++++++++++--
 .../ECLR_mods/WkFlo-SUCCESS.xml               | 20 +++++++++++--
 4 files changed, 76 insertions(+), 12 deletions(-)

diff --git a/docs/EN_US/ECLLanguageReference/ECLR_mods/WkFlo-FAILURE.xml b/docs/EN_US/ECLLanguageReference/ECLR_mods/WkFlo-FAILURE.xml
index 3d4b0ebb335..842719df639 100644
--- a/docs/EN_US/ECLLanguageReference/ECLR_mods/WkFlo-FAILURE.xml
+++ b/docs/EN_US/ECLLanguageReference/ECLR_mods/WkFlo-FAILURE.xml
@@ -8,9 +8,10 @@
   </emphasis><emphasis role="bold">: FAILURE<indexterm>
       <primary>FAILURE</primary>
     </indexterm>(</emphasis><emphasis>handler</emphasis><emphasis
-  role="bold">) <indexterm>
+  role="bold">) [,LABEL(</emphasis><emphasis>text</emphasis><emphasis
+  role="bold">)]</emphasis><indexterm>
       <primary>FAILURE workflow service</primary>
-    </indexterm></emphasis>;</para>
+    </indexterm>;</para>
 
   <para><informaltable colsep="1" frame="all" rowsep="1">
       <tgroup cols="2">
@@ -36,6 +37,21 @@
 
             <entry>The action to run if the expression fails.</entry>
           </row>
+
+          <row>
+            <entry><emphasis role="bold">LABEL</emphasis></entry>
+
+            <entry>Optional. Defines the <emphasis>Text</emphasis> to display
+            for the workflow item in the Graph for the workunit. If omitted,
+            the code generator will deduce a label from the identifier being
+            defined.</entry>
+          </row>
+
+          <row>
+            <entry><emphasis>text</emphasis></entry>
+
+            <entry>A string constant containing the text to display.</entry>
+          </row>
         </tbody>
       </tgroup>
     </informaltable></para>
diff --git a/docs/EN_US/ECLLanguageReference/ECLR_mods/WkFlo-INDEPENDENT.xml b/docs/EN_US/ECLLanguageReference/ECLR_mods/WkFlo-INDEPENDENT.xml
index 81766013906..a226c545680 100644
--- a/docs/EN_US/ECLLanguageReference/ECLR_mods/WkFlo-INDEPENDENT.xml
+++ b/docs/EN_US/ECLLanguageReference/ECLR_mods/WkFlo-INDEPENDENT.xml
@@ -6,12 +6,13 @@
 
   <para><emphasis>attribute </emphasis>:= <emphasis>expression
   </emphasis><emphasis role="bold">: INDEPENDENT
-  [</emphasis><emphasis>(cluster)</emphasis><emphasis role="bold">]</emphasis>
-  <indexterm>
-      <primary>INDEPENDENT</primary>
-    </indexterm><indexterm>
+  [</emphasis><emphasis>(cluster </emphasis><emphasis
+  role="bold">[,LABEL(</emphasis><emphasis>text</emphasis><emphasis
+  role="bold">)]</emphasis>)<emphasis role="bold">]</emphasis>; <indexterm>
       <primary>INDEPENDENT workflow service</primary>
-    </indexterm>;</para>
+    </indexterm><indexterm>
+      <primary>INDEPENDENT</primary>
+    </indexterm></para>
 
   <para><informaltable colsep="1" frame="all" rowsep="1">
       <tgroup cols="2">
@@ -40,6 +41,21 @@
             <emphasis>attribute</emphasis> is run on the currently executing
             cluster.</entry>
           </row>
+
+          <row>
+            <entry><emphasis role="bold">LABEL</emphasis></entry>
+
+            <entry>Optional. Defines the <emphasis>Text</emphasis> to display
+            for the workflow item in the Graph for the workunit. If omitted,
+            the code generator will deduce a label from the identifier being
+            defined.</entry>
+          </row>
+
+          <row>
+            <entry><emphasis>text</emphasis></entry>
+
+            <entry>A string constant containing the text to display.</entry>
+          </row>
         </tbody>
       </tgroup>
     </informaltable></para>
@@ -59,7 +75,7 @@
 
   <para>Example:</para>
 
-  <programlisting lang="ECL" role="runnable">I := RANDOM() : INDEPENDENT;  //calculated once, period
+  <programlisting lang="ECL" role="runnable">I := RANDOM() : INDEPENDENT(LABEL('CalcRandom'));  //calculated once, period
 G := RANDOM() : GLOBAL;       //calculated once in each graph
 
 ds := 
diff --git a/docs/EN_US/ECLLanguageReference/ECLR_mods/WkFlo-PERSIST.xml b/docs/EN_US/ECLLanguageReference/ECLR_mods/WkFlo-PERSIST.xml
index cbc1dd33cfc..93b355e7be4 100644
--- a/docs/EN_US/ECLLanguageReference/ECLR_mods/WkFlo-PERSIST.xml
+++ b/docs/EN_US/ECLLanguageReference/ECLR_mods/WkFlo-PERSIST.xml
@@ -23,9 +23,10 @@
     </indexterm> | MULTIPLE<indexterm>
       <primary>MULTIPLE</primary>
     </indexterm>[(</emphasis><emphasis>count</emphasis><emphasis
-  role="bold">)]] ) <indexterm>
+  role="bold">)]] [,LABEL(</emphasis><emphasis>text</emphasis><emphasis
+  role="bold">)])</emphasis>; <indexterm>
       <primary>PERSIST workflow service</primary>
-    </indexterm></emphasis>;</para>
+    </indexterm></para>
 
   <para><informaltable colsep="1" frame="all" rowsep="1">
       <tgroup cols="2">
@@ -155,6 +156,21 @@
             omitted, the system default is used. If set to -1, then an
             unlimited number are kept.</entry>
           </row>
+
+          <row>
+            <entry><emphasis role="bold">LABEL</emphasis></entry>
+
+            <entry>Optional. Defines the <emphasis>Text</emphasis> to display
+            for the workflow item in the Graph for the workunit. If omitted,
+            the code generator will deduce a label from the identifier being
+            defined.</entry>
+          </row>
+
+          <row>
+            <entry><emphasis>text</emphasis></entry>
+
+            <entry>A string constant containing the text to display.</entry>
+          </row>
         </tbody>
       </tgroup>
     </informaltable></para>
diff --git a/docs/EN_US/ECLLanguageReference/ECLR_mods/WkFlo-SUCCESS.xml b/docs/EN_US/ECLLanguageReference/ECLR_mods/WkFlo-SUCCESS.xml
index 2114bf74bb5..9a90211cbf3 100644
--- a/docs/EN_US/ECLLanguageReference/ECLR_mods/WkFlo-SUCCESS.xml
+++ b/docs/EN_US/ECLLanguageReference/ECLR_mods/WkFlo-SUCCESS.xml
@@ -8,9 +8,10 @@
   </emphasis><emphasis role="bold">: SUCCESS<indexterm>
       <primary>SUCCESS</primary>
     </indexterm>(</emphasis><emphasis>handler</emphasis><emphasis
-  role="bold">) </emphasis><indexterm>
+  role="bold">) [,LABEL(</emphasis><emphasis>text</emphasis><emphasis
+  role="bold">)]</emphasis>; <indexterm>
       <primary>SUCCESS workflow service</primary>
-    </indexterm>;</para>
+    </indexterm></para>
 
   <para><informaltable colsep="1" frame="all" rowsep="1">
       <tgroup cols="2">
@@ -36,6 +37,21 @@
 
             <entry>The action to run if the expression succeeds.</entry>
           </row>
+
+          <row>
+            <entry><emphasis role="bold">LABEL</emphasis></entry>
+
+            <entry>Optional. Defines the <emphasis>Text</emphasis> to display
+            for the workflow item in the Graph for the workunit. If omitted,
+            the code generator will deduce a label from the identifier being
+            defined.</entry>
+          </row>
+
+          <row>
+            <entry><emphasis>text</emphasis></entry>
+
+            <entry>A string constant containing the text to display.</entry>
+          </row>
         </tbody>
       </tgroup>
     </informaltable></para>