HP 3000 Manuals HP 3000 Manuals
Generating Migration Planning Reports
You generate MPT migration planning reports after you have created and
loaded the MPTDB database. If you have not yet created the MPTDB
database, follow the instructions found in "Creating the Migration
Planning Tool Database" before you run the MPTREPT program.
You use the MPTREPT program (MPTREPT.MPT.TELESUP) to generate six types,
or levels, of migration planning reports in addition to a general
information summary generated each time a report is printed. The first
levels are general summaries about the system and might be used to gain a
general understanding of the migration issues involved. Succeeding
levels of reporting are designed to further isolate the reported
migration events identified in files. The following is a short
description of the six levels of reports.
* Report Level One (System Summary) is a two page system summary
report showing a global summary of migration issues on the system.
* Report Level Two (Account Summary) has one line per account on the
system. It is used to determine if certain accounts will require
more attention during the migration than others.
* Report Level Three (Group Summary) has one line per group on the
system. It further identifies groups within accounts that might
require more attention than others.
* Report Level Four (File Summary) lists each file that was flagged
as requiring migration attention . The number and severity of
migration events is shown so you can pinpoint specific files which
need attention during migration.
* Report Level Five (File Detail) has the same information as Report
Level Four plus a brief description of each migration event found
in the file.
* Report Level Six (Event Summary) lists each migration event
detected and the files in which MPT located the event.
Follow the steps outlined below to generate MPT reports. Not all steps
are required, but should be considered.
1. Select a User Options Parameter File: If you are using the
MPTOPTNS parameter file (either your own, or the file
MPTOPTNS.MPT.TELESUP supplied with MPT) to define migration
options for disk space considerations, you must use the :FILE
command to equate the MPT formal file designator MPTOPTNS to your
parameter file. If you do not want user options defined, you must
equate MPTOPTNS to $NULL. For example, the following file equation
equates the MPT formal designator MPTOPTNS to your group and
account:
:FILE MPTOPTNS=MPTOPTNS.MYGROUP.MYACCT
2. Specify an Output Device: To direct MPTREPT output to a device
other than $STDLIST, use the :FILE command to equate the formal
file designator MPTLIST to the output device of your choice,
printing 132-character columns. For example, the following file
equation equates MPTLIST to an HP2680 printer and selects an
environment file that allows 132 column printing:
:FILE MPTLIST;DEV=HP2680;ENV=LP2.HPENV.SYS
3. Include Deleted Files in Reports: If you want to include in
Migration Planning Reports (Levels Four and Five) those MPE V/E
files normally deleted from migration planning reports, set the
SHOWDELETE Job Control Word to a value of one, for example:
:SETJCW SHOWDELETE=1
4. Run the Report Generation Program: Run the MPTREPT.MPT.TELESUP
program to generate migration planning reports from the data
collected in the MPTDB database. Below are options you can select
through the :RUN command to customize the report output generated
by MPTREPT are:
,SAVEPAPER Eliminates page breaks at
each major break in the
report. (The default is
a page break at major
report breaks.)
;PARM=page_length Selects the maximum
number of lines printed
on each page. The
default is 60 lines per
page.
;INFO=custom_report_title Prints the selected
character string at the
top of each report page.
The supplied string can
be a maximum of 60
characters.
The following example executes MPTREPT, specifying all optional
parameters:
:RUN MPTREPT.MPT.TELESUP,SAVEPAPER;PARM=80;INFO="ACME FINANCE REPORT"
4.1. Select Filesets to Include in Reports: The MPTREPT program
first prints a product banner to $STDLIST, then asks that you
select the files to be included in the report, giving directions
for including and excluding filesets from reports. At the
following prompt, enter the filesets you want included (or
excluded) from migration planning reports:
ENTER FILESET:
You can respond with one valid MPE fileset per line. You can
enter up to 100 filesets to be included and 100 filesets to be
excluded (in any order). Exclude a fileset by preceding the
fileset with a minus (-) sign. Pressing Return at the first
prompt includes all files (@.@.@) in the report. Pressing Return
at any other prompt ends fileset selection. Following are
examples of valid responses to the ENTER FILESET prompt of
MPTREPT:
@.@.GAMES
@.PUB.@
K####### (translates to K#######.@.@)
-@.PUB.SYS (do NOT include files in PUB.SYS)
-ERRORLOG.@.@
File selection is done once for all reports and remains unchanged
for one run of the reporting program.
4.2. Select a Report Level: After all files have been extracted
you will be asked to select a migration planning report level (1
through 6). At the following prompt, enter the level of the
migration planning report you want:
ENTER THE LEVEL OF DETAIL YOU DESIRE (1-6)
Selecting a report outside this range (0 or 7, for example) or
pressing Return terminates the program.
Report levels 1 through 5 all use a common data extraction from
the database, but report level 6 must extract its own data. If
you desire only report 6 then you can save time by pressing CTRL Y
during the first data extraction (before choosing a report) and
terminating that extraction early. When report 6 is chosen it
will extract its own data each time it runs. If you select report
level 4 or above (file summary, file detail, or event summary),
you will be further prompted to see if you wish to restrict the
report by event severity. (Refer to 4.3 below.)
You are repeatedly asked to select a migration planning report
level until you respond by pressing a Return. At this point the
program terminates.
As you select the report, it will be generated in the MPTLIST
file.
4.3. Restrict Reported Events: If you select report level 4 or
above (file summary, file detail or event summary), you are
further prompted to restrict the report by event severity . If
you want to see all files, respond NO or press Return at the
following prompt:
DO YOU WANT TO RESTRICT REPORTED EVENTS (Y/N)?
If you respond to the prompt with Y(ES), MPTREPT prompts you to
select which levels of severity will be reported both for CM
migration events found in files you are migrating to CM, as well
as for NM migration events in files you are migrating to NM:
ENTER LEVEL FOR COMPATIBILITY MODE (0-4)
ENTER LEVEL FOR NATIVE MODE (0-4)
The following are valid responses to the above prompts:
* 0 = report all events.
* 1 = report only POSSIBLE, WARNING, and ERROR events.
* 2 = report only WARNING and ERROR events.
* 3 = report only ERROR events.
* 4 = suppress all events.