$ChkTag: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (Mlarocca moved page $CHKTAG to $ChkTag: Lower case change)
No edit summary
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
<p>Use the $CHKTAG function to determine whether any full-screen input fields that resulted in error conditions were entered by the terminal operator. The full-screen input fields either did not pass the automatic validation tests specified for the fields, or contained errors detected by the request. </p>
<p>Use the $ChkTag function to determine whether any full-screen input fields that resulted in error conditions were entered by the terminal operator. The full-screen input fields either did not pass the [[Full-screen_feature#Automatic_validation_options_for_INPUT|automatic validation]] tests specified for the fields, or contained errors detected by the request. </p>
<b>Syntax</b>
<b>Syntax</b>
<p>The format of the $CHKTAG function is:</p>
<p>The format of the $ChkTag function is:</p>
<p class="code">$CHKTAG (screenname <var>[</var>, inputname<var>])</var>
<p class="code">$ChkTag (screenname <var>[</var>, inputname<var>])</var>
</p>
</p>
<ul>
<ul>
<li>Both the screenname and inputname arguments are expected to be string expressions and can include quoted strings, %variables, field names, or functions. </li>
<li>Both the screenname and inputname arguments are expected to be string expressions and can include quoted strings, %variables, field names, or functions. </li>
<p>If screenname and/or inputname are quoted strings, the name must be enclosed in single quotation marks, as shown below:</p>
<p>If screenname and/or inputname are quoted strings, the name must be enclosed in single quotation marks, as shown below:</p>
<p class="code">$CHKTAG (%SCRNAME, 'ACCNTNO')  
<p class="code">$chktag (%SCRNAME, 'ACCNTNO')  
</p></li>
</p></li>
<li>If inputname (representing an input field on the specified screen) is not included in the function call, $CHKTAG returns the number of input items with tags on. If inputname is included, $CHKTAG returns a value of 0 if the specified input item's tag is not on. $CHKTAG returns a value of 1 if the item's tag is on.</li>
<li>If inputname (representing an input field on the specified screen) is not included in the function call, $ChkTag returns the number of input items with tags on. If inputname is included, $ChkTag returns a value of 0 if the specified input item's tag is not on. $ChkTag returns a value of 1 if the item's tag is on.</li>
</li>
</li>
</ul>
</ul>
<b>Example</b>
<b>Example</b>
<p class="code">IF $CHKTAG('ACCTG') GT 0
<p class="code">IF $chktag('ACCTG') GT 0
   THEN REREAD SCREEN ACCTG   
   THEN REREAD SCREEN ACCTG   
</p>
</p>
[[Category:SOUL $functions]]
[[Category:SOUL $functions]]

Latest revision as of 15:51, 23 January 2018

Use the $ChkTag function to determine whether any full-screen input fields that resulted in error conditions were entered by the terminal operator. The full-screen input fields either did not pass the automatic validation tests specified for the fields, or contained errors detected by the request.

Syntax

The format of the $ChkTag function is:

$ChkTag (screenname [, inputname])

  • Both the screenname and inputname arguments are expected to be string expressions and can include quoted strings, %variables, field names, or functions.
  • If screenname and/or inputname are quoted strings, the name must be enclosed in single quotation marks, as shown below:

    $chktag (%SCRNAME, 'ACCNTNO')

  • If inputname (representing an input field on the specified screen) is not included in the function call, $ChkTag returns the number of input items with tags on. If inputname is included, $ChkTag returns a value of 0 if the specified input item's tag is not on. $ChkTag returns a value of 1 if the item's tag is on.

Example

IF $chktag('ACCTG') GT 0 THEN REREAD SCREEN ACCTG