File-AID SMF Mapping facility Examples

The examples shown in this section illustrate some of the features of the File-AID SMF Mapping facility.

Example 1 - Browse Screen Entries

A sample of the Browse screen entries is shown in the following figure.

The Browse dataset is the name of the DASD file containing the SMF records you wish to examine.

All other dataset fields on the Browse screen refer to the XREF library created when the File-AID SMF Mapping facility was installed. The most common XREF member names to use are the special, all encompassing, XREF members:

  • Maps all *OFFLINE* record types:
  • Maps all *ONLINE* record types - SYS1.MANx: SLNALL.

Sample Browse Screen for SMF Mapping (Online Data)

image2022-2-10_10-48-37.png

Example 2 - Using Selection Criteria to Control Processing - Online Data

In this example File-AID “quick” (Selection criteria usage=Q) temporary unformatted selection criteria is specified to control the selection of records for accessing online data. This selection tells File-AID to select records with a decimal record type value of 4, 5, 20, 34, 35, or 40.

Notice that the SYS1.MANx data set represents online SMF records. IBM documented field offsets need to be translated to File-AID positions by using the following formula:

Online Position = (Offset of field in SMF manual plus 1)

Using the above formula, the SMFxxRTY (Record type) field is listed in the SMF manual as offset 5, so we would use a position of 6 for testing for online record types.

Select records that have a hex value in position 6 (record type) matching any of the following X'04', X'05', X'14', X'22', X'23', or X'28' (Unformatted Selection criteria line 1 entered as Position=6, RO=EQ, Data Value=X'04,05,14,22,23,28' (comma means OR in single quoted string)). Hex values correspond to decimal record type numbers (For example, X'28' = decimal 40).

Selecting Multiple Record Types (Online Data - Position 6)

image2022-2-10_10-50-13.png

Example 3 - Selecting Specific Records - Offline Data

In this example, File-AID “Quick” unformatted temporary selection criteria is again used to limit the selection of records to a specific record type and data content.

Notice that the SMF data is in a sequential file and represents offline SMF records. IBM documented field offsets need to be translated to File-AID positions by using the following formula:

Offline Location = (Offset of field in SMF manual minus 3)

Using the above formula, the SMFxxRTY (Record type) field is listed in the SMF manual as offset 5, so you would use a position of 2 for testing for a specific offline record type.

This selection tells File-AID to select Type 04 (Step termination) SMF records for JOB “JOBXXXXX”. (The JOB name is placed in the Type 04 record field SMF4JBN at offset 18 (decimal). Using our formula we can tell File-AID to match the JOB name at position 15.)

  • Make sure data file data set references offline SMF records on DASD.
  • Set “Record layout usage” to “S” (single).
  • Specify “Record layout Member” to “SMF004”.
  • Specify selection criteria usage = “Q” (Quick).
  • When the unformatted criteria screen is displayed, select records that have a hex value of X’04’ in location 2 (offline record type). (Selection line 1 entered as Position=2, RO=EQ, Data Value=X’04’).
  • AND only select these Type 04 records for processing if they are from JOB “JOBXXXXX”. (Selection line 2 entered as: AND Position=15, RO=EQ, Data Value=JOBXXXXX).

Selecting Type 04 (Offline - Step Termination) for JOBXXXXX

image2022-2-10_10-51-22.png

Example 4 - Formatted Display

This example shows a Formatted display of a Type 04 (Step Termination) record for JOBXXXXX for offline SMF data. Selection criteria is used as described in Example 3 - Selecting Specific Records - Offline Data.

Formatted Display of Selected Type 04 Record for JOBXXXXX

image2022-2-10_10-58-22.png

Formatted display profile commands are issued to tailor the presentation of information including:

  • ARRAY OFF
  • ALIGN OFF
  • GROUP OFF
  • SHOW NUMBER
  • SHOW OFFSET
  • OFFSET COLUMN.

To view the decimal value of the RECORD_TYPE field normally shown in hex, type the command:

DISPLAY 2 BIN (Display field number 2 in binary)

File-AID displays binary numbers normalized to their decimal value. To see the hex representation of a binary decimal value (or any field) type the command:

DISPLAY x HEX (Display field number "x" in hex)

File-AID defines and displays bit encoded fields as a string of 0’s and 1’s to enable bit decoding. To display any field in “bit” mode, type the command:

DISPLAY x BIT (Display field number "x" in bit mode)


The following f shows the List of Available Record Layouts displaying 01-Level layouts present in the PL/I layout member SMF004. To access this list, issue the USE primary command without specifying an 01-level copybook name.

List of Available Layouts - USE Command - SMF004 Member

image2022-2-10_10-59-44.png

Example 5 - File-AID/Batch FPRINT Execution

This example shows the JCL required to execute File-AID/Batch to selectively print a formatted report of the first 10 offline SMF type 14 (X’0E’) or 15 (X’0F’) records that contain the string “USER001” somewhere in the record (beyond byte 4).

File-AID/BATCH can process SMF data on tape. Complete documentation of JCL and control cards is provided in the File-AID/Batch Reference Manual.

File-AID/Batch FPRINT 10 SMF Records on Tape from USER001

image2022-2-10_11-1-25.png

The following list explains the JCL that is shown in the above figure:

  • DD01 DD - Identifies SMF data file
  • DD01RL DD - Identifies File-AID SMF Record Layout dataset containing PL/I record layouts.
  • DD01XR DD - Identifies File-AID SMF XREF dataset containing XREF member SLFALL (handles all record types)
  • SYSIN DD - Control card input follows:
    • $$DD01 - Directs processing to DD01 input file.
    • FPRINT - Identifies function as a formatted print.
    • RDW=3 - Parameter to ignore variable length record descriptor word (RDW). Location offsets will start at data byte 1.
    • SHOW=OFFSET - Parameter tells File-AID to show the relative offset of each SMF field formatted on the report.
    • IF=(2,EQ,X'0E,0F') - Syntax of IF parameter (from location, operator/length, data to search for), is a compare at data byte 2 for record types 14 or 15 (hex '0E’ or '0F'). Only type 14 and 15 records are considered for printing.
    • IF=(5,0,C’USER001') - Second IF parameter acts like an AND condition and performs a “scan” from location 5 to the end of the record (length=0). Only type 14 or 15 records that contain the string USER001 anywhere in the record will be printed.
    • OUT=10 - Parameter stops processing after 10 records are found and printed.

Related topics

Batch-reference


 

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