HP 3000 Manuals HP 3000 Manuals
Loading Procedure
Before you can load an application to an HP ALLBASE/4GL system, you must
copy or move the application definition files to the MPE XL group and
account identified by the HP4APPNPATH variable.
To load any application, the application definition file for the
application must be present. If KSAM data files must be reformatted
during the application loading process, the file-structure file must be
present in the group and account identified by the variable HP4FSPATH. If
this file is not present, the data files will not be reformatted.
If the application you are loading uses an HP ALLBASE/SQL database or an
HP TurboIMAGE/iX database, the database should exist.
In addition, the HP ALLBASE/SQL database must contain the DBE filesets
used by the application before you load the application. The database
module files for the base application, and for any versions of the
application, must be present in the group and account identified by the
variable HP4DBMPATH. To load an application to an HP ALLBASE/4GL system,
you must display the application loading screen. To display this screen,
select the Load Application option on the utilities menu. Enter the name
of the application you want to load in the Application field on this
screen.
Renaming Applications
The application loading screen allows you to rename an application while
you are loading it. To rename an application, enter the new name for the
application in the Rename Application to field.
You cannot rename an application if it is a base application for one or
more versions.
Performing the Load
When you have completed your entries on the application loading screen,
press the Commit Data function key. HP ALLBASE/4GL then calls the
application loading routine.
The loading procedure checks 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 chapter 12 of the HP ALLBASE/4GL Developer Reference
Manual to remove the inconsistencies.
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 HP4TIPATH MPE/iX variable to point to the location of the
databases.
* Ensure that the HP TurboIMAGE/iX external file name field set for
the database on the database definition screen is correct.
* 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 the user access password defined for the application may
not be the same as the user access passwords defined in the new
database.
Data File Reformat
CAUTION If you are loading an application that requires reformatting of
data files, make sure that you have a backup copy of any KSAM
data files and HP ALLBASE/4GL system files before you start the
application loading procedure.
When you are loading an application, HP ALLBASE/4GL checks for the
existence of a file-structure file in the group and account identified by
the variable HP4FSPATH. If a file-structure file exists, HP ALLBASE/4GL
displays a warning message telling you that data files will be
reformatted and 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 under the MPE/iX
group and account identified by the variable HP4DATAPATH that have a
structure file present 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 S-files. When the application definition has been loaded, HP
ALLBASE/4GL calls the data file reformat routine to reformat application
data files. HP ALLBASE/4GL 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 structure has changed, HP
ALLBASE/4GL reformats the data file. If the structure of a data file
recorded in the structure file, and the structure shown in the
file-structure file are identical, the data file is not reformatted.
If you don't want a file to be reformatted even if the structure has
changed, you must take one of the following actions:
* Rename the file.
To do this you should rename all MPE/iX files for the data file.
These are the files file, fileK, and fileS where file is the name
of the file.
* Delete or rename the structure file for the data file.
* Move the file to a group and account other than the group
specified by the variable HP4DATAPATH.
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.
HP ALLBASE/4GL displays a series of messages showing the files that are
being reformatted and indicating whether any error conditions occur.
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 the data file
report. Don't attempt to use the application if a data file has
not been reformatted successfully. An incorrectly formatted
data file may corrupt the existing data in the file.
At the end of the file reformat process, HP ALLBASE/4GL deletes the file
containing the file structure information.
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. By default, the
report is directed to device disc file HP4RFLOG. The formal file
designator for the report is HP4RFLOG.
If any files have not been reformatted correctly, the report contains a
warning message.
Menu Item Security
If you use the application loading procedure to update an existing
application, any menu item security definitions for the application are
overwritten.
In addition, any menu item security definitions for a new application
will be meaningless after the application has been loaded into the HP
ALLBASE/4GL system.
You must redefine the menu item security for the application after you
have completed the loading procedure.