Compare IODFs or CSS/OS Reports
This utility function allows you to compare two IODFs and report
the differences. You can compare the IODFs from the CSS, OS, and
switch perspective.
In addition, you can limit the CSS, OS, and switch perspective
by single compare reports, and the CSS perspective by LPARs.
You have to allocate the new IODF with DD name HCDIODFS, and the
old IODF with DD name HCDIODFT for comparing IODFs. If you compare
the CSS to the OS definition, you always compare within one IODF that
must be allocated to HCDIODFS.
You invoke this function by passing the following parameter string.
Note:
This parameter string must not exceed 100 characters.
Compare IODFS or CSS/OS
Reports
 |--COMPARE--,--------------------------------------------------->
>--+-| Print Options for IODF Compare Report |---+--------------|
'-| Print Options for CSS/OS Compare Report |-'
Print Options for IODF Compare Report:
|--+-----------+------------------------------------------------>
| .-------. |
| V | |
'---+-A-+-+-'
+-B-+
+-C-+
'-D-'
.--------------------------------------------------------------------------------------------------.
| .--------. |
V V | |
>----+-,--CL--,----+-PR-+-+--,--+-,--,--,---------------------------------------------------------+-+-+--|
| +-CF-+ '-procid1--+-,--+--------+----+--,--procid2--+-,--+--------+----+-' |
| +-CS-+ | '-partn1-' | | '-partn2-' | |
| +-PA-+ '-+-(#cssid1)--,-+-' '-+-(#cssid2)--,-+-' |
| +-CP-+ '-.cssid1--,---' '-.cssid2--,---' |
| +-CA-+ |
| +-DA-+ |
| +-CU-+ |
| '-DV-' |
+-,--C--,--+-,---------------------------------------------------------+-----------------------+
| '-procid1----+-(#cssid1)-+----,--procid2----+-(#cssid2)-+---' |
| '-.cssid1---' '-.cssid2---' |
| .--------. |
| V | |
+-,--OL--,----+-OS-+-+--,--+-,---------------+-------------------------------------------------+
| +-ED-+ '-osid1--,--osid2-' |
| +-GE-+ |
| +-GU-+ |
| +-ES-+ |
| +-NI-+ |
| '-OD-' |
+-,--O--,--+-,---------------+-----------------------------------------------------------------+
| '-osid1--,--osid2-' |
| .--------. |
| V | |
+-,--SL--,----+-SW-+-+--,--+-,---------------+-------------------------------------------------+
| +-PO-+ '-swid1--,--swid2-' |
| +-SC-+ |
| '-PC-' |
'-,--S--,--+-,---------------+-----------------------------------------------------------------'
'-swid1--,--swid2-'
Print Options for CSS/OS Compare Report:
|--+-------+--,--D--,--procid--,--+------------+--,--osid-------|
'---C---' | (1) |
'-partn------'
Notes:
- Required if processor runs in LPAR mode.
- Print options for IODF Compare Report
- Specify one or more of the following print options, without
separating characters, in exactly this order. For more information
about the print option types, see How to print a Compare IODFs Report.
- A
- Print added data
- B
- Print deleted data
- C
- Print unchanged data
- D
- Print unchanged item IDs
- CL | C | OL | O | SL | S
- Type of the report. Specify one or more of the following codes
in any order, with no separating characters:
- CL
- Limit the CSS compare report by single compare reports and LPARs
-
- PR
- Processor compare
- CF
- PCIe Function compare
- CS
- Channel subsystem compare
- PA
- Partition compare
- CP
- Channel path compare
- CA
- Control unit attachment compare
- DA
- Device attachment compare
- CU
- Control unit compare
- DV
- Device compare
- procid1
- New processor ID
- partn1
- Partition name of the new processor
- cssid1
- selected CSS ID of the new XMP processor, either appended
by a # and in parenthesis or appended by a dot (.). If the CSS ID
is specified for one processor only (old or new), the CSS ID for the
other processor is defaulted to CSS ID 0.
- procid2
- Old processor ID
- partn2
- Partition name of the old processor
- cssid2
- selected CSS ID of the old XMP processor, either appended
by a # and in parenthesis or appended by a dot (.)
- C
- Indicates CSS compare report
- procid1
- New processor ID
- cssid1
- selected CSS ID of the new XMP processor, either appended by a #
and in parenthesis or appended by a dot (.). If the CSS ID is specified
for one processor only (old or new), the CSS ID for the other processor
is defaulted to CSS ID 0.
- procid2
- Old processor ID
- cssid2
- selected CSS ID of the old XMP processor, either appended by a #
and in parenthesis or appended by a dot (.)
- OL
- Limit OS compare report by single compare reports
-
- OS
- Operating system compare
- ED
- EDT compare
- GE
- Generic compare
- GU
- Generic update compare
- ES
- Esoteric compare
- NI
- OS console compare
- OD
- OS device compare
- osid1
- New operating system ID
- osid2
- Old operating system ID
- O
- Indicates OS compare report
- osid1
- New operating system ID
- osid2
- Old operating system ID
- SL
- Limit switch compare report by single compare reports
-
- SW
- Switch compare
- PO
- Switch port compare
- SC
- Switch configuration compare
- PC
- Port configuration compare
- swid1
- New switch ID
- swid2
- Old switch ID
- S
- Indicates SWITCH compare report
- swid1
- New switch ID
- swid2
- Old switch ID
- Print options for CSS/OS Compare Report
-
- C
- Print all devices. If C is not selected, only devices are printed
that are
- Defined for the CSS, but not for the OS
- Defined for the OS, but not for the CSS
- Defined for both, but of different device type
- D
- Indicates CSS/OS compare
- procid
- Processor ID
- partn
- Partition name. This is a required parameter, if the processor
runs in LPAR mode. For more information, see Compare CSS / operating system views.
- osid
- Operating system ID
Batch invocation
A data set must be allocated to the following DD names when invoking
the batch utility.
| DD name | Description |
|---|
| STEPLIB | SYS1.SCBDHENU (required for OS device compare) | | HCDIODFS | New IODF | | HCDIODFT | Old IODF (only for IODF compare) | | HCDMLOG | HCD Message Log data set | | HCDRPT | Report data set; record size 133, record format fixed block | | HCDTRACE | Trace data set (if trace is activated) |
Example 1:
The following example shows a job to compare
two IODFs.
//BWINJOB JOB (3259,RZ-28),'BWIN',NOTIFY=BWIN,CLASS=A,
// MSGCLASS=Q,MSGLEVEL=(1,1),REGION=4M
//*
//* COMPARE IODFs WITH ADDED AND DELETED DATA
//* DEVICE, DEVICE ATTACHMENT AND OS DEVICE COMPARE
//* LIMITED TO LPAR PROC2.LPAR1 ON BOTH AND OS PROD17
//*
//COMPARE1 EXEC PGM=CBDMGHCP,
// PARM='COMPARE,AB,CL,DVDA,PROC2,LPAR1,PROC2,LPAR1,
// OL,PROD17,PROD17'
//STEPLIB DD DSN=SYS1.SCBDHENU,DISP=SHR
//HCDIODFS DD DSN=BWIN.IODF06.WORK,DISP=SHR
//HCDIODFT DD DSN=BWIN.IODF03,DISP=SHR
//HCDRPT DD SYSOUT=*,DCB=(RECFM=FBA,LRECL=133,BLKSIZE=6650)
//HCDMLOG DD DSN=BWIN.HCD.LOG,DISP=OLD
//
Example 2:
The following example shows a job to compare
CSS/OS reports.
//BWINJOB JOB (3259,RZ-28),'BWIN',NOTIFY=BWIN,CLASS=A,
// MSGCLASS=Q,MSGLEVEL=(1,1),REGION=4M
//*
//* COMPARE CSS/OS CONFIGURATION BETWEEN
//* DEVICES CONNECTED TO PROC1, PART1 ON CSS SIDE
//* DEFINED TO OS MVS1
//*
//COMPARE2 EXEC PGM=CBDMGHCP,
// PARM='COMPARE,AB,D,PROC1,PART1,MVS1'
//HCDIODFS DD DSN=BWIN.IODF06.WORK,DISP=SHR
//HCDRPT DD SYSOUT=*,DCB=(RECFM=FBA,LRECL=133,BLKSIZE=6650)
//HCDMLOG DD DSN=BWIN.HCD.LOG,DISP=OLD
//
|
z/OS HCD User's Guide
Copyright IBM Corporation 1990, 2014