HP Business BASIC/XL Reference Manual - HP 3000 MPE/iX Computer Systems - Edition 1 (32715-90001)

4-: 95
If there is no form currently active and a form file is specified in
form_file_name , the file type of the form file is examined to determine
whether the file to be activated is an VPLUS form file or a JOINFORM
File. If there is no form file specified as part of the form name, the
most recently opened form file is used. An error occurs if no form file
has been opened and the form_file_name is omitted.
Any function key that is defined using HP Business BASIC/XL's ON KEY
statement takes precedence over the definition of the key defined by the
VPLUS form. Therefore, you can define user-defined branch-during-input
keys and the associated key labels that are to be active during the form
processing prior to opening the form.
Syntax
[{;} ]
[{,} HOME]
OPEN FORM form_name [OVERLAY ]
[FREEZE ]
[APPEND ]
If the comma is used as the separator above, HP Business BASIC/XL will
accept it, but will replace it with a semicolon.
Parameters
form_name The form_name is a string expression with the following
format:
form_member_name [: form_file_name ]
The form_member_name is the name of the form that you are
opening. The form_file_name is the name of the file that
contains the form.
HOME The HOME, OVERLAY, FREEZE, and APPEND options are ignored if
OVERLAY the form to be opened is a JOINFORM.
FREEZE
APPEND Only one of these options can be used in an OPEN statement.
When the HOME keyword is specified, any existing form is
cleared and the form being opened is placed at the top of
display memory. When the APPEND keyword is specified, the
form being opened is positioned following the currently
active form; if none is active, HOME is substituted. OVERLAY
is the keyword to use when you wish to replace the currently
active form without otherwise disturbing display memory. The
FREEZE keyword causes memory locking of any currently active
form followed by an APPEND. If none of these options is
specified, HOME is the default.
Examples
The following examples show the OPEN FORM statement.
100 OPEN FORM "FORM1:ABC" !Opens FORM1 in ABC
110 OPEN FORM A$;OVERLAY !Opens the form in A$
120 OPEN FORM Form$+":FORMFILE" !Opens the form in Form$
130 OPEN FORM "XYZ";FREEZE !Opens form XYZ
140 OPEN FORM "XYZ";HOME !Opens form XYZ
OPTION
The OPTION and GLOBAL OPTION statements can change the program unit
characteristics shown in Table 4-10. The value of each program unit
characteristic is initially set to the value in the HP Business BASIC/XL
configuration file, HPBBCNFG.PUB.SYS supplied with HP Business BASIC/XL.
The current values of each characteristic are displayed by the INFO
command.