HP RPG/iX Utilities Reference Manual (30318-90006)

2-259
start line number and the number of lines to clear is eight, lines three through ten are cleared. The
number of lines to clear plus the start line number must not exceed 24. If a value is not given, 24 lines (the
default) are cleared.
NOTE Thenumber of lines to clear and the startline number can be used to overlayone form
with another. Use caution when overlaying a form with output fields with forms with
input fields. All fields must be aligned or unpredictable results occur (see chapter 4 for
more details). Clear all lines if you do not want to overlay forms.
Uppercase Only
Legal values for this field are Y and N.
If you specify Y (yes) in the Uppercase only specification, alphabetic characters entered by a user are
returned to the screen and to your program in uppercase. If you specify N (no), lowercase data entered by
the user are not returned to your program upshifted.
Sound Alarm
Legal values or this field are Y, N, and 01-99.
If you specify Y (yes) in the Sound alarm specification, an audible alarm sounds when the form is
displayed. If you specify N (no), no alarm sounds. If you specify an indicator 01 through 99 and turn it on
in your program, the alarm sounds when the form is displayed.
Override Fields
Legal values for this field are Y, N, and 01-99.
An Override fields operation allows you to override (alter) fields in a form when the form is redisplayed.
Only those fields modified as a result of an override operation are redisplayed. You can use an override
operation if the user enters invalid data into a field and you want to flag the field in error.
During an override operation, if an indicator 01 through 99 is specified and turned on, then:
• If a field has an indicator in the output data entry (see "Field Attributes") and the indicator is off, the
data entered in that field is unchanged. Any field with a Y or N in the output data entry is also un-
changed.
• If a fieldhas an indicator in the output data entry and the indicator is on,the field is displayed with data
from the program.If the field is also input capable, data that was entered into the field by the user is lost.
• Form and field attributes that are controlled with indicators will be changed according to the current
state of those indicators.
If you specify Y (yes) in the Override fields specification, the override operation is performed each time the
form is displayed.
NOTE Using Y is not recommended because only those fields with indicators on will be dis-
played when the form is initially displayed. Screen resident constants are not indica-
tor controlled, thus they will never be displayed.
If you specify N (no), no override operation is performed on that form.
Exception Output
Legal values for this field are Y and N.
Exception output is used to force the immediate display of a form. If Y (yes) is specified, the form is output
at exception time. If N (no) is specified, the form is output prior to the next read from the WORKSTN file.