Using the Report Migration Tasks panel you can compare report types,
reports, check for inheritance of new information and criteria, and
merge report types. You might use these migration tasks as you migrate
to a new release of z/OS or after maintenance has been installed that
enhances or corrects the distributed report types and reports.
Note: To avoid loss of existing customized reports or report types in your
user library, consider allocating and using an alternative data set
for the user library when performing the migration tasks.
When
you compare report types, DFSMSrmm checks the report type level between
the source and compare report types and report definitions. Only those
report types which are common to the source and compare libraries
are compared. DFSMSrmm compares report type level, library and macro
names, description, RDW setting, input data set name, help information,
and field data types. You can select the report type information which
should be copied from source to target library, and then select the
report types and definitions to be processed. The updated report types
are stored on the User library.
To perform one of the report migration tasks, follow this procedure:
- Type R on the DFSMSrmm Command Menu to select the Report option.
Press the ENTER key.
- Select the MIGRATION option on the DFSMSrmm Report Generator panel
as shown in Figure 1. Press the ENTER
key.
Figure 1. DFSMSrmm Report Generator panel - migration tasksPanel Help
-------------------------------------------------------------------------------
EDGPG000 DFSMSrmm Report Generator
Option ===>4
0 OPTIONS - Specify dialog options and defaults
1 REPORT - Work with reports
2 REPORT TYPE - Work with report types
3 REPORTING TOOL - Work with reporting tools
4 MIGRATION - Migration tasks for reporting
Enter selected option or END command. For more info., enter HELP or PF1.
- Select Source (S) and Compare (C) libraries on the DFSMSrmm Report
Migration Tasks panel, as shown in Figure 2, to perform one of these actions:
- 1
- Compare report types.
- 2
- Compare report definitions.
- 3
- Check report type inheritance.
- 4
- Merge report types from installation library to user library.
Figure 2. DFSMSrmm Report Migration Tasks panel Panel Help
------------------------------------------------------------------------------
EDGPG400 DFSMSrmm Report Migration Tasks
Command ===>
_ 1. Compare report types
2. Compare report definitions
3. Check report type inheritance
4. Merge report types from installation library to user library
Select Source (S) and Compare (C) Libraries: Default is compare with Product
S C Libraries: Currently defined Libraries:
C User USER.REPORT.LIB
C Installation LOCAL.REPORT.LIB
S Product SYS1.SAMPLIB
Enter selected task or END command. For more info., enter HELP or PF1.
Panel Help
------------------------------------------------------------------------------
EDGPG411 DFSMSrmm Report Type Compare
Command ===>
The following line commands are valid:
L – List the results of the compare
S - Display the source report type
C - Display the compare report type
U - Update the compare report type with the new report type data
S Type Differences Type description
Lev Help Typ Mac Sel
- -------- --- ---- --- --- --- ------------------------------
EDGRSEXT Y Y Y N N Bin extract
******************************* Bottom of data ********************************
Use the L line command to view the results of the compare.
***************************** Top of Data ******************************
Report Generator – Report Type differences 2011/03/17 08:20
Level Library
Source: Report type EDGRSEXT 01.11.00 Product SYS1.SAMPLIB
Compare: Report type EDGRSEXT none Installation LOCAL.REPORT.LIB
==> Differences found with: Record selection criteria
-------------------------
The specific differences are not shown here. Please display the
Source report type and the compare report type for details.
N- RSTYPE refer to source report type
O- RSTYPE refer to compare report type
N- RSTYPE2 missing in source report type
==> Differences found with: Data type information (with field and/or selection criteria)
---------------------------------------------------------------
N- DCUTIME TM1
O- DCUTIME
==> No differences found with: Macros, macro libraries and keywords
==> No differences found with: RDW setting
==> Differences found with: Help for report type
--------------------
N- Here appears the full new text
N- Here appears the full new text
N- Here appears the full new text
N- Here appears the full new text
O- Here appears the full old text
O- Here appears the full old text
O- Here appears the full old text
==> No differences found with: Help for report
==> No differences found with: Help for JCL generation
**************************** Bottom of Data ****************************
Use the S line command to enter the report type dialog for the
selected source report type – the EDGPG200 panel is displayed.
Use the C line command to enter the report dialog for the compare
report type – the EDGPG200 panel is displayed.
When you specify the U line command you can select which information
is used to update the report type from the compare library with selected
information from the report type in the source library. The updated
report types are stored on the user library.
Panel Help
------------------------------------------------------------------------------
EDGPG412 DFSMSrmm Report Type Compare
Command ===>
Source report type . : EDGRVEXT Compare report type . . . . : EDGRVEXT
Enter "/" to select the values to be copied:
Report type level
Help for report type
Help for report
Help for JCL generation
Data type information
Macros, macro libraries and keywords
RDW setting
Record selection criteria
You can select to copy the report type level to the target report
type so that you know that you have reviewed and applied all the changes
you want.
When you compare report definitions, DFSMSrmm checks the report
type and level used between the source and compare report definitions.
Only those reports that are common to the source and compare libraries
are compared. DFSMSrmm compares report type level, last change user
ID, library and macro names, description, RDW setting, input data
set name, report title, selection compare fields and values, sort
fields and direction, report column information, help information,
and field data types. You can select the report definition information
to be copied from source to compare library and then select the report
definitions to be processed. The updated report definitions are stored
on the user library.
Panel Help
------------------------------------------------------------------------------
EDGPG421 DFSMSrmm Report Definition Compare
Command ===>
The following line commands are valid:
L – List the results of the compare
S - Display the source report definition
C - Display the compare report definition
U - Update the report definition with the new report definition data
S Report Differences Report title
Lev Help Typ Mac Sel Sort Rep Dsn Ttl
- -------- --- ---- --- --- --- ---- --- --- --- -----------------------------
+
AA1186 Y Y Y N N Y Y N N SMF REPORT 1
******************************* Bottom of data ********************************
Use the L line command to view the results of the compare.
[part panel only]
***************************** Top of Data ******************************
Report Generator – Report definition differences 2011/03/17 08:20
Level Library
Source: Report definition AA1186 01.11.00 Product SYS1.SAMPLIB
Compare: Report definition AA1186 none User MY.REPORT.LIB
==> Differences found with: Record selection criteria
-------------------------
The specific differences are not shown here. Please display the
report definitions for details.
N- RSTYPE refer to source report definition
O- RSTYPE refer to compare report definition
N- RSTYPE2 missing in compare report definition
==> Differences found with: Data type information (with field and/or selection criteria)
---------------------------------------------------------------
N- DCUTIME TM1
O- DCUTIME
==> No differences found with: Macros, macro libraries and keywords
==> No differences found with: RDW setting
==> No differences found with: Change values
==> Differences found with: Help for report type
--------------------
N- Here appears the full new text
N- Here appears the full new text
N- Here appears the full new text
N- Here appears the full new text
O- Here appears the full old text
O- Here appears the full old text
O- Here appears the full old text
==> No differences found with: Help for report
==> No differences found with: Help for JCL generation
**************************** Bottom of Data ****************************
Use the S line command to enter the report definition dialog for
the selected source report – the EDGPG020 panel is displayed.
Use the C line command to enter the report dialog for the compare
report definition – the EDGPG020 panel is displayed.
When you specify the U line command you can select which information
is used to update the report definition from the compare library with
selected information from the report definition in the source library.
The updated report definitions are stored on the User library. You
can select to copy the report type level to the target report definition
so that you know that you have reviewed and applied all the desired
changes.
Panel Help
------------------------------------------------------------------------------
EDGPG422 DFSMSrmm Report Definition Compare
Command ===>
Report definition . : EDGRVEXT
Enter "/" to select the values to be copied:
Report type level
Help for report type
Help for report
Help for JCL generation
Data type information
Macros, macro libraries and keywords
RDW setting
Record selection criteria
Sort criteria
Report information
Input data set name
Report title
You can select to copy the report type level to the target report
definition so that you know that you have reviewed and applied all
the desired changes.
When you Check Report Type inheritance, DFSMSrmm compares the
detailed attributes for the report types in the source library with
those for the report definitions in the compare library, and for those
report definitions using report types in the source library displays
those which do not contain all the inherited information from the
report type. DFSMSrmm compares the help information and field data
type information and the report type level.
Panel Help
------------------------------------------------------------------------------
EDGPG431 DFSMSrmm Report Type Inheritance
Command ===>
The following line commands are valid:
L – List the results of the compare
S - Display the source report type
C - Display the compare report definition
U - Update the report definition with the new report type data
S Report Type Differences Report title
Lev Help Typ Mac Sel
- -------- -------- --- ---- --- --- --- ------------------------------
AA1186 EDGRSEXT Y Y Y N N SMF REPORT 1
******************************* Bottom of data ********************************
Use the L line command to view the results of the compare.
[part panel only]
***************************** Top of Data ******************************
Report Generator - Inheritance differences 2011/03/17 08:20
Level
Source: Report type EDGRSEXT 01.11.00 Product SYS1.SAMPLIB
Compare: Report definition AA1186 none Installation LOCAL.REPORT.LIB
==> Differences found with: Record selection criteria
-------------------------
The specific differences are not shown here. Please display the
report type and the report definition for details.
N- RSTYPE refer to source report type
O- RSTYPE refer to compare report definition
N- RSTYPE2 missing in compare report definition
==> Differences found with: Data type information (with field and/or selection criteria)
---------------------------------------------------------------
N- DCUTIME TM1
O- DCUTIME
==> No differences found with: Macros, macro libraries and keywords
==> No differences found with: RDW setting
==> No differences found with: Change values
==> Differences found with: Help for report type
--------------------
N- Here appears the full new text
N- Here appears the full new text
N- Here appears the full new text
N- Here appears the full new text
O- Here appears the full old text
O- Here appears the full old text
O- Here appears the full old text
==> No differences found with: Help for report
==> No differences found with: Help for JCL generation
**************************** Bottom of Data ****************************
Use the S line command to enter the report type dialog for the
selected source report type – the EDGPG200 panel is displayed.
Use the C line command to enter the report dialog for the compare
report definition – the EDGPG020 panel is displayed.
When you specify the U line command you can select which information
is used to update the report definition from the compare library with
selected information from the report type in the source library. The
updated report definitions are stored on the user library.
Panel Help
------------------------------------------------------------------------------
EDGPG432 DFSMSrmm Report Type Inheritance
Command ===>
Source report type . : EDGRVEXT Compare report definition . : AA1186
Enter "/" to select the values to be copied/inherited:
Report type level
Help for report type
Help for report
Help for JCL generation
Data type information
Macros, macro libraries and keywords
RDW setting
Record selection criteria
You can select to copy the report type level to the target report
definition so that you know that you have reviewed and applied all
the desired changes.
When you merge report types, DFSMSrmm copies all the report types
which are not in the user library from the Installation library to
the user library. DFSMSrmm never merges from the Product library.
Report types merged successfully from the Installation to User library
After you have completed the merge of report types, you can use
the new, merged report types in your installation library by copying
the member EDGGRTD from the user library to the installation library.