HP 3000 Manuals HP 3000 Manuals
Application Loading Screen This screen allows you to load an application and any versions stored with it into the HP ALLBASE/4GL S-files. You can access this screen from the Utilities option on the main 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 details about the precautions you should take before you load an application.
Screen ImageField Descriptions Application. Enter the name of the application that you want to load. The names administ, developr, hpqm, HPlogo, HPLIBnnn and ULIBnnn (where nnn is a three-digit language identifier) are reserved application names. You may load these applications but you should not rename them. 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.
Overwrite Existing Field Specs. If you enter Y in this field, any field specifications in the load file will overwrite the field specifications for the same fields (if they exist) in the application dictionary. If you enter N in this field, the existing field specifications in the application dictionary are retained. Any changes to existing field specifications in the load file are ignored, but the specifications for new fields in the load file are written into the application dictionary. You must enter Y in this field if you are loading a run-only application and the application data files require reformatting. Print Load Report. Enter Y to print a load report, or enter N to suppress printing of the report. HP ALLBASE/4GL writes the report to the formal file designator HP4REP. By default, the report is printed on device class LP. The report lists the names and details of any new or altered dictionary field specifications loaded to the system S-files. 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. f3 Unload Applic. Cancels the current screen and displays the application unloading screen. f6 Commit Data Starts the application loading process. Additional Information The loading procedure runs a check on the S-files of the application, and if any inconsistencies are found, an error message is displayed. Unless your application was created before the B.01 release of HP ALLBASE/4GL, use the procedures in the Utilities chapter of the HP ALLBASE/4GL Developer Reference Manual to remove the inconsistencies. The application loading utility loads an application from the application definition file into the S-files. The application definition file must be in the group and account identified by the HP4APPNPATH variable. You can use this screen to transfer an application from a different HP ALLBASE/4GL installation to your system, or restore an application from tape. To do this, you must use the appropriate MPE/iX commands to restore the application definition file to the system. 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 can use the MPE/iX utilities to restore the of files from tape. Alternatively, application developers can use the appropriate developer screens to create data files for the application. Application Data File Reformatting.
CAUTION The application loading process may reformat the KSAM data files for HP ALLBASE/4GL applications. If you use the application loading process to reformat application data files, make sure that you have backup copies 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 that have been unloaded without the source information. This mechanism is primarily intended for reformatting data files in the HP ALLBASE/4GL run-time environment, but it can be used to reformat data files in the HP ALLBASE/4GL developer environment. 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 the S-files, HP ALLBASE/4GL compares the file structure for the application data files as stored in the file-structure file and the file structure shown in the structure file for the KSAM files. The file-structure file must be in the group identified by the variable HP4FSPATH, and the structure files for the application data files must be in the account and group identified by the variable HP4DATAPATH. 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. 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 account and group identified by the variable HP4DATAPATH. Data files in other accounts and groups are not reformatted.
At the start of the application loading procedure, HP ALLBASE/4GL checks for the existence of a file-structure file for the application in the group and account identified by the HP4FSPATH variable. 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 purge or rename the structure file before you start loading the application. If you want to reformat some data files, but not others, you must purge, 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. 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. During the 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 HP4DBMPATH variable. If the HP ALLBASE/SQL database environment specified on the application definition record does not exist when you load the application, HP ALLBASE/4GL displays a message asking you to enter a database environment name. Enter the name of the database environment for the application, or enter / to terminate the loading procedure. HP TurboIMAGE/iX Applications. After loading an application that accesses one or more HP TurboIMAGE/iX databases, you must complete the following tasks before the application can be used: * Ensure that the databases exist, or create the appropriate databases. * Set the HP4IMAGEPATH MPE/iX variable to point to the location of the databases. * Ensure that the HP TurboIMAGE/iX user access password set for each database on the parameters for database access screen is correct. This is particularly important if you have created a new database, because you may not have used the same user access passwords in your database definition.
![[]](../../pic3k/M010438/FFN203c50.gif)