$ChkMod: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
|||
| Line 1: | Line 1: | ||
<p>Use the $ | <p>Use the $ChkMod function after a READ SCREEN or REREAD SCREEN statement to determine whether the terminal operator entered data for any full-screen input fields or for a specific input field. See a discussion of the full-screen feature in [[Full-screen feature#Full-screen processing|Full-screen processing]]. </p> | ||
<b>Syntax</b> | <b>Syntax</b> | ||
<p>The format of the $ | <p>The format of the $ChkMod function is:</p> | ||
<p class="code">$ | <p class="code">$ChkMod (screenname <var>[</var>, inputname<var>]</var>) | ||
</p> | </p> | ||
| Line 8: | Line 8: | ||
<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:</p> | <p>If screenname and/or inputname are quoted strings, the name must be enclosed in single quotation marks:</p> | ||
<p class="code">$ | <p class="code">$chkmod ('EMPSCRN', 'NAME') | ||
</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, $ChkMod returns the number of input fields for which the terminal operator entered data. </li> | ||
<p>If inputname is specified, $ | <p>If inputname is specified, $ChkMod returns a value of 0 if the input field was not modified. $ChkMod returns a value of 1 if the field was modified. </p> | ||
</li> | </li> | ||
</ul> | </ul> | ||
[[Category:SOUL $functions]] | [[Category:SOUL $functions]] | ||
Revision as of 14:23, 14 July 2014
Use the $ChkMod function after a READ SCREEN or REREAD SCREEN statement to determine whether the terminal operator entered data for any full-screen input fields or for a specific input field. See a discussion of the full-screen feature in Full-screen processing.
Syntax
The format of the $ChkMod function is:
$ChkMod (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, $ChkMod returns the number of input fields for which the terminal operator entered data.
If screenname and/or inputname are quoted strings, the name must be enclosed in single quotation marks:
$chkmod ('EMPSCRN', 'NAME')
If inputname is specified, $ChkMod returns a value of 0 if the input field was not modified. $ChkMod returns a value of 1 if the field was modified.