HP 3000 Manuals

HP ALLBASE/4GL Developer Reference Manual Vol. 1

Module Details Screen 

The module details screen allows you to specify further details for each
field on the resultant screen.  This screen also allows you to add
additional fields to the screen, or delete fields, and to link screen
fields with secondary files.

Screen Image 

Screen Image 


            

Field Descriptions 

The first group of fields on this screen are display only fields that
show the information you specified in the module builder screen.

Sequence Number.    Enter the sequence number of the field you want to
add, change, insert, or delete.  The sequence number indicates position
of the field in the tab sequence on the resultant screen.  HP ALLBASE/4GL
automatically increments this value each time the cursor enters the
field.  You can then overtype this value as required.

Action.    Enter the code of the action to be performed on the specified
field.

Choose from one of the following:

  Code   Action 

   A     Add a new field.

   C     Change current field details.

   D     Delete current field from screen.

   I     Insert a field before this field.

   L     List screen field details.

File.    Enter the name of the file included in the primary data movement
field name.  The entry in this field first defaults to the name of the
main file.  If all the fields from the main record layout have been
placed, it defaults to the most recently specified secondary file.

Field Spec.  Name.    Enter the name of a dictionary field specification.
The module builder uses this name to complete the definition of the
primary data movement field for the screen field.  You can only specify
the primary data movement path for a screen field with the module
builder.

When the cursor enters the Field Spec.  Name or ( ) fields, two function
keys are displayed:    Previous Field  and  Next Field .  These function
keys allow you to scan all the fields in the record layout for the file
specified.

( ).    Enter the occurrence number of the field.  If the dictionary
field specification has not defined multiple occurrences, this field is
bypassed.

On Screen Label.    Enter the label text to be placed on the screen next
to or before the data field.  This defaults to the text in the short
description field from the field specifications screen.  If the field is
one of a series of multiple occurring fields, only the first occurrence
defaults to this value.  The others default to blank.

Type.    Enter I to make the field an input field or D to make the field
display only.  HP ALLBASE/4GL sets and bypasses this field in the
following circumstances:

   *   The first field on the screen is always an input field.

   *   All other screen fields in inquiry modules are display-only
       fields.

   *   All screen fields retrieved from secondary files are display-only
       fields.

The remaining fields on the module details screen are bypassed if the
Type field contains D.

Required.    Enter Y if the user must enter data into the screen field
being specified.  The default is N. HP ALLBASE/4GL sets and bypasses this
field in the following circumstances:

   *   The first field on the screen is always a required field.

   *   Any display-only field is a non-required field.

Link.    Enter Y if you wish to link the screen field to a secondary
file.  If you enter N, all following fields on the module details screen
are bypassed.  You cannot link secondary file screen fields with other
secondary files, and you can only link twenty main file screen fields
with secondary files.  You cannot link a main file screen field that has
multiple occurrences with a HP ALLBASE/SQL table.

If the link succeeds in retrieving a record in the secondary file, fields
in the record retrieved from the secondary file can be displayed on the
resultant screen.  If you want to do this, the resultant screen fields
used to display data from the retrieved record must have higher sequence
numbers (that is, occur later in the resultant screen) than the field
used to make the link.

The retrieval specified by the link is executed as an after function when
the user commits the field.  When a record from the main file is
retrieved using keyed access or file scanning, the secondary file
retrieval results from execution of a SHOW command.

Validate.    Enter Y if a record must be retrieved from the secondary
file before the user can commit the link field with data entered.
Setting Validate to Y means the link field is validated by data in the
index field of the secondary file in the same way a validation range or
validation table operates.

If the record does not exist and this field is set to Y, then an error
type message is displayed.  If this field is set to N, then a warning
type message is displayed.  The default is N.

Link To:  File.    Enter the name of the secondary file with which the
screen field is linked.  This must not be a serial file.

Link To:  Record.    Enter the name of the record layout to be used to
access the secondary file.  The entry in this field defaults to the
default record layout for the file.  This field is bypassed for HP
ALLBASE/SQL files.

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

   *   HP ALLBASE/SQL. Enter the name of any field on the record layout
       or the number of any key field on the record layout.  This entry
       defaults to the primary key field for the record or the first
       field if no keys exist.

   *   KSAM or HP TurboIMAGE/iX. Enter the name or number of any field
       which is defined as a key field on 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. A serial file cannot be a secondary file.

Function Keys 

f1       List Record  Displays a list of the fields in the current file's
        record layout.  One column of the list shows whether the field is
        already included on the current screen.

f2       Previous Field  This function key is only displayed if the
        cursor is in the Field Spec.  Name field or the ( ) field.
        Pressing the key displays the details for the previous field in
        the record layout.

f3       Next Field  This function key is only displayed if the cursor is
        in the Field Spec.  Name field or the ( ) field.  Pressing the
        key displays the details for the next field in the record layout.

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

f8       Previous Menu  Returns you to the last menu displayed by the
        system.  You will be asked to confirm your request to exit.  If
        you exit before generating the module, all details entered so far
        will be lost.

MPE/iX 5.0 Documentation