HP 3000 Manuals HP 3000 Manuals
Installation
For customers using the full developer system:
The Administrator UNLOAD facility cannot be used to migrate applications
for the B.06.10 release patch. Instead, have your HP ALLBASE/4GL
administrator use the HP4STOA utility to save any existing HP ALLBASE/4GL
applications, application versions, and system information before
overlaying your S-files. At the end of the installation, the
instructions tell you to reload your HP ALLBASE/4GL applications using
HP4ATOS.
Although HP4STOA is slower than the HP ALLBASE/4GL Administrator unload
facility, it performs two functions the unload facility does not:
* preserves the menu security defined for the application
* extracts the system definitions including the following:
* user names and passwords
* menu item security definitions
* system specifications
* logic command and communication area synonymns
* master titles
For customers with a run-time only environment:
You cannot use HP4STOA or HP4ATOS but must reload your applications after
installation using the latest source media supplied by the application
developer.
NOTE If you have been using a B.00, B.01, B.02, B.03, or B.05 run-time
only version, check with your application supplier to be sure that
your source applications were generated using at least the B.06.00
(or later) version of HP ALLBASE/4GL. (version B.04 did not apply
to the MPE/iX system).
For applications written to use with HP ALLBASE/SQL databases:
If the application was not generated using the B.06 or later version of
ALLBASE/4GL, you must have the applications regenerated before they can
be run on the B.06 release.
Once B.06 is installed on your system, any existing unload files and
database management (DBM) files for applications using HP ALLBASE/SQL
will need to be recreated. Unload and DBM files that were created with
B.05 or before are not compatible with the B.06 release. If you have
unloaded your applications, you will need to recreate the unload and DBM
files after the installation is complete.
Also, check with the HP ALLBASE/SQL installation instructions to see if
your databases need to be migrated. Complete the migration of databases
before continuing with the ALLBASE/4GL upgrade.
First-time Installation Instructions
If this is a first-time installation (not installed over a previous
version of HP ALLBASE/4GL), use the following "Upgrade Instructions";
however, you won't need to save or restore existing applications.
Upgrade Instructions
These instructions are for previously installed versions of HP
ALLBASE/4GL.
1. Logon to the HP4GL account as system manager:
:HELLO MANAGER.SYS
2. Do a full system backup to protect your system files.
3. For run-time only environments, print a report of the following
definitions using the administrator documentation menu before you
perform the update using AUTOPAT:
* user names and passwords
* system specifications for date and decimal number format,
the currency float symbol, and the MPE/iX environment
specifications.
* master titles.
4. Make sure no one is using ALLBASE/4GL when you start the update
and that no one will attempt to sign on to the product while you
are updating the system.
5. Make sure that any reports finish printing before you start the
installation.
6. Mount the update media.
7. Run AUTOPAT.
8. Logon to the HP4GL or HP4GLR account:
For example, for the developer:
:HELLO MGR.HP4GL
or, for run-time:
:HELLO MGR.HP4GLR
9. If you want to preserve your current S-files (for future
reference), copy them to another group on the system.
For example:
:NEWGROUP HP4OLDS
:HP4SCOPY.HP4GL.SYS HP4S HP40LDS
10. Set the environment variable for HP4SPATH.
:SETVAR HP4SPATH "HP4S.HP4GL"
11. For the Developer system, save applications and system definitions
using HP4STOA. (Run-time only environment do not need to use this
step.)
For example, to extract the system definitions:
:BUILD SYSTEM.PUB;REC=-1276,,v,ASCII;DISC=100000
:HP4STOA.PUB.SYS "-uadminist:password>SYSTEM.PUB"
To extract the application source(s):
:BUILD APP1.PUB;REC=-1276,,v,ASCII;DISC=100000
:HP4STOA.PUB.SYS "-udeveloper user:password -aapplication 1:security code>APP1.PUB"
:BUILD APPn.PUB;REC=-1276,,v,ASCII;DISC=100000
:HP4STOA.PUB.SYS "-udeveloper user:password -aapplication n:security code>APPn.PUB"
_________________________________________________________________
NOTE The record size and the number of records allocated in the
BUILD command should be adequate for most cases. In some
extreme cases HP4STOA could fail if the file limits (record
size or the number of records allocated) are exceeded. If
the limits are reached, purge the file and rebuild it with a
larger limit. Then repeat the HP4STOA command.
_________________________________________________________________
The following applications DO NOT need to be extracted from the
environment, since they are part of the base environment delivered
with the new version of HP ALLBASE/4GL.
administ
developr
example
HPLIB000
hpqm
sqldemo
tutorial
_________________________________________________________________
NOTE If HP4STOA reports an error on an object, try one of the
following procedures to correct the problem.
a. Recommit the offending object and regenerate the
object (if applicable).
or..
b. Delete the object, re-add, and regenerate the object.
Perform the HP4STOA operation again.
_________________________________________________________________
12. Run HP4SCOPY:
HP4SCOPY.HP4GL.SYS HP4GL.SYS your_S-file_group Y
Restoring the applications (for existing HP4GL systems)
For developer systems
1. Use HP4ATOS to restore the applications previously saved using
HP4STOA.
For example, to restore the system definitions:
:HP4ATOS.PUB.SYS "-uadminist:password<SYSTEM.PUB"
To restore the application source(s):
:HP4ATOS.PUB.SYS "-udeveloper user:password -aapplication 1:security code<APP1.PUB"
:HP4ATOS.PUB.SYS "-udeveloper user:password -aapplication n:security code<APPn.PUB"
* Regenerate all applications.
For run-time only
1. Reenter the system definitions from the printout created in the
update task.
:HP4GLR
2. Reload regenerated applications from the tape or files supplied by
the HP ALLBASE/4GL application supplier.