You use the migration help function on a Program, Screen
or Server to see whether the COBOL generated in Pacbase is different from
the locally generated code.
Before you begin
To be able to use the migration help, you must previously:
- Convert its Pacbase design
to its PDP design
available from Rational Programming Patterns for System z.
- Generate, in Pacbase,
the Macros called by the Program, Screen, or Server and import their
corresponding .cblmsp files into the location.
- Generate, with the Pacbase generation
procedure, the COBOL file which contains both the code generated from
the design and the specific code.
- Generate, with the MIA1 (for Programs), MIA2 (for Screens), MIA3
(for TUI clients), or MIA4 (for Servers) batch procedure, the COBOL
control file. This file contains only the code generated from the
design.
Procedure
You can start the migration help by:- Using the migration help wizard. From the Design
Explorer view, right-click an instance and select Migration
help. A two-page wizard opens up:
- On the first page, you specify the two COBOL files generated in Pacbase. Then click Finish if
you want to keep the default option related to the constants and the
generation date. When the wizard is opened for the first time, the
default option consists in replacing the constants and date of the Pacbase generated file with
those of the locally generated file. If you want to see what the default
option is or if you want to modify it, click Next to
access the second page of the wizard.
- On the second page, you indicate whether you want to keep the
constants and date of the Pacbase generated
file, and if so, whether a warning is to be displayed on the corresponding
lines. Then click Finish.
- Or entering a migration help batch command line from
a command prompt.
Results
The migration help function copies the
Pacbase generated COBOL
file to your workspace (in the
COBOL target indicated
in the
Definition tab of the instance, and under
the name indicated in the
COBOL program ID (for
Programs) or
Program external name (for Screens
and Servers)).
It generates the local COBOL file, using the skeleton
language retrieved from the Pacbase extraction and import.
Then
it compares the content of the control file with the content of the
locally generated file and sets warnings wherever it finds differences.
To
view these warnings, you must open the generated COBOL file with the PDP COBOL editor. The warnings
are displayed directly on the COBOL lines and in the Problems view.
They remain as long as you do not fix them (quick fixes are available).
An
information message is displayed when you open the COBOL code of an
instance which still contains warnings.