HP 3000 Manuals HP 3000 Manuals
Loading the Application Once all the files have been copied to the MPE/iX system, the next step is to load the application into the HP ALLBASE/4GL system files. To do this you must use the application loading screen from the utilities menu. To access this screen, select the Utilities option on the administrator main menu, and then select the Load Application option on the utilities menu.Complete this screen by making the following entries: Application. Enter the name of the application. Rename Application to. This field is optional. You can rename an application while you are loading it provided the application doesn't have any versions stored with it. If the application does have versions stored with it, you cannot rename it. Press the Commit Data function key to complete this screen. HP ALLBASE/4GL presents a series of messages as the details of the application are loaded into the HP ALLBASE/4GL system files. If any inconsistencies are found in the application that is being loaded, an error message is displayed. If this occurs, contact your support service and request an updated application definition file without inconsistencies. KSAM Data File Reformatting When you load an application, HP ALLBASE/4GL checks for the existence of a file-structure file. (That is, a file of the same name as the application in the group and account identified by the MPE/iX variable HP4FSPATH.) If a file-structure file exists, HP ALLBASE/4GL displays a warning message telling you that data files will be reformatted. HP ALLBASE/4GL also displays a query message asking you if you want to go ahead with loading the application. If you proceed with loading the application, all KSAM data files for the application that have a structure file present (that is, a file with an "S" suffix) will be reformatted. If you enter N in response to the query message, the load process is aborted. If you enter Y, HP ALLBASE/4GL loads the application definition into the system files. When the application definition has been loaded, HP ALLBASE/4GL calls the data file reformat routine to reformat application data files. The data file reformat routine compares the file structure for each data file as it is stored in the file-structure file, and in the structure file for each data file. If the file's structure has changed, HP ALLBASE/4GL reformats the data file. If the structure of a data file recorded in the file-structure file, and the structure shown in the file's structure file are identical, the data file is not reformatted.
CAUTION Under some circumstances, the file reformat process may fail. If a file cannot be reformatted successfully, HP ALLBASE/4GL displays a warning message and prints a warning on a data file reformat report. Don't attempt to use the application if a data file has not been reformatted successfully. Attempting to use an application with an incorrectly formatted data file may corrupt the existing data in the file. If you receive a warning message during the reformat process, or the data file reformat report contains a warning message, contact your HP ALLBASE/4GL support service before you use the application.
In general, you won't need to take any specific actions during the data file reformat process. However, under some circumstances it may be necessary to avoid reformatting some specific data files. Your HP ALLBASE/4GL support service can tell you if this situation applies to you, and give you details of the steps you need to take. If you don't want a file to be reformatted even if the structure has changed, you must rename the file. To do this you should rename all MPE/iX files for the data file. These are the files fileD, fileK, and fileS where file is the name of the file. * Delete or rename the fileS file for the data file. * Move the file to a group different from the one specified by the MPE/iX variable HP4DATAPATH. HP ALLBASE/4GL displays a series of messages showing the files that are being reformatted, and indicating whether any error conditions occur. At the end of the file reformat process, HP ALLBASE/4GL deletes the file-structure file and updates each file's structure file showing the new structure. Version Data Files. If you are loading a version with the application, the data files are reformatted according to the definitions for the version, not the base application. Under some circumstances, you may need to load an application two or more times. Each successive load will reformat the data files for a specific version, and the data files for the base application itself. This only applies if the version data files are different from the base application data files. Your HP ALLBASE/4GL support service can tell you if this situation applies to you. File Reformat Report At the end of the reformat procedure, HP ALLBASE/4GL writes a report containing the text of all the file reformat messages to a temporary file called HP4RFLOG. The report contains a warning message for any file which has not been reformatted correctly. Database Environment Module Installation If the application you are loading uses an HP ALLBASE/SQL database, the application loading process attempts to connect to the database and install an executable database module for the application. This part of the loading process can only succeed if the correct database environment exists, and you have the correct access authority for the database. You must have resource authority, or be the database administrator. If the loading process cannot connect to the database, HP ALLBASE/4GL displays a message allowing you to enter the name of a database environment. You can enter the name of a database environment, or enter / to terminate the application loading process. Defining Security The last part of the process of loading an application is to define the users and the security for the application. Use the application definition and version definition screens to define the users for the application. If you are using the application loading process to update an existing application, the application you are loading will probably not have the application definition screen details included with the unloaded application. In this case, your existing user name and application password definitions should not be affected by the update. However, if the application you are loading does include the details from the application details screen, your existing security definitions will be overwritten. Database definitions may also be overwritten, so you should ensure that the correct database names are used. If you are updating an existing application, any existing menu item security definitions will be overwritten during the update. You must redefine the menu item security after you have finished loading the application. Refer to Chapter 4 for details of the menu item security system and HP ALLBASE/4GL security in general.
![[]](../../pic3k/M012322/FFN133c50.gif)