HP 3000 Manuals

HP ALLBASE/4GL Developer Reference Manual Vol. 1

Screen Header Screen 

This screen allows you to name a screen and specify the attributes of the
screen.

Screen Image 


            

Field Descriptions 

Screen   Enter the name of the screen (up to 16 characters).

Secured   If you wish to protect this screen from unauthorized
modification, enter Y; otherwise enter N.

If you enter Y, this screen can only be modified by a developer who has
signed on to the application under the correct development security code.
The entry in this field defaults to N.

Screen Type   The entry in this field defines the type of the screen, as
follows:

 M   menu

 D   data screen

 W   window screen

Don't attempt to change the entry in this field after you have painted
the screen image with the screen painter.  If you do, you won't be able
to access the screen with the screen painter.

Automatic Numbering   This field is only active as an input field for
data screens and window screens.  For menus, this field defaults to Y.

If you enter Y, the screen painter assigns numbers to the screen fields
automatically.  The numbers start with the first field, numbering across
each line, then down the screen.

If you enter N, you must supply the field numbers yourself when you're
painting the screen.  The field numbers must start at number 1 and be
consecutive, but may be placed anywhere on the screen.

The screen painter assigns or checks the field numbers.

Clear Fields on Commit   This field is only active for data screens and
window screens.

The entry in this field determines which screen fields, if any, are
cleared automatically when the user presses the  Commit Data  function
key.

Regardless of the entry in this field, HP ALLBASE/4GL does not clear the
fields until after the next SCREEN logic command is executed.  This means
that data remains in the screen buffer after the user presses the  Commit 
Data  function key.

The entry in this field controls the automatic clearance of field types,
and works in conjunction with the Clear on COMMIT field on the screen
field details screen.  If the entry on this screen specifies that the
field type is cleared, or the entry on the field details screen specifies
that the specific field is cleared, HP ALLBASE/4GL will clear the field
when the user presses the  Commit Data  function key.

If you don't want to clear a field when the user presses the  Commit Data 
 function key, you must specify that the field type is not cleared on
this screen, and also specify that the specific field is not cleared on
the field details screen.

Enter one of the following codes in this field:

 I   Input fields only are cleared

 D   Display fields only are
     cleared

 B   Input and display fields are
     cleared

 N   No fields are cleared

Function Keys 

Enter the name of the primary set of function keys to be displayed with
this screen.  The function key set need not exist when you complete this
screen.

Screen Help Name   Enter the name of the first help screen to be
displayed by HP ALLBASE/4GL if the user requests general help information
about the current screen.

Scroll:  Top line   (Data screens only.)  If the screen is to contain a
scroll area, enter the line number (between 1 and 22) for the top line of
the scroll area.  This line is included in the scroll area.  Refer to
Additional Information.

Scroll:  Bottom line   (Data screens only.)  Enter the line number
(between 1 and 22) of the bottom line of the scroll area.  This line is
included in the scroll area.  Refer to Additional Information.

Direction   (Data screens only.)  If scrolling is used, this field
defines the scroll direction.  Enter U for upwards or D for downwards
scrolling.

Content   (Data screens only.)  Optional.  These two fields may contain a
list of data items to be scrolled.  The format of this list is the same
as that required for the SCROLL and DISPLAY logic commands.  (Refer to
chapter 12 for details of the SCROLL and DISPLAY logic commands.)  You
don't need to use the command name SCROLL in this area.

HP ALLBASE/4GL scrolls the items listed in these fields each time the
user presses the  Commit Data  function key.

You can use the SCROLL or DISPLAY commands in a function logic block to
display other data in this scroll area.

Window Starting Line Number   (Data screens only.)  If the screen is to
contain a window, this field specifies the starting line of the window
display area.  The starting line is included in the window area.

HP ALLBASE/4GL displays the window from the specified line number down to
the bottom of the screen.  Refer to chapter 12 for further details of the
WINDOW command.

Description   Documentation fields.  Enter a description of the screen
for documentation purposes.  HP ALLBASE/4GL automatically updates the
date and time fields to show the date and time of the last modification.

Function Keys 

f1       Function Keys  Cancels the current screen and displays the
        function keys screen.

f2       Screen Painter  Cancels the current screen and starts the screen
        painter program.

f3       Field Details  Cancels the current screen and displays the
        screen field details screen.

f4       Generate Screen  Generates the screen.

Additional Information 

You cannot specify a scroll area or window position for a window.  A
window may, however, reference and use the defined scroll area of the
data screen on which it is displayed.

HP ALLBASE/4GL will allow you to define a scroll area that overlaps data
input or output fields on the screen.  However, before HP ALLBASE/4GL
scrolls any data in this area, the scroll area is cleared of all text,
including screen literals and special text items.  In general, the scroll
area of a screen should not contain any data fields or text items.

Menus cannot have a scroll area or window.

You must define a header for an application screen using this screen
before you can paint the screen image with the screen painter or define
the attributes of its fields.

MPE/iX 5.0 Documentation