JAL: misc formatting

2017-11-01T21:09:58Z

misc formatting

Alex: Automatically generated page update

2013-04-20T13:18:39Z

Automatically generated page update

New page

Use the $CHKSFLD function to determine whether a display attribute is applied to a screen item for a specified type of screen processing.
Syntax
$CHKSFLD(screen-name,item-name,display-attribute,

[process-type])

Where
<ul>
<li>Both the screen-name and item-name arguments are expected to be string expressions and can include quoted strings, %variables, field names, or functions. </li>
</li>
<li>display-attribute value can be one of the following:</li>
<table>
<tr class="head">
<th>Value</th>
<th>Meaning</th>
</tr>
<tr>
<td>'ASK'</td>
<td>Auto-skip</td>
</tr>
<tr>
<td>'BLI'</td>
<td>Blink</td>
</tr>
<tr>
<td>'BLU'</td>
<td>Blue color</td>
</tr>
<tr>
<td>'BRI'</td>
<td>Bright</td>
</tr>
<tr>
<td>'DEF'</td>
<td>Default color</td>
</tr>
<tr>
<td>'GRE'</td>
<td>Green color</td>
</tr>
<tr>
<td>'INV'</td>
<td>Invisible</td>
</tr>
<tr>
<td>'NUM'</td>
<td>Numeric field</td>
</tr>
<tr>
<td>'PIN'</td>
<td>Pink color</td>
</tr>
<tr>
<td>'PRO'</td>
<td>Protected</td>
</tr>
<tr>
<td>'RED'</td>
<td>Red color</td>
</tr>
<tr>
<td>'REV'</td>
<td>Reverse image</td>
</tr>
<tr>
<td>'TUR'</td>
<td>Turquoise color</td>
</tr>
<tr>
<td>'USC'</td>
<td>Underscore</td>
</tr>
<tr>
<td>'WHI'</td>
<td>White color</td>
</tr>
<tr>
<td>'YEL'</td>
<td>Yellow color</td>
</tr>
</table>
</li>
<li>process-type can be one of the following:</li>
</li>
</ul>
'PRINT'
'READ' (the default)
'REREAD'
'TAG'
Returns
<ul>
<li>1 if the attribute is ON for the type specified.</li>
</li>
<li>0 if the attribute is OFF for the type specified.</li>
</li>
</ul>
Usage
For example, if you want to check whether the POLNO (policy number) field in the screen MAIN is displayed in blue in reread processing, enter the following command:
BEGIN
SCREEN MAIN
INPUT POLNO AT 10 LEN 20 RED
END SCREEN
MODIFY %MAIN:POLNO TO BLUE FOR REREAD
PRINT $CHKSFLD('MAIN','POLNO','BLU','REREAD')
END

Produces the following output:
1

Nonfatal errors
If you do not specify colors within the <var class="product">Model 204</var> screen definition, the color displayed on your terminal is the default color display. For example, you might be looking at a pink display, but when you invoke the $CHKSFLD function, checking for 'PIN' does not return a '1' because pink was not assigned by the <var class="product">Model 204</var> screen definition. 
The following messages might be issued:
M204.2462: INVALID ATTRIBUTE SPECIFIED: attribute

M204.2462: INVALID ATTR.TYPE SPECIFIED: attr.TYPE

M204.0329: SCREEN OR IMAGE ITEM NAME NOT FOUND: name

M204.0324: SCREEN, MENU, OR IMAGE NAME NOT DEFINED: name

M204.0247: SCREEN, MENU, OR IMAGE NAME NOT SPECIFIED

[[Category:SOUL $functions]]

$CHKSFLD - Revision history

JAL: misc formatting

Alex: Automatically generated page update