HP 3000 Manuals

HP ALLBASE/4GL Developer Reference Manual Vol. 1

Module Builder Screen 

This screen allows you to specify the details to create a resultant
screen and associated logic blocks with the module builder, providing you
with a module to inquire upon or maintain an HP ALLBASE/4GL file.

Screen Image 


            

Field Descriptions 

Module Name.    Enter the name of the module (up to eight characters).

The module builder uses the module name, with an mb_ prefix, to form the
name of many items within the module.  For example, the resultant screen
is called mb_name, where name is the module name you enter.


CAUTION  If you use a module name that already exists, HP ALLBASE/4GL
         assumes that you want to replace the existing module, and
         displays a message asking you to confirm this.  If you want to
         keep the module items that currently exist under this name, you
         must use a different module name.  If you continue, all existing
         module items, such as functions, processes, and SQL logic
         blocks, are overwritten.


Type   Enter I or M to specify the type of module.  The default is M.

   *   Enter I to allow inquiry access.  The user is only able to
       retrieve data.

   *   Enter M to allow maintenance access.  The user is able to
       retrieve, add, delete, or modify data in the file.

Main Access:  File.    Enter the HP ALLBASE/4GL name of the main file for
the module.  If the file is an HP ALLBASE/SQL table, HP TurboIMAGE/iX
data set, or KSAM data file, the file must contain a key field.  If the
file does not contain a key field, the error message "Invalid index." is
displayed.

Main Access:  Record.    Enter the name of a record layout for the main
access file.  The module builder uses this record layout as a source for
fields that will appear on the resultant screen.  The entry in this field
defaults to the default record layout for the file.  This field is
bypassed for HP ALLBASE/SQL files.

Main Access:  Index.    Enter the index number or name of the field in
the record layout to be used for keyed access.  The following values are
allowed, depending on the file type:

   *   HP ALLBASE/SQL. Enter the name of any field in the record layout
       or the number of any key field on the record layout.  If the field
       is not a key field in the record layout, the module builder
       assumes that duplicate values are allowed.  This entry defaults to
       the primary key field for the record, or the first field if no
       keys exist.  If you specify an index field that is not a key field
       in the record layout, the file scanning and record retrieval
       performance of the module will be slow.

   *   KSAM or HP TurboIMAGE/iX. Enter the name or number of any field
       that is defined as a key field in the record layout.  If the field
       is not a key field in the record layout, an error message is
       displayed.  This entry defaults to the primary key field for the
       record.

   *   SERIAL. This field is bypassed.

Include All Fields.    Enter Y or N. If you enter Y, all fields from the
record layout are placed on the resultant screen.  Each field will be
given a default label, and a primary data movement specifier relating to
its corresponding field in the main file.  You can then use the module
details screen to modify or delete these screen fields.  If you enter N,
only the first field is automatically placed on the screen.  You must
then use the module details screen to specify each subsequent field that
you want to include on the resultant screen.  The default is Y.

Function Keys 

f1       Dict.  Menu  Exits the current screen and displays the
        dictionary menu.

f2       Screens Menu  Exits the current screen and displays the screens
        menu.

f3       Logic Menu  Exits the current screen and displays the logic
        menu.

f4       Reports Menu  Exits the current screen and displays the reports
        menu.

f8       Previous Menu  Returns you to the last menu displayed by the
        system.  Once you have committed a field you will be asked to
        confirm your request to exit from the module builder.  If you do
        exit before generating the module, all details entered so far
        will be lost.

After you press the  Commit Data  function key, the first four function
keys are replaced with the following two:

f1       Specify Details  Exits the current screen and takes you to the
        module details screen.

f4       Generate Module  Accepts the module definition as entered so far
        and creates and generates all the HP ALLBASE/4GL items necessary.

Additional Information 

When you press the  Commit Data  function key, the details you have
entered are saved and two new function keys are displayed.

Press the  Generate Module  function key to create and generate all the
items necessary for the module as defined so far.  Only use this
function key if you have entered Y in the Include All Fields field.
Alternatively, press the  Specify Details  function key to display the
module details screen.  This screen allows you to specify the field
details for the resultant screen on a field-by-field basis.

MPE/iX 5.0 Documentation