HP 3000 Manuals HP 3000 Manuals
Migrating BASIC DATA and Binary Files
Use the migration aid to migrate BASIC DATA and binary files. The
migration aid is a program called BBCTMPEV.PUB.SYS that you use for data
file migration. It helps prepare files for use in native mode on MPE XL
systems. Programs must run in native mode to take full advantage of HP
Precision Architecture performance. The migration aid helps prepare
files by:
* Changing compatibility mode BASIC DATA (BDATA) files to native mode
BASIC DATA (BDTXL) files. The migration aid changes MPE V real data
to IEEE real data format.
You can access compatibility mode BASIC DATA files in HP Business
BASIC/XL programs but performance will suffer. Performance will be
low because HP Business BASIC/XL has to perform real data changes on
each READ and WRITE in compatibility mode BASIC DATA files. Real
data change is necessary because native mode programs only support
IEEE real data format.
After you change a native mode BASIC DATA file with this option, real
format change of READs and WRITEs is unnecessary because real data
format in the data file has already been changed to IEEE format.
* Adding a filecode (BBNCM) to compatibility mode binary files. This
filecode allows compatibility mode binary files to be accessed by
native mode HP Business BASIC/XL programs. The filecode does not
interfere with access by compatibility mode programs.
Using the Migration Aid
There are two ways to use the migration aid:
* Using a job stream file and the RUN command to migrate several files
at once.
* Interactively to migrate one file at a time.
Use a job stream file if you have several files to migrate, the migration
aid will still process the files one at a time, but you will be able to
enter the commands all at once. Job stream files are explained next, in
the section "Migrating Multiple BASIC DATA and Binary Files".
Migrating Several BASIC DATA and Binary Files at Once
To migrate multiple BASIC DATA and binary files, use a job stream file.
The migration aid will still process the files one at a time, but you
will be able to enter the commands all at once.
A job stream file that migrates several BASIC DATA files and several
binary files might look like this:
________________________________________________________________________
| |
| |
| !Job Jconvert1, user.group/pass; outclass=pp,2 |
| !RUN BBCTMPEV.PUB.SYS; info="1 bdtbb1 bdtbbx1 y" |
| !RUN BBCTMPEV.PUB.SYS; info="1 bdtbb2 bdtbbx2 y" |
| !RUN BBCTMPEV.PUB.SYS; info="1 bdtbb2 bdtbbx3 y" |
| !RUN BBCTMPEV.PUB.SYS; info="2 binbb1" |
| !RUN BBCTMPEV.PUB.SYS; info="2 binbb2" |
| !RUN BBCTMPEV.PUB.SYS; info="2 binbb3" |
| !EOJ |
| |
________________________________________________________________________
Figure 4-3. Example Job Stream File for Migrating BASIC DATA Files
The first three RUN commands change compatibility mode BASIC DATA (BDATA)
files to native mode BASIC DATA (BDTXL) files. The second three RUN
commands add a filecode (BBNCM) to compatibility mode binary files. The
RUN commands that migrate BASIC DATA files are longer than the RUN
commands for binary files because RUN commands for binary files only use
two of the four possible parameters. RUN commands for BASIC DATA files
use all four of the parameters.
The filecode, BBNCM, allows compatibility mode binary files to be
accessed by native mode HP Business BASIC/XL programs. The filecode does
not interfere with access by compatibility mode programs.
To run the job above, type
STREAM Jconvert1
at the MPE XL prompt.
The RUN command can also be used directly at the prompt to migrate one
file at a time.
RUN BBCTMPEV.PUB.SYS; info="1 BB/V_file HPBB/XL_file replace_values"
Specify the filename and group name if the file is in another group or if
you want to save the file in another group.
Parameter List.
option The option you choose, either "1" or "2".
Option 1 changes compatibility mode BASIC DATA
files to native mode BASIC DATA files. Specify
all three other parameters if you choose "1".
Option 2 adds the filecode to compatibility
mode binary files. Specify only one more
parameter (compatibility_mode_file) if you
choose "2".
Business_BASIC/V_file The name of the compatibility mode BASIC DATA
or binary file you want to change.
BBCTMPEV.PUB.SYS assumes this file exists.
HP_Business_BASIC/ The name you want to give the changed BASIC
XL_file DATA file. BBCTMPEV.PUB.SYS assumes this
filename is not currently being used. Only use
this parameter for BASIC DATA file migration.
replace_values Represents whether or not you want to replace
short real values with IEEE minimum or maximum
short real values when SHORT REAL overflow or
underflow occurs. Specify either "Y" for yes
or "N" for no. Only use this parameter for
BASIC DATA file migration.
Migrating One BASIC DATA File at a Time
Follow the steps below to migrate one BASIC DATA file at a time.
1. Type the following at the MPE XL prompt to change compatibility
mode BASIC DATA files to native mode BASIC DATA files:
RUN BBCTMPEV.PUB.SYS
The following will appear on your screen:
__________________________________________________________________________________
| |
| |
| Business BASIC V TO XL Conversion Utility (HP32715A.00.00). |
| Copyright Hewlett-Packard Co. 1988. |
| |
| Select an option: |
| 1. Compatibility Mode Business BASIC DATA (BDATA) to Native Mode Business |
| BASIC DATA (BDTXL) file conversion. |
| |
| 2. Add filecode to Compatibility Mode binary file |
| |
| 3. Exit conversion utility |
| |
| Option No.: |
| |
| |
__________________________________________________________________________________
2. Choose option 1 by typing "1" at the Option No.: prompt or press
"3" to exit the migration aid.
The following text will appear directly below the prompt:
_______________________________________________________________________
| |
| |
| Please enter the source file name: |
| |
_______________________________________________________________________
3. Type the name of the file you want to change. You can only change
one file at a time with this method. Specify the filename and
group name if the file is in another group.
The following text will appear directly below the last prompt:
_______________________________________________________________________
| |
| |
| Please enter the target file name: |
| |
_______________________________________________________________________
4. Type the name you want the changed file to be saved as. Specify
the filename and group name if you want to save the file in
another group.
The following text will appear on your screen:
__________________________________________________________________________
| |
| |
| *********************************************************** |
| You might get SHORT REAL overflow or underflow during conversion, |
| because on MPE V, short reals had exponents up to +/-77, Whereas, |
| on MPE XL, short reals allows exponents of only +38/-45. |
| ************************************************************ |
| When SHORT REAL overflow or underflow occurred, do you want |
| to replace short real values with IEEE min. or max. short reals? |
| |
__________________________________________________________________________
5. Enter either Y for "Yes" or N for "No."
The migration aid will stop when an overflow error occurs if you
choose N. The migration aid replaces values that cause overflow
errors with the maximum IEEE short real value if you choose Y.
You will see the following message when the migration aid is
finished:
______________________________________________________________________
| |
| |
| ********************************* |
| Done with CM to NM Business |
| BASIC DATA file conversion |
| ********************************* |
| |
______________________________________________________________________
Migrating One Binary File at a Time
Follow the steps below to migrate one binary file at a time.
1. Type the following at the MPE XL prompt to add the filecode,
BBNCM, to a compatibility mode binary file:
RUN BBCTMPEV.PUB.SYS
The following will appear on your screen:
__________________________________________________________________________________
| |
| |
| HP Business BASIC V TO XL Conversion Utility (HP32715A.00.00). |
| Copyright Hewlett-Packard Co. 1988. |
| |
| Select an option: |
| 1. Compatibility Mode Business BASIC DATA (BDATA) to Native Mode Business |
| BASIC DATA (BDTXL) file conversion. |
| |
| 2. Add filecode to Compatibility Mode binary file |
| |
| 3. Exit conversion utility |
| |
| Option No.: |
| |
| |
__________________________________________________________________________________
2. Choose option two by typing "2" at the Option No.: prompt.
The following text will appear directly below the prompt:
_______________________________________________________________________
| |
| |
| Please enter the source file name: |
| |
_______________________________________________________________________
3. Type the name of the compatibility mode binary file you want to
add the filecode to. You can only change one file at a time with
this method. Specify the filename and group name if the file is
in another group.
The following text will appear directly below the last prompt:
_______________________________________________________________________________________
| |
| |
| A filecode, "BBNCM" is added to allow compatibility |
| mode binary files to be accessed by native mode HP Business BASIC/XL programs. |
| |
_______________________________________________________________________________________
You will see the following message when the migration aid is
finished:
_____________________________________________________________________
| |
| |
| ********************************* |
| Done with CM to NM Business |
| BASIC DATA file conversion |
| ********************************* |
| |
_____________________________________________________________________