HP 3000 Manuals

HP ALLBASE/4GL Run-Time Administration Manual

Application Loading Screen 

This screen allows you to load an application and any versions stored
with it into the HP ALLBASE/4GL system.  This screen can be accessed from
the Utilities menu.


CAUTION  Using this screen to load an application into the HP ALLBASE/4GL
         system may cause KSAM data files for the application to be
         reformatted.

         Refer to Additional Information for information about the
         precautions you should take before you load an application.


Screen Image 


            

Field Descriptions 

Application.  Enter the name of the application you want to load.

Rename Application to.  Optional.  If you want to rename the application,
enter the new application name.


NOTE  You cannot rename an application if it is a base application for
      one or more versions.


Function Keys 

f1       Printing  Cancels the current screen and displays the
        administrator documentation screen.

f2       Deletes  Cancels the current screen and displays the
        administrator deletions screen.

Additional Information 

Normally, you would use this screen to load a new application into the
system, or to update an existing application.

The application loading utility loads an application from a single MPE/iX
file into the HP ALLBASE/4GL system files.  The MPE/iX file contains an
application that has been unloaded from an HP ALLBASE/4GL developer
system.

To use the application loading screen, the MPE/iX file containing the
unloaded application must be in the group and account identified by the
MPE/iX variable HP4APPNPATH. In the standard HP ALLBASE/4GL run-time
installation, this is HP4APPNR group in the HP4GLR account.

If any inconsistencies are found in the application that is being loaded,
error messages are displayed.  If this occurs, contact your support
service and request an updated application definition file without
inconsistencies.

Application Data Files.     

The application loading utility does not create any KSAM data files for
the application being loaded.  If the application requires KSAM data
files, you must copy these to the MPE/iX system before using the
application.

Application Data File Reformatting.   


CAUTION  The application loading process may reformat KSAM data files for
         HP ALLBASE/4GL applications.

         Make sure you have a backup copy of all your application data
         files before you start the loading process.


HP ALLBASE/4GL provides a means of automatically reformatting KSAM data
files for applications.

The data file reformat system uses the structure file associated with
each application data file, and the file-structure file created during
the unloading process for a run-only application.  After the application
is loaded into HP ALLBASE/4GL, the system compares the file structure for
the application data files as stored in the file-structure file and the
individual structure file for the data file.  If the two structures are
not the same, the KSAM data file is reformatted to match the new
structure shown in the file-structure file.  The file's structure file is
updated to show the new structure.  If the two structures are the same,
the KSAM data file is not changed.  At the end of the reformatting
process, HP ALLBASE/4GL deletes the file-structure file.


NOTE  The automatic data file reformatting system can only reformat data
      files in the group and account identified by the MPE/iX variable
      HP4DATAPATH. Data files in other groups and accounts are not
      reformatted.


At the start of the application loading procedure, HP ALLBASE/4GL checks
for the existence of a the application's file-structure file.  If this
file exists, HP ALLBASE/4GL displays a warning message.  Enter Y in
response to this message if you want to proceed with loading the
application, or enter N if you want to abort the load.


CAUTION  If you enter Y in response to this message, all KSAM data files
         for the application that have a structure file present will be
         reformatted during the loading process.


If you don't want to reformat any data files for the application, you
must delete or rename the file-structure file before you start loading
the application.

If you want to reformat some data files, but not others, you must delete,
move, or rename the structure file for the data files you do not want to
reformat.

Refer to Chapter 6  for more information about reformatting data
files.

HP ALLBASE/SQL Applications.   

If the application uses HP ALLBASE/SQL, the application loading procedure
installs the database module for the application in the database
environment.  The database environment for the application should exist
when the application is being loaded.

If HP ALLBASE/4GL cannot connect to the database environment specified on
the application definition screen, it displays a message asking you to
enter the name of a database environment for the application.  If you do
enter a database environment name, HP ALLBASE/4GL automatically amends
the application definition screen to include the new database environment
name.  Alternatively, enter / to terminate the application loading
procedure.

During application loading, HP ALLBASE/4GL creates the HP ALLBASE/SQL
tables used by the application if the tables don't exist.  If the
database tables already exist in the database environment for the
application, they are not affected by the application loading procedure.

The database module files for the application, and any versions of the
application must exist in the group and account identified by the MPE/iX
variable HP4DBMPATH during the loading procedure.

Refer to Appendix A for more information about application database
environments.

HP TurboIMAGE/iX Applications.   

If the application uses any HP TurboIMAGE/iX databases, you must either
copy them to the MPE/iX system before using the application, or create
new databases with the same structure as the HP TurboIMAGE/iX databases
used during application development.

MPE/iX 5.0 Documentation