HP 3000 Manuals

HP ALLBASE/4GL Developer Self-Paced Training Guide

The Utilities Menu 

To access the utilities menu: 

   1.  From the main menu, select the Utilities option.


          Utilities Menu 

Displaying the Catalog 

The catalog display utility allows you to look at the names of items
defined in your application.  This utility is available from most menus
in the developer.

To activate the utility: 

   1.  Select and activate Catalog Display.

       The following figure will appear.


          Catalog Display Screen 

       There is only one data entry field on this screen.  This is the
       number indicating the type of item names you want displayed.

   2.  Follow the steps shown here to display the names of the screens
       you have defined so far in your application.

Action                    Explanation 

------------------------------------------------------------------------------

Enter 14                  This is the number corresponding to Screens.  The
                          upper part of the screen lists these items and
                          numbers.

Press  Commit Data        This displays the names of all the screens defined
                          for this application.

Press Return              Depending on how many of these items you have
                          defined for this application this has one of two
                          effects.  If there is more than one screen of
                          names, another screen will be displayed.  This
                          process continues until all the names have been
                          displayed.  Once the last screen of names has been
                          displayed you are returned to the catalog display
                          screen.

You can use the same method to display the name list of any items in your
application.

With the catalog display utility, you can determine if the item you are
looking for actually exists.  If you have mistakenly created an item with
an incorrect name, you can use the copy and delete utilities to correct
the error.  To rename an item, you must copy it to a new name and then
delete the original.

Step through the item numbers and see the items you have created in your
application.

Copying Catalog Items 

Return to the utilities menu and then select the Copying option.  This
allows you to copy an item that already exists in your application.  You
can also use this screen to copy an item from another application or
version in the same HP ALLBASE/4GL system to an item in your application.


          Catalog Copying Screen 


NOTE  You are not required to make the following entries.  However, you
      may if you wish to practice using the copying utility.


To practice using the copying utility: 

   1.  Check the name of the application or version you want to copy
       from.  The display in the Application to copy FROM field defaults
       to the name of the application or version you're currently
       developing.

       You would type over this default if you wanted to copy an item
       from a different application.

   2.  Enter the number that indicates the type of item you want to copy;
       enter 1 in the item type number field.

   3.  The next field is for the name of the item you want to copy; enter
       product_no

   4.  The last field is the name of the new item you want to create.  If
       an item of this type with this name already exists, the copy is
       not allowed.

       Enter product_no_new

   5.  To actually copy the item, press the  Commit Data  function key.
       When the copy is finished, HP ALLBASE/4GL prompts you for the name
       of the next item to copy.

       Now product_no_new has the same definition as product_no.


NOTE  Since you can copy items from another application, you could set up
      a "library" application on your system to store a variety of
      standard items.  For example, you may have some standard field
      specifications or functions that are used by a number of
      applications.  Instead of creating the item each time it's needed,
      you can create the item once in the library application, and then
      copy the items as you require them.


Deleting Catalog Items 

Return to the utilities menu and select the Deleting option.  This allows
you to delete any item defined in an application.


          Catalog Deletions Screen 


NOTE  You are not required to make any entries here.  If you did create
      the product_no_new field specification previously, then you can
      follow these steps to delete it.


To practice deleting an item: 


CAUTION  This is a physical deletion of the item.  You cannot retrieve an
         item after you delete it.


   1.  Once again, you must first enter the number indicating the type of
       item you want to delete.

       Enter 1

   2.  Then you can enter the name of the item to be deleted.

       Enter product_no_new

   3.  When you press Return, HP ALLBASE/4GL displays the description of
       the item if it has one.

   4.  Press the  Commit Data  function key to delete the item.

       After you press the  Commit Data  function key, HP ALLBASE/4GL
       displays a message confirming that the item has been deleted.

Printing Catalog Items 

Return to the utilities menu and select the Printing option.  This
enables you to print a hard copy listing of your entire application, or
selected portions of it.


          Catalog Printing Screen 


NOTE  You are not required to make any entries here, however you may wish
      to print a list of the items you have developed so far.  If so,
      follow the instructions below.


To enter the field values: 

        Field                 Entry                         Explanation 
---------------------------------------------------------------------------------------

Catalog Item Type     1                     Allows you to indicate the type of item you
Number                                      want printed.  You can either enter the
                                            appropriate code 1 - 22 for the group of
                                            items you want, or enter A to specify that
                                            you want all item groups printed.

Short Index List or   Accept N              You can print an index list of catalog item
Full Index List                             names with the text of the short
                                            description field or with the full
                                            description text.  To list item names and
                                            their short description, enter S for short 
                                            index.  To list item names and their full
                                            text description, enter F for full index.
                                            Enter N if you don't want an index list of
                                            catalog item names.

Print Catalog Item    Accept Y              Enter Y if you want to print the detailed
Details                                     definition of each item.  Enter N if you
                                            only want to print an index list.

All Entries or        S                     Here you can specify that you wish to have
Selected Names                              all the entries for the particular item
                                            group printed by entering A. If you enter S
                                            for selected entries you must complete the
                                            next fields.

Selected Names        product_no and        These fields allow you to enter the names
                      description           of up to 16 items for the given type to be
                                            printed.  If you enter any names in these
                                            fields, the entry in the field above
                                            automatically changes to S.

                                            If you don't want to enter the names of any
                                            items, press the  Commit Data  function
                                            key.

To print the items: 

   1.  Press the  Commit Data  function key to commence the printing.

       If no items of the type you specify can be found, HP ALLBASE/4GL
       displays a message and no report is produced.  If you have given a
       list of names of items to be printed, those that can be found are
       printed.  A message is printed on the report if a requested item
       could not be found.

       By default, the report is printed on the system line printer.

MPE/iX 5.0 Documentation