Using the PERUSE utility


The PERUSE utility searches, examines, and prints records written by CMF, SMF, or RMF.

When you select P - PERUSE from the CMF Extractor Online Utilities menu, the menu shown in the following figure is displayed.

 --------------------- PERUSE AND PRINT CMF/SMF/RMF RECORDS --------------------
 COMMAND ===>
 Peruse current CMF (CPM or IPM) or SMF data set:
    DATA SET TYPE  ===> S      ( C - CPM, I - IPM, S -SMF data set)
                               ( NO or blank to peruse data set specified below)
    EXTRACTOR SEQ  ===> 1      (Change only if multiple Extractors are active;
                                use STATUS(S) to determine the sequence number)
    DISPLAY FORMAT ===> NEW    (OLD or NEW)
 Peruse other CMF or SMF data set:
    DATA SET NAME  ===>
    VOLUME SERIAL  ===>        (Required if data set not cataloged)
    DASD UNIT NAME ===>        (Required if not cataloged and not default unit)
 Set parameters for searching and printing:
    SEARCH LIMIT   ===> 500    (Maximum records to search per request)
    SYSOUT CLASS   ===> A      (For print option)
 To search for, peruse, and optionally print a record from a CMF or SMF data
 set, first enter the necessary information above.  Another panel will then
 appear; on it you can view the records and enter line commands to search for
 and print records.

When you have specified the data for the fields on the PERUSE menu, press Enter to display the PERUSE Output panel shown in Using-the-PERUSE-Output-panel.

Field descriptions for the PERUSE utility

The PERUSE Output fields are described in the following table.

Field name

Description

DATA SET TYPE

To search the current CMF or SMF data set, enter one of these codes:

  • S—searches the currently active SMF data set

    Note

    Searching SMF logstreams is not supported.

  • C—searches the CPM data set, if CMF MONITOR CPM mode is active
  • I—searches the IPM data set, if CMF MONITOR IPM mode is active
  • NO or blank—searches a data set specified in the DATA SET NAME field

DISPLAY FORMAT

This field allows you to display records in either the old or the new format. The new format contains an additional command, F, which allows you to find a triplet, EBCDIC, or hexadecimal string in the record.

EXTRACTOR SEQ

When multiple Extractors are running in your system, you can define the sequence number assigned to the Extractor that gathered the records you want to view. If you are unsure of the sequence number of the Extractor, use the STATUS option to determine the number. The sequence number of the Extractor coincides with the order in which its information is displayed on the STATUS panel.

DATA SET NAME

Define any variable-block data set containing CMF, SMF, or RMF records only when NO or blank appears in the DATA SET TYPE field.

Note

If you omit apostrophes, the data set name is prefixed with your TSO user ID.

VOLUME SERIAL

Required if the value in the DATA SET NAME field is not cataloged.

DASD UNIT NAME

If the value in the DATA SET NAME field is not cataloged and you do not give a DASD UNIT NAME value, CMF MONITOR automatically uses the default value specified in your TSO user ID profile.

SEARCH LIMIT

This field displays the maximum number of records PERUSE will search per request. The maximum number of records you can specify for a search request is 5000. The default number of records is 500.

A limit is useful when searching a large data set, which can take a great deal of time. This field allows you to control your search.

SYSOUT CLASS

This field specifies the JES output class used to print a snap dump image of a record, if one is requested. The default SYSOUT class is A.

Exiting the PERUSE utility

Press the End key to exit the PERUSE utility. You return to the CMF Extractor Online Utilities menu.



 

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