HP 3000 Manuals HP 3000 Manuals
Loading Applications The HP ALLBASE/4GL application loading functions allow you to load an application (and up to 10 versions of the application) into the HP ALLBASE/4GL system. The application load function loads an application into the HP ALLBASE/4GL system files from an MPE/iX file. This function allows you to load new applications to your HP ALLBASE/4GL system or update existing applications. The application to be loaded must have been unloaded from an HP ALLBASE/4GL developer system. Unloaded HP ALLBASE/4GL applications are stored in a single MPE/iX file. The application loading function takes the information in this file and loads it into the HP ALLBASE/4GL system files so you can use the application.
CAUTION We recommend that you create a full backup of your HP ALLBASE/4GL system, or a full system-wide backup before you start loading an application. This applies especially if you are updating an existing application that requires reformatting of KSAM data files. If you don't have a backup, you may not be able to restore your system to a working condition if the load is not successful.
The application loading process involves two stages. They are: 1. Copy the file containing the unloaded application into the MPE/iX group and account that contains any unloaded application files. In the default environment this is HP4APPNR.HP4GLR. You will also need to copy any database files for the application into the appropriate MPE/iX groups and accounts. Your HP ALLBASE/4GL support service can tell you the names of these files. 2. Use the application loading screen to load the application into the system files. Under some circumstances, HP ALLBASE/4GL automatically reformats the data files for existing applications during the loading procedure. This can only occur when you are using the application loading procedure to update an existing application, and the format for the KSAM data files used by the application has changed. Your HP ALLBASE/4GL support service can tell you if any application data files need to be reformatted during application loading. Once the application has been loaded, you can define the security requirements for the application, and then use the application. The following paragraphs describe these steps in more detail. To copy the appropriate files to the MPE/iX system, and load an application into HP ALLBASE/4GL, you will need to know the following: * The name of the file containing the unloaded application. * The name of the application (and any versions of the application) being loaded. * The names of the KSAM data files used by the application (if any). * The name of the HP ALLBASE/SQL database environment and the SQL owner group for the application if it uses an HP ALLBASE/SQL database. * The names of any HP TurboIMAGE/iX databases used by the application. Your HP ALLBASE/4GL support service can give you this information.
NOTE The instructions in this section assume that your system has been installed under the standard MPE/iX group and account structure for HP ALLBASE/4GL. Check with your HP ALLBASE/4GL support service to make sure that these instructions apply for your system.
Copying the Files To load a new application into your system, you must copy a number of files onto the MPE/iX system. The names and types of these files are summarized in the following paragraphs. Your HP ALLBASE/4GL support service can tell you which of these files are required when you load an application. Application Definition File. You must copy the file containing the unloaded application to the MPE/iX group and account identified by the MPE/iX variable HP4APPNPATH. This file will have the same name as the application it contains. HP ALLBASE/SQL Database Module Files. If you are loading an application that uses an HP ALLBASE/SQL database, you will need to copy at least one database module file onto the system. (Database module files contain the developer defined queries and other commands that access the HP ALLBASE/SQL database.) If you are loading a number of versions with the application, you must have one database module file for the base application, and one database module file for each version. The database module files must be copied into the group and account identified by the MPE/iX variable HP4DBMPATH. These files have the same name as the application or version they belong to. HP TurboIMAGE/iX Databases. You will need to copy any HP TurboIMAGE/iX databases used by the application to the new system. If you prefer, you may create new HP TurboIMAGE/iX databases with the same structure as the HP TurboIMAGE/iX databases used by the application developers. Data Files. Since the HP ALLBASE/4GL run-time environment cannot create KSAM data files, you may also need to copy a set of data files for the application to the group and account identified by the MPE/iX variable HP4DATAPATH. Once these data files have been copied into the system, the HP ALLBASE/4GL run-time environment maintains the files. Most likely the data files you copy onto the system will be empty. However they must be present in the correct MPE/iX group and account when you run the application. HP ALLBASE/4GL uses these empty files to store your application data. If you are updating an existing application, the data files for the application will already exist on the system. In this case, you won't need to copy any data files onto the system unless the updated application requires new files. Data File Reformat File. If you need to reformat KSAM data files during the application loading process, you will need to copy a file-structure file onto the MPE/iX system. This file will have the same name as the application you are loading. You must copy this file to the group and account identified by the MPE/iX variable HP4FSPATH. Summary. The following list summarizes the files that you need to copy onto the MPE/iX system before you load an application. KSAM Application. * For a new application: -Application definition file. -KSAM data files. * To update existing application without data file reformat: -Application definition file. * To update existing application with data file reformat: -Application definition file. -Data file reformat file. HP ALLBASE/SQL Application. * For a new application: -Application definition file. -Database module file. * To update existing application: -Application definition file. -Database module file. HP TurboIMAGE/iX Application. * For a new application: -Application definition file. -HP TurboIMAGE/iX databases used by the application. * To update existing application without database restructure: -Application definition file. * To update existing application with database restructure: -Application definition file. -Restructured HP TurboIMAGE/iX database.