$ChkMod: Difference between revisions
Jump to navigation
Jump to search
(Automatically generated page update) |
mNo edit summary |
||
| Line 1: | Line 1: | ||
<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- | <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 $CHKMOD function is:</p> | <p>The format of the $CHKMOD function is:</p> | ||
<p class="code">$CHKMOD (screenname <var>[</var>, inputname<var>]</var>) | <p class="code">$CHKMOD (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> | ||
| Line 9: | Line 10: | ||
<p class="code">$CHKMOD ('EMPSCRN', 'NAME') | <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, $CHKMOD returns the number of input fields for which the terminal operator entered data. </li> | <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, $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> | <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 20:02, 2 January 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.