Skip to Content

REPORTS

For each DBD validated, 

Pointer Checker

 can generate several optional reports in addition to its standard reports.

Use the REPORTS option to control the production of these optional reports. Directory-of-reports identifies the standard and optional reports.

You can specify the REPORTS option on both the GLBL and CHECK control statements. If you specify the REPORTS option on the GLBL control statement, its values apply to all DBDs being validated. The REPORTS option values on the CHECK control statement apply only to the specified DBD and override the values specified on the GLBL control statement.

Warning

Note

REPORTS(ALL) must be specified in PCPSYSIN or PLUSIN to generate reports for HALDBs.

Uses

You can set the REPORTS option at the following levels:

  • Global options module
  • DBD options member
  • Generated JCL
  • GLBL control statement
  • CHECK control statement

ISPF panel field

Reports

  • Optional Reports
  • I/O Probability Statistics
  • HDAM Root Placement Relative to Home Block
    • If Yes, Backward Distance from Home Block
    • Forward Distance from Home Block
  • HDAM RAP Chain Length Distribution
  • Detail Listing of VL Segment Sizes
  • Detail Listing of FSE Sizes
  • Bitmap

PCPSYSIN keyword

REPORTS(ALL)

REPORTS(NONE)

REPORTS(keyword(value) keyword(value)… keyword(value))

Values

Specify ALL or NONE, or specify one or more of the individual report keywords and values:

  • ALL

    Create all of the optional reports.

  • NONE

    Create none of the optional reports.

  • BITMAP

    Specify one of the following values to control the production of the Bitmap detail report. For more information about this report, see Bitmap-Detail-report.

    • YES or Y

      Produce the report.

    • NO or N

      Do not produce the report.

  • FSEDIST

    Specify one of the following values to control the production of the Distribution of Free Space Element Sizes report. For more information about this report, see Distribution-of-Free-Space-Element-Sizes-report.

    • YES or Y

      Produce the report.

    • NO or N

      Do not produce the report.

    For HALDBs, the Distribution of Free Space Element Sizes report information is combined with the Summary of Free Space Element Sizes report. The FSEDIST option is not valid for HALDBs.

  • IOSTATSSpecify one of the following values to control the production of the Segment I/O Requirements Matrix report. For more information about this report, see Segment-I-O-Requirements-Matrix-report.

    • YES or Y

      Produce the report.

    • NO or N

      Do not produce the report.

  • RAPCHAIN

    Specify one of the following values to control the production of the Distribution of HDAM RAP Chain Lengths report. For more information about this report, see Distribution-of-HDAM-RAP-Chain-Lengths-report.

    • YES or Y

      Produce the report.

    • NO or N

      Do not produce the report.

  • ROOTDIST

    Specify the forward and backward ranges of blocks that Pointer Checker uses when creating the HDAM Root Placement Relative to Its Home Block report.

    For full-function databases, code the ranges as follows:

    (-nnn+mmm)

    where nnn is the forward range, and mmm is the backward range. Valid values for both ranges are 0-999. Specify 0 for both ranges to bypass generation of this report. To generate this report, Pointer Checker requires access to the HDAM randomizer. Therefore, the library containing the load module must be available. For more information about this report, see HDAM-Root-Placement-Relative-to-Its-Home-Block-report.

    For HALDBs, specify ROOTDIST(Y) to generate the HDAM Root Placement Relative to Its Home Block report. If you do not want to generate the report, specify ROOTDIST(N). For HALDBs, the (-nn,+nn) syntax is not valid.

  • VLSDIST

    Specify one of the following values to control the production of the Distribution of VL Segment Sizes report. For more information about this report, see Distribution-of-VL-Segment-Sizes-report.

    • YES or Y

      Produce the report.

    • NO or N

      Do not produce the report.

    For HALDBs, the Distribution of Free Space Element Sizes report information is combined with the Summary of Free Space Element Sizes report. The VLSDIST option is not valid for HALDBs.

Default

BITMAP(N)

IOSTATS(Y)

FSEDIST(N)

RAPCHAIN(N)

ROOTDIST(-0+0)

ROOTDIST(N) for HALDBs

VLSDIST(N)

Examples

The following example tells Pointer Checker to generate and print the HDAM Root Placement, RAP Chain Length, and Detailed FSE Size reports, in addition to the standard reports it creates.

REPORTS(ROOTDIST(-10+10),RAPCHAIN(Y),FSEDIST(Y))

The following example tells Pointer Checker to create all of the optional reports for all of the input databases except for HDAM01; the Detailed VL Segment Size Distribution and Detailed FSE Size reports are bypassed for HDAM01.

GLBL REPORTS(ALL)
CHECK DBD(HIDAM01)
CHECK DBD(HISAM01)
CHECK DBD(HDAM01) REPORTS(VLSDIST(N) FSEDIST(N))

Related topic

Summary-of-the-options



 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Pointer Checker for IMS 5.1