$ChkTag: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
|||
| Line 1: | Line 1: | ||
<p>Use the $ | <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> | ||
<b>Syntax</b> | <b>Syntax</b> | ||
<p>The format of the $ | <p>The format of the $ChkTag function is:</p> | ||
<p class="code">$ | <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">$ | <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, $ | <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 $ | <p class="code">IF $chktag('ACCTG') GT 0 | ||
THEN REREAD SCREEN ACCTG | THEN REREAD SCREEN ACCTG | ||
</p> | </p> | ||
[[Category:SOUL $functions]] | [[Category:SOUL $functions]] | ||
Revision as of 19:44, 14 July 2014
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 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.
If screenname and/or inputname are quoted strings, the name must be enclosed in single quotation marks, as shown below:
$ChkTag (%SCRNAME, 'ACCNTNO')
Example
IF $chktag('ACCTG') GT 0 THEN REREAD SCREEN ACCTG