Maintaining Personal SMF Files

The SMF Files view is displayed when you select option 2 Maintain SMF Files from the System Definitions Menu. However, if you opted to bypass the menu and go straight to System Definitions, you can change from the Systems view by selecting View->Files in the action bar or by entering the VIEW FILES command.

The SMF Files panel is the primary panel for maintaining your file definitions. When the list of SMF Files is displayed:
Figure 1. System Definitions: Personal SMF Files
  File  Edit  Filter  View  Options  Help
------------------------------------------------------------------------------
                                    Personal SMF Files            Row 1 from 6
Command ===> ________________________________________________ Scroll ===> ____
 
Select to review the Systems that use the SMF data set.
 
/   Use              SMF Data Set Name                    UNIT +  SEQ VOLSER +
_   123  'CICSPAOR.CMF1'_______________________________  SYSALLDA 1__ 000010 +
_   745  'CICSPAOR.CMF2'_______________________________  3390____ ___ ______ 
_    12  'CICSPAOR.CMF3'_______________________________  ________ ___ ______ 
_     1  'CICSPTOR.CMF1'_______________________________  SYSALLDA 1__ 00110_ 
_     0  'CICSPTOR.CMF2'_______________________________  3390____ ___ ______ 
_    23  'CICSPTOR.CMF3'_______________________________  ________ ___ ______ 
********************************* End of list *********************************
 
  F1=Help      F3=Exit      F4=Prompt    F5=Rfind     F7=Backward  F8=Forward
 F10=Actions  F12=Cancel

This panel is used to maintain SMF data sets that you want to run your Report Sets against. The SMF data sets contain the CICS® Monitoring Facility (CMF) performance class, exception class, and transaction resource class data, DB2® accounting records, MQ accounting, and MVS™ System Logger records.

Through the related Systems (and their Groups), CICS PA uses the specified SMF data sets in the generation of Report Set JCL. The Use count shows the number of Systems that use this File. The count ignores Exclude indicators.

Enter the line action I to insert a new data set.

Enter the line action S against a data set to specify the Systems that use it.

Each listed data set has the following attributes:
Use
The File Use count. This indicates the number of Systems that use this File. The count ignores the Exclude indicator.
SMF Data Set Name
The name of an SMF data set containing data for
  • Report Set processing:
    • CMF performance class, exception class, and transaction resource class data (SMF 110 records)
    • DB2 accounting data (SMF 101 records)
    • WebSphere® MQ accounting data (SMF 116 records)
    • System Logger data (SMF 88 records)
    • OMEGAMON® XE for CICS (SMF 112 records)
  • Statistics reporting:
    • CICS statistics and server statistics data (SMF 110 records)
    • CICS Transaction Gateway statistics data (SMF 111 records)

Normal ISPF data set conventions apply. Fully qualified data set names must be enclosed in quotes, except if PROFILE NOPREFIX is set.

If the data set is not cataloged, then specify UNIT, SEQ, or VOLSER
UNIT

The generic or esoteric device type of the data set, such as 3390, SYSDA, or CART. This must represent a device type that is defined in the Eligible Device Table of the current processor as either TAPE or DASD. To select one from a list of possible Units, position the cursor on the UNIT field and press Prompt (F4). See Figure 1 for an example of the Unit selection list.

UNIT can be specified without a VOLSER, in which case CICS PA will use the explicitly specified device type when generating JCL but will not include the UNIT parameter in the generated JCL. In this way the JCL generation process can be made aware of the device type of a data set that is yet to be cataloged, or is cataloged on another system. CICS PA uses the device type to determine tape unit affinity when generating JCL.

SEQ

The File Sequence Number is only required for uncataloged tape data sets. It identifies the relative position of the data set on a tape volume. Omit, or code 0 or 1 to indicate the first data set on the tape volume.

VOLSER

The volume serial number of the data set. It is only required for uncataloged data sets. If a VOLSER is specified, then a UNIT must also be specified.

CICS PA appends a + sign to the VOLSER to indicate that the data set spans multiple volumes.

To display the VOLSER List of up to 16 volumes, do one of the following:
  • Enter the V line action.
  • Place the cursor on the + sign and press Enter.
  • Place the cursor on the VOLSER field and press Prompt (F4).
See Figure 1 for an example of the VOLSER List.
Line Actions: The following line actions are valid against any data set in the list:
Display the menu of line actions
S
Specify related Systems
I
Insert a blank row after this row to specify a new DSN
R
Repeat this row
C
Copy this row
M
Move this row
A
Move⁄Copy after this row
B
Move⁄Copy before this row
D
Delete this row
U
Select Unit from a list
V
Display the VOLSER List for up to 16 volumes
Note: A row command on this panel applies to the SMF File specification and all its associated information. For example, copying a row copies all details of the data set (name, unit, file sequence number, up to 16 volume serial numbers) and all its System relationships. Deleting a row deletes the SMF File specification and its System relationships, but not the Systems themselves.
Primary Commands: The following primary commands are available:
SAVE
This command saves any changes you have made during this invocation of System Definitions.

Also available from File in the action bar.

FIND string
This command (or F) looks for the specified character string in all columns of displayed data. The string need only be enclosed in quotes if there are embedded spaces. The search is not case sensitive. The display scrolls to the row where the string is found and positions the cursor on the matching data. To find more occurrences, use F5 or the RFIND command repeatedly.

If there is no match but the search did not begin at the top of the list, the screen does not change and the message *Bottom of data reached* is displayed. Use F5 or RFIND to search from the top.

If there is no match in the entire list, the screen does not change and a String not found message is displayed

Also available from Edit in the action bar

SORT DSN
This command sorts the list of Files on data set name. The order is retained on exit.

Also available from Edit in the action bar.

RESET
This command (or RES) removes all outstanding line actions and deletes any blank rows

Also available from Edit in the action bar.

VIEW SYSTEMS|GROUPS
This command takes you to the Systems or Groups view. Updates are saved when you change views.

Also available from View in the action bar.

MENU
This command takes you to the System Definitions Menu. Updates are saved.

Also available from View in the action bar.