Using the SMF Record Mapping Facility

You can view SMF records online while they are still residing in the SYS1.MANx data sets, or offline after they are unloaded to a historical data set. If the SMF data at your site is being recorded in LOGSTREAMS, you will need to unload the records before you can browse them with File-AID/MVS. Use the File-AID Browse function (option 1) to interactively view SMF data records. Each record is shown formatted field by field with the data contents of each field normalized and presented according to the supplied PL/I layouts.

The only difference between online SMF records and unloaded offline SMF records is that 4 bytes in two 2-byte fields at the beginning of each record (SMFxxLEN - 2-byte binary record length, and SMFxxSEG - 2-byte binary segment descriptor) are present in the online records but not in the offline records. This means that the locations of online SMF fields versus offline SMF fields are different by 4 bytes. File-AID provides for these 4 bytes in the online SMF layouts, XREFs, and selection criteria (SxNxxxxx members) and not in the offline SMF layouts, XREFs and selection criteria (SxFxxxxx members). See Member Naming Convention  for more information on online versus offline SMF records.

Each SMF record has its own record type. SMF record types are usually referenced by their decimal record type value, but are selected and processed by File-AID using the hex record type value. For example, record type 30 (decimal) is hex value X’1E’. The record type value (SMFxxRTY field) is a one-byte binary value located at offset 5 (relative to 0) online or offset 1 offline. (Online offset 5 corresponds to File-AID actual location 6 when using File-AID’s Position field for selection criteria. Offline offset 1 is File-AID Position 2.)

This document provides record type information tables to assist you in using the mapping facility. Each table shows the SMF Record type decimal values, hex value, descriptions, notes flag, source layout member name, and any special XREF or selection criteria to use for viewing the record. The tables are:

• Offline SMF Record Mapping. MVS SMF Records— MVS Offline SMF Records Mapping.
• Online SMF Record Mapping. MVS SMF Records — MVS Online SMF Records Mapping.

The SMF Record Mapping facility automates the source layout presentation for each record type. However, some records are very complex and require interaction to finish formatting all data bytes. These manual interaction record types are noted in the tables and are fully documented in a later section of this reference. The USE, NEXT, and USE NEXT primary commands give you the ability to completely map most SMF records.

Use the IBM publication System Management Facilities (SMF) to fully interpret and decode all SMF record fields.

Mapping Procedure

The following procedure describes how to use the SMF record mapping facility:

1. Access File-AID.
2. Select option “1” - (Browse).
3. Set the “Browse mode” to “F” (Formatted).

4. Enter the name of the data set containing the SMF data to be viewed in the “Specify Browse Information” area.

   Note

   If you are selecting an online (SYS1.MANx) data set, be sure the data set you specify is currently active or contains SMF records.

5. Set the “Record layout usage” to “X” (XREF).
6. Enter the name of the installedhlq.SXVJSMFL library in the Record layout data set field.
7. Enter the name of the installedhlq.SXVJSMFX library in the following fields:
   • XREF dataset
   • Selection criteria DSN

8. In the “Xref member” field, enter the member name for the XREF member (“SLFALL” for offline SMF data mapping, “SLNALL” for online SMF data mapping, or leave member name blank for a list of members).

   Note

   When using the XREF members SLFALL or SLNALL, Compuware recommends a TSO region size of at least 4096KB (4MB).

9. Set the Selection criteria usage field to “N” to select all records. If you wish to select a subset of records, set the “Selection criteria usage” field to “Q” and see the examples shown in Selecting Multiple Record Types (Online Data - Position 6) - selecting record types, and Selecting Type 04 (Offline - Step Termination) for JOBXXXXX - selecting step termination (type 04) records for a specific JOB name)
10. Press Enter. (Sample Browse Screen for SMF Mapping (Online Data) shows the Browse panel entries)
    File-AID then presents a formatted display of the first record. See an example formatted display in Formatted Display of Selected Type 04 Record for JOBXXXXX.
11. Use the RIGHT or FWD (PF11) and LEFT or BACK (PF10) commands or PF keys to move from record to record.

12. Use DOWN (PF8) and UP (PF7) commands or PF keys to view additional layout fields not on the screen.

    Important

    You can use the FPRINT primary command to request a formatted printout of one or more of the SMF records currently selected. In addition, you can also use the File-AID/Batch FPRINT function to generate hardcopy formatted reports of selected SMF records on DASD or TAPE. See File-AID/Batch FPRINT 10 SMF Records on Tape from USER001 for an example File-AID/Batch FPRINT execution.

13. Be sure to read any notes for each record type if additional mapping is needed.