z/OS HCD User's Guide
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF


Compare IODFs

z/OS HCD User's Guide
SC34-2669-00

Compare IODFs

You can use the Compare IODFs function to compare two IODFs and report the differences between them. For greater clarity, you can limit the compare reports to certain perspectives of the IODF:

  • The Processor Compare Report shows differences in the properties of channel subsystems, partitions, CHPIDs, control units, and devices.
  • The Switch Compare Report shows differences in the properties of switches and switch configurations.
  • The OS Configuration Compare Report shows differences in device parameters, in features, in EDTs, in esoterics, in generics defined for EDTs, and consoles.

To compare IODFs, do the following:

  1. Select Print or compare configuration data on the Primary Task Selection panel.
  2. On the Print or Compare Configuration Data panel, select Compare IODFs. The following panel is displayed:
    Figure 116. Compare IODFs
    *------------------------------- Compare IODFs -------------------------------*
    |                                                                             |
    | Select the compare reports you want, and specify the following values.      |
    |                                                                             |
    | New IODF name : 'DOCU.IODF01'                                               |
    | Old IODF name . ___________________________________  +                      |
    |                                                                             |
    | Select compare reports                   Limit ?                            |
    |              _  Processor                  _  Yes                           |
    |              _  Switch                     _  Yes                           |
    |              _  Operating system           _  Yes                           |
    |                                                                             |
    | Job statement information                                                   |
    | //         JOB (ACCOUNT),'NAME'                                             |
    | //*                                                                         |
    | //*                                                                         |
    | //*                                                                         |
    | //*                                                                         |
    | //*                                                                         |
    |                                                                             |
    |  F1=Help     F2=Split  F3=Exit  F4=Prompt   F5=Reset    F9=Swap             |
    | F12=Cancel                                                                  |
    *-----------------------------------------------------------------------------*

    On this panel, select one or more compare report(s). In addition, you can set the limit option. When the limit option is set, the related limiting panels will come up.

    On the Limit Processor Compare Reports panel, you can limit the processor compare reports by selecting one or more of the specific compare reports. You can limit the reports by specifying values for a processor or either by specifying values for a channel subsystem or a partition. It is possible to compare an SMP processor to a channel subsystem of an XMP processor. If you want to limit by processor, you must specify the processor IDs for both IODFs. If you limit the processor compare report by partition name, you receive the following results:

    • The report will contain the channel subsystem in which the partition is defined.
    • Channel path compare will only contain channel paths which have the limiting partition in their access or candidate list.
    • Control unit compare will only include the control units related to channel paths which have the limiting partition in their access or candidate list.
    • Device compare will only include the devices connected via channel paths which have the limiting partition in their access or candidate list.

    Figure 117. Limit Processor Compare Reports
    *-------------- Limit Processor Compare Reports --------------*
    |                                                             |
    | Select one or more of the processor compare reports.        |
    |                                                             |
    |  _  Processor Compare                                       |
    |  _  Channel Subsystem Compare                               |
    |  _  PCIe Function Compare                                   |
    |  _  Partition Compare                                       |
    |  _  Channel Path Compare                                    |
    |  _  Control Unit Attachment Compare                         |
    |  _  Device Attachment Compare                               |
    |  _  Control Unit Compare                                    |
    |  _  Device Compare                                          |
    |                                                             |
    | To limit the reports, specify the following values.         |
    |                                                             |
    |                          New IODF          Old IODF         |
    | Processor ID . . . . . . ________  +       ________  +      |
    | Channel Subsystem ID     _  +              _  +             |
    | Partition name . . . . . ________  +       ________  +      |
    |                                                             |
    |  F1=Help     F2=Split    F3=Exit     F4=Prompt   F5=Reset   |
    |  F9=Swap    F12=Cancel                                      |
    *-------------------------------------------------------------*

    On the Limit Switch Compare Reports panel, you can limit the switch compare reports by one or more of the specific compare reports. In addition, you can limit the reports by specifying a switch ID for both, the new and the old IODF.

    Figure 118. Limit Switch Compare Reports
    *--------------- Limit Switch Compare Reports ---------------*
    |                                                            |
    |                                                            |
    | Select one or more of the switch compare reports.          |
    |                                                            |
    | _  Switch Compare                                          |
    | _  Switch Port Compare                                     |
    | _  Switch Configuration Compare                            |
    | _  Port Configuration Compare                              |
    |                                                            |
    | To limit the report, specify the following values:         |
    |                                                            |
    |                  New IODF        Old IODF                  |
    | Switch ID  . . . __  +           __  +                     |
    |                                                            |
    |  F1=Help     F2=Split    F3=Exit     F4=Prompt   F5=Reset  |
    |  F9=Swap    F12=Cancel                                     |
    *------------------------------------------------------------*

    On the Limit Operating System Compare Reports panel, you can limit the operating system compare reports by one or more of the specific compare reports. In addition, you can limit the reports by specifying an operating system ID for both, the new and the old IODF.

    Figure 119. Limit Operating System Compare Reports
    *----------- Limit Operating Systems Compare Reports -----------*
    |                                                               |
    |                                                               |
    | Select one or more of the operating system compare reports.   |
    |                                                               |
    | _  Operating Systems Compare                                  |
    | _  EDT Compare                                                |
    | _  Generic Compare                                            |
    | _  Generic Update Compare                                     |
    | _  Esoteric Compare                                           |
    | _  OS Console Compare                                         |
    | _  OS Device Compare                                          |
    |                                                               |
    | To limit the report, specify the following values:            |
    |                                                               |
    |                          New IODF          Old IODF           |
    | Operating system ID  . . ________  +       ________  +        |
    |                                                               |
    |                                                               |
    |  F1=Help     F2=Split    F3=Exit     F4=Prompt   F5=Reset     |
    |  F9=Swap    F12=Cancel                                        |
    *---------------------------------------------------------------*

How to print a Compare IODFs Report

After you have selected the specific pairs for the compare reports, you can decide what print options to use. The print options are shown on the Select Print Options panel, see Figure 120.

If you do not select an option (by only pressing the Enter key), the default print options are used (Print inserted data, and Print deleted data).

Examples of these reports are shown in Appendix B. Configuration reports.

Figure 120. Select Print Options (for Compare IODFs only)
*---------- Select Print Options ----------*
|                                          |
|                                          |
| Select one or more of the following      |
| options, or ENTER to use the defaults.   |
|                                          |
| /  Print inserted data                   |
| /  Print deleted data                    |
| _  Print unchanged data                  |
| _  Print unchanged item IDs              |
|                                          |
|  F1=Help       F2=Split      F3=Exit     |
|  F5=Reset      F9=Swap      F12=Cancel   |
*------------------------------------------*

When you do not select any option, HCD prints a report of

  • IDs of added or deleted objects, and those objects, that have added or deleted relations
  • IDs of added relations
  • Attributes of objects that are different in both IODFs

When you select the Print inserted data option, HCD prints a report of all attributes, and relations of added objects.

When you select the Print deleted data option, HCD prints a report of all attributes, and relations of deleted objects.

When you select the Print unchanged data option, HCD prints a report of all attributes, and relations of unchanged objects.

When you select the Print unchanged item IDs option, HCD prints a report of the IDs of unchanged objects. But this applies only, if the Print unchanged data option is not selected.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014