Switches [ HP ALLBASE/4GL Developer Reference Manual Vol. 1 ] MPE/iX 5.0 Documentation
HP ALLBASE/4GL Developer Reference Manual Vol. 1
Switches
HP ALLBASE/4GL provides you with two different types of switches,
referred to as user switches and fixed function switches. Both types of
switches can be in an on or off condition. You can test the condition of
any switch with the IF and IFLOOP logic commands or in decision tables.
User Switches
HP ALLBASE/4GL has eight developer-controlled software switches. You can
set any of these switches to on or off with the ON and OFF logic
commands.
User switches are referenced as 1 to 8 in the logic ON, OFF, IF and
IFLOOP commands.
Fixed Function Switches
HP ALLBASE/4GL has a number of fixed function switches that you can use
to check the status or condition of some HP ALLBASE/4GL components. The
status or condition of each switch may be controlled by HP ALLBASE/4GL.
You can use the logic ON command to change the status of the *BYPASS,
*ENDFIELD, and *ENDLINE switches. You can also use the logic OFF command
to reset the *BYPASS and *ENDLINE switches.
*BYPASS.
The report generator uses this switch to indicate that a file record is,
or is not selected for sorting. It also indicates that the current
report line is not to be printed if it is on. You can set this switch on
or off in functions associated with the report.
Refer to chapter 7 for details of the report processing logic.
*ENDFIELD.
The screen processing logic uses this switch to determine whether input
processing for a field should continue. You can set this switch on in a
function called from a function key or a prior function on an input
field.
Refer to chapter 6 for details of the screen processing logic.
*ENDLINE.
The report generator uses this switch to indicate that printing of lines
in the current report line group is, or is not to continue. When the
switch is on, it indicates the end of a report line group. The on
condition for this switch can also indicate that no more records are to
be read from a report link file and no more link print lines are to be
printed. You can set this switch on or off in functions associated with
the report.
Refer to chapter 7 for details of the report processing logic.
*ENTERED.
The screen processing logic uses this switch to indicate the status of a
data entry field on a data screen. The screen processing logic sets this
switch off before the contents (if any) of the screen buffer have been
displayed in the field, and before the user commits any data for the
field. The switch is set on when the user initiates a commit action for
the field and the data has been accepted without generating an error.
You cannot set this switch with the logic ON or OFF commands.
Refer to chapter 6 for details of the screen processing logic.
*MOREREC.
The HP ALLBASE/4GL data manager uses this switch when reading records
from variable length record serial data files. If HP ALLBASE/4GL reads
sufficient characters to fill the file record buffer without encountering
the end of the record, it sets *MOREREC on. On the next FILE *READ
command for the file, HP ALLBASE/4GL reads more characters from the same
file record until it encounters the end of the record, or the file buffer
is filled.
If HP ALLBASE/4GL encounters the end of the record before the buffer is
filled, or the number of characters in the record matches the length of
the buffer, *MOREREC is set off after the file read.
You cannot set this switch with the logic ON or OFF commands.
Refer to chapter 12 for more information about the FILE command.
*SHOWING.
The screen processing logic uses this switch to indicate if the contents
of screen fields are being displayed under the control of the logic SHOW
command. The switch is set on if a SHOW command is being executed. You
cannot set this switch with the logic ON or OFF commands.
Refer to chapter 6 for details of the screen processing logic.
MPE/iX 5.0 Documentation