PCA$HELP.HLB  —  FIND
    Analyzer Command

    Finds and displays the page of PLOT or TABULATE output that
    contains the histogram bar or table entry for a specified label
    or line number.

    Format

      FIND  [label-name]

1  –  Parameters

 label-name

    Specifies a label, or bucket name, associated with a histogram
    bar or table entry. The FIND command displays the first histogram
    or table page that contains this label. If the label is a line
    number, it must be specified as %LINE n, where n is the line
    number. Asterisks in the label-name are treated as wildcard
    characters. An asterisk (*) matches zero or more characters in
    a bucket name. If the label-name parameter is omitted, the next
    occurrence of the last label-name specified is displayed.

2  –  Description

    The FIND Analyzer command finds the first page of histogram or
    table output that contains a specified label and displays that
    page on the terminal. Thus, it is useful for quickly finding
    specific bucket names in long histograms or tables.

3  –  Examples

  PCAA> PLOT PROGRAM BY ROUTINE
  PCAA> FIND OUTPUT_TO_DATAFILE

      A histogram is generated by the PLOT command. Each bucket in
      the histogram corresponds to one routine in the program. The
      FIND command displays the histogram page that contains the
      histogram bar for routine OUTPUT_TO_DATAFILE.

  PCAA> PLOT PROGRAM BY ROUTINE
  PCAA> FIND PRIM*
  PCAA> FIND

      A histogram is generated by the PLOT command. The FIND command
      displays the first histogram page that contains a routine name
      that begins with PRIM. The second FIND command finds the next
      occurrence of such a routine name.

  PCAA> TABULATE ROUTINE PRIM_NUM_GEN BY LINE
  PCAA> FIND %LINE 1024

      A table is generated by the TABULATE command. The page that
      contains the table entry for line 1024 is displayed by the FIND
      command.
Close Help