Optional Parameters
- COMPAREDD(ddname [ ddname...])|
- COMPAREDS(dsname [ dsname...])]
- indicates which data sets are to be checked to confirm that they
point to the BCS or VVDS being diagnosed. Because a VVDS must be referenced
by its volume serial number and unit, use COMPAREDD to specify a VVDS.
A BCS can be specified by either COMPAREDD or COMPAREDS. For diagnosis
of a BCS, the compare parameters identify VVDS names (you can specify
a maximum of 99 names). When diagnosing a VVDS, these parameters identify
appropriate BCS data sets. If COMPAREDS or COMPAREDD are specified for the catalog whose name is indicated by the VVDS entry, the catalog should have:
- A non-VSAM record corresponding to the NVR, or a cluster record corresponding with the data or index VVR.
- The same storage class, data class, and management class names in the corresponding non-VSAM or cluster record.
If you are authorized to the RACF® FACILITY class name of STGADMIN.IDC.DIAGNOSE.VVDS, you are allowed to open a catalog without performing normal catalog security processing. If you are authorized to this FACILITY class name, normal RACF checking is bypassed. If you try to open a catalog and you are not authorized to this FACILITY class name, message IDC2918I is issued, processing continues, and normal RACF checking takes place.- COMPAREDD(ddname[ ddname ...])
- indicates
the ddnames of the specific data sets to be checked.
Abbreviation: CMPRDD
- COMPAREDS(dsname [ dsname...])
- indicates
the names of the data sets to be checked.
Abbreviation: CMPRDS
- DUMP|NODUMP
- specifies whether entry hexadecimal dumps are to be provided for
compare errors.
- DUMP
- indicates that entry hexadecimal dumps are to be provided for compare errors. This results in message IDC21365I followed by a display of a record or records.
- NODUMP
- indicates that no dump is to be provided.
- ERRORLIMIT(value)
- specifies
a modification of the default error limit. Designed to prevent runaway
output, ERRORLIMIT defaults to 16, but any number from 0 to 2 147
483 647 can be specified. During DIAGNOSE, each incorrect entry contributes
to the error count used against ERRORLIMIT. When ERRORLIMIT is reached,
message IDC31370I is printed and analysis of the source data set is
ended.
Abbreviation: ELIMIT
- EXCLUDE({ENTRIES(entryname[ entryname...])|
- CATALOG(catalogname[ catalogname...])| LEVEL(level)})
- specifies
that entries is excluded from the scan. INCLUDE and EXCLUDE are mutually
exclusive parameters. If omitted, the entire data set is processed.
See z/OS DFSMS Managing Catalogs for
more information on the effect of specifying INCLUDE and EXCLUDE with
the DIAGNOSE commands. Abbreviation: EXCL
- ENTRIES(entryname[ entryname...])
- specifies that the entries listed is excluded from the scan. Up
to 255 entrynames can be coded.
Abbreviation: ENT
- CATALOG(catalogname [ catalogname...])
- specifies
that entries that refer to the named catalog are not scanned. Up to
99 catalog names can be coded. CATALOG can only be coded for DIAGNOSE
VVDS.
Abbreviation: CAT
- LEVEL(level)
- specifies
the high-level qualifiers for entrynames. Only entries with the high-level
qualifier specified is excluded from the scan. One level name can
be coded.
Abbreviation: LVL
- INCLUDE({ENTRIES(entryname[ entryname...])|
- CATALOG(catalogname[ catalogname...])| LEVEL(level)})
- specifies
what information is included in the scan. INCLUDE and EXCLUDE are
mutually exclusive parameters. If omitted, the entire data set is
processed. See z/OS DFSMS Managing Catalogs for
more information on the effect of specifying INCLUDE and EXCLUDE with
the DIAGNOSE commands. Abbreviation: INCL
- ENTRIES(entryname [ entryname...])
- specifies
that only the entries listed are scanned. Up to 255 entrynames can
be coded.
Abbreviation: ENT
- CATALOG(catalogname [ catalogname...])
- specifies
that only entries that refer to the named catalog are scanned. CATALOG
can only be coded for DIAGNOSE VVDS.
Abbreviation: CAT
- LEVEL(level)
- specifies
the high-level qualifiers for entrynames. Only entries with the specified
high-level qualifier are scanned. One level name can be coded.
Abbreviation: LVL
- LIST|NOLIST
- specifies whether entries that have no errors are to be listed.
- LIST
- indicates the entries that have no errors are to be listed in addition to entries that have errors. This results in message IDC01360I, followed by a list of entrynames.
- NOLIST
- indicates
that only entries with errors are listed.
Abbreviation: NLST
- OUTFILE(ddname)
- specifies
a data set, other than the SYSPRINT data set, to receive the output
produced by DIAGNOSE (that is, the output resulting from the scan
operation).
ddname identifies a DD statement that describes the alternate target data set. If OUTFILE is not specified, the output is listed in the SYSPRINT data set. If an alternate data set is specified, it must meet the requirements shown in JCL DD Statement for an Alternate Target Data Set.
Abbreviation: OFILE