REPORT statement

Edit online

A REPORT statement can be specified following a PROC statement and a DATABASE statement.

Explicitly specified keyword values and default option values of a REPORT statement that follows a PROC statement specify the options for all databases to be processed.

Explicitly specified keyword values of a REPORT statement following a DATABASE statement override a previously specified option of a REPORT statement following a PROC statement. These override options affect only one database data set group in a DATABASE statement.

Subsections:

Syntax

The following syntax diagram shows the keywords for the REPORT statement.


1  REPORT + , %Optional
keyword
Optional keywords

1 RUNTM=
2.1! YES
2.1 NO
1 INTST=
2.1! YES
2.1 NO
1 BITMAP=
2.1! YES
2.1 NO
1 FSEMAP=
2.1! YES
2.1 NO
1 MAXFSD=
2.1! YES
2.1 NO
1 INTFS=
2.1! YES
2.1 NO
1 DBDIST=
2.1! YES
2.1 NO
1 CHAINDIST=
2.1! YES
2.1 NO
1 COMPFACT=
2.1! NO
2.1 YES
1 SEGIO=
2.1! NO
2.1 YES
1 DECODEDBD=
2.1! NO
2.1 YES
1 MAPDBD=
2.1! NO
2.1 YES

Keywords

The following keywords can be specified on the REPORT statement:

RUNTM=
Specifies whether to generate the separator page for DB/DSG reports. The separator page contains the runtime options used in the job.
This option can be specified when TYPE=ALL or SCAN is specified.
YES
The report is generated. RUNTM=YES is the default value.
NO
The report is not generated.
INTST=
Specifies whether to generate the Interval Statistics report for the HDAM, HIDAM, PHDAM, or PHIDAM database. The report is produced each time an interval is processed; the information in the report is added to the next report. That is, the N-th report provides the total information of the 1st-Nth reports.
This option can be specified when TYPE=ALL or SCAN is specified.
YES
The report is generated. INTST=YES is the default value.
NO
The report is not generated.
BITMAP=
Specifies whether to generate the Bit Map Display report for the HDAM, HIDAM, PHDAM, or PHIDAM database.
This option can be specified when TYPE=ALL or SCAN is specified.
YES
The report is generated. BITMAP=YES is the default value.
NO
The report is not generated.
FSEMAP=
Specifies whether to generate the Free Space Map report for the HDAM, HIDAM, PHDAM, or PHIDAM database.
This option can be specified when TYPE=ALL or SCAN is specified.
YES
The report is generated. FSEMAP=YES is the default value.
NO
The report is not generated.
MAXFSD=
Specifies whether to generate the Maximum Free Space Distribution report for the HDAM, HIDAM, PHDAM, or PHIDAM database.
This option can be specified when TYPE=ALL or SCAN is specified.
YES
The report is generated. MAXFSD=YES is the default value.
NO
The report is not generated.
INTFS=
Specifies whether to generate the Interval Free Space Summary report for the HDAM, HIDAM, PHDAM, or PHIDAM database. The report is produced each time an interval is processed and the information in the report is added to the next report. That is, the N-th report provides the total information of the 1st-Nth reports.
This option can be specified when TYPE=ALL or SCAN is specified.
YES
The report is generated. INTFS=YES is the default value.
NO
The report is not generated.
DBDIST=
Specifies whether to generate the DB Record Distribution Statistics report for the HDAM, HIDAM, PHDAM, or PHIDAM database.
This option can be specified when TYPE=ALL or SCAN is specified.
YES
The report is generated. DBDIST=YES is the default value.
NO
The report is not generated.
CHAINDIST=
Specifies whether to print the DISTRIBUTION OF RAP CHAIN LENGTHS part in the DB Record Distribution Statistics report.

This option can be specified when TYPE=ALL or SCAN is specified. It is printed for HDAM or PHDAM, and only for the data set group that contains root segments. This option is effective when REPORT DBDIST=YES is specified (default value of DBDIST is DBDIST=YES).

YES
The DISTRIBUTION OF RAP CHAIN LENGTHS is printed. CHAINDIST=YES is the default value.
NO
The DISTRIBUTION OF RAP CHAIN LENGTHS is not printed.
COMPFACT=
Specifies whether to print a compression factor in the VL SEGMENT LENGTH STATISTICS part of the Partition Statistics report and the Database Statistics report.
This option can be specified when TYPE=ALL or SCAN is specified.
YES
The compression factor is generated.
NO
The compression factor is not generated. COMPFACT=NO is the default value.

The compression factor is generated, not for every data set group, but for every database. If COMPFACT=YES and NO is specified for the same database in different DATABASE statements, YES is taken.

The compression factor is printed for HISAM, HDAM, HIDAM, PHDAM, and PHIDAM databases. If COMPFACT=YES is specified for other database organization types, it is ignored.

SEGIO=
Specifies whether to generate a RATE OF SEGMENT I/O OCCURRENCE part of the Partition Statistics report and the Database Statistics report.
This option can be specified when TYPE=ALL or SCAN is specified.
YES
The RATE OF SEGMENT I/O OCCURRENCE part is generated.
NO
The RATE OF SEGMENT I/O OCCURRENCE part is not generated. SEGIO=NO is the default value.

The RATE OF SEGMENT I/O OCCURRENCE part is generated, not for every data set group, but for every database. If SEGIO=YES and NO is specified for the same database in different DATABASE statements, YES is taken.

The RATE OF SEGMENT I/O OCCURRENCE part is generated for HDAM, HIDAM, PHDAM, and PHIDAM databases. If SEGIO=YES is specified for other database organization types, it is ignored.

DECODEDBD=
Specifies whether to print a DBD source code for each database processed by HD Pointer Checker. If you specify DECODEDBD=YES for the REPORT statement under the PROC statement, decoded DBDs are generated for all databases that are processed. If you specify DECODEDBD=YES for the REPORT statement under the DATABASE statement, a decoded DBD is generated for the specified database.

To use this function, you must install IMS Library Integrity Utilities 2.2 or later and specify its library in STEPLIB.

YES
The decoded DBD is generated in a report.
NO
The decoded DBD is not generated. DECODEDBD=NO is the default value.

If HD Pointer Checker runs in the DBB region, IMS Library Integrity Utilities obtains DBD information from IMS.ACBLIB specified in the IMSACB DD statement. If the IMS management of ACBs is enabled, IMS Library Integrity Utilities obtains DBD information from IMS directory data sets.

MAPDBD=
Specifies whether to print a DBD map to a report for each database processed by HD Pointer Checker. To use this function, you must install IMS Library Integrity Utilities and specify its library in STEPLIB.
YES
DBD map is generated in a report.

If the IMS management of ACBs is enabled, HD Pointer Checker ignores MAPDBD=YES and applies MAPDBD=NO.

NO
DBD map is not generated. MAPDBD=NO is the default value.

If HD Pointer Checker runs in a DBB region, IMS Library Integrity Utilities obtains DBD information from IMS.ACBLIB specified in the IMSACB DD statement.