View 2. Cyclic SMF Files

The second view displays Cyclic SMF File definitions.

Cyclic SMF files are the definitions of SMF Files that cover a continuously recurring period of time, and consistently contain data for this system.

Cyclic SMF files are typically GDGs. For example, a weekly SMF GDG where the most recent cycle (generation 0) spans the current week, -1 is last week, and so on.

You specify one or more Cyclic SMF file definitions that match the way you collect and manage long-term SMF data at your installation. CICS PA supports the many ways you can setup your SMF environment, including daily, weekly, monthly, yearly and fixed (number of days) cycles.

The Cyclic SMF File definitions are used at report request time. Cyclic SMF Files are automatically inserted into your Report request JCL when you request reporting for a time period that is spanned by an active generation of a cycle, and Shared System Definitions are active (not Personal. Refer to Systems in the action bar when submitting a Report request).

For systems that share SMF Files, it is recommended that Cyclic SMF Files be defined to the associated MVS™ Image (rather than each System repetitively). CICS PA will detect this and use the SMF Files defined to the Image.

Figure 1. Shared CICS System Cyclic SMF Files
  File  Edit  Options  Help                                                    
-------------------------------------------------------------------------------
EDIT                            CICS System               Row 1 of 1 More: < > 
Command ===> ________________________________________________ Scroll ===> PAGE 
                                                                          
CICS System definition:                                                   
 APPLID  . . . . . . . . DYNAMIC_  MVS Image . . . ________               
 Description . . . . . . ** New CICS system **_______________             
                                                                          
System View:                                                              
 2  1. Definition   2. Cyclic SMF Files   3. Daily SMF Files       
                                                                          
/ Exc Cyclic SMF File GDG Base or Data Set Name       Origin     Interval DISP
_     ______________________________________________  __________ _____    ___  
******************************* Bottom of data ********************************
                                                                               
                                                                               
 F1=Help      F3=Exit      F5=Rfind     F7=Backward  F8=Forward  F10=Prev      
F11=Next     F12=Cancel                                                        
The Cyclic File details are:
Cyclic SMF File GDG Base or Data Set Name
The SMF File GDG Base name, or the SMF File data set name. For example:
'SMF.MVS1.DAILY'
'CICSPROD.SMF.WEEKLY'

You can use the following symbolic variables in an SMF File data set name:

&YYYY
4-digit year
&YY
2-digit year (20yy)
&MM
Month (01–12)
&DD
Day of the month (01–31)
&DDD
Day of the year (001–366)

For example:

'CICSPROD.SMF.D&YY&MM&DD'
'CICSPROD.SMF.D&YY.&MM.&DD'

You can optionally terminate a variable name with a period. This period will not appear in the resolved data set name (the two examples above resolve to the same name). If you want a period to appear after a variable value in the resolved name, insert a second period:

'CICSPROD.SMF.Y&YYYY..D&DDD'

If you use symbolic variables:

  • In the Origin field, use asterisks to represent the digits of the origin date that are determined by symbolic variables.
  • The origin date and the interval must be compatible with the symbolic variables. For example, if you use the variable &DDD, then the origin date must be in Julian format.
Origin
The starting point of each new interval, defining the point in time when the SMF file was created. Origin can be:
Day
A new cycle starts every day, defining a daily cycle.
Day of the week
A new cycle starts on the specified day, defining the start of a weekly cycle. Allowed values are the seven days of the week: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Date
The first cycle starts on the specified date, and continues cycling forwards from that point in time. Cycles that commence on a date are monthly, yearly or fixed number of days cycles.
If the SMF data set name does not include symbolic variables, then the allowed values are:
  • yyyy-mm-dd
  • ****-mm-dd
  • yyyy-ddd
  • ****-ddd
where **** specifies the current year, indicating that the cycle restarts from this point every year.

If the SMF data set name includes symbolic variables, then there are many more allowed values: you use asterisks in the origin value to match the symbolic variables in the data set name. For some examples, see How CICS PA selects cyclic SMF files for reporting.

CDATE
A new cycle starts on the file creation date. The SMF file contains data starting from the date the file was created.
Note: If you specify CDATE, CDATE+nnn, or CDATE-nnn, and the value resolves to a date earlier than 2000/01/01 (January 1, 2000), then the date is treated as if you had specified 2000/01/01.
CDATE+nnn
A new cycle starts nnn number of days after the file creation date. That is, the SMF file contains data starting nnn number of days after the file was created. For example, CDATE+1 specifies a file that is created before midnight to contain tomorrow's data.
CDATE-nnn
A new cycle starts nnn number of days before the file creation date. That is, the SMF file contains data starting nnn number of days before the file was created. For example, CDATE-5 specifies a file that is created and then filled with data starting from five days ago.
NONE
No origin. Specify NONE when you want to explicitly select a particular SMF file for ad-hoc reporting, rather than CICS® PA selecting appropriate SMF files for a requested reporting period. You cannot report on a mix of files with and without origins. If a system contains cyclic SMF file definitions with an origin of NONE and cyclic SMF file definitions with other origin values, then you must either exclude the files with an origin of NONE, or exclude all of the others.
Interval
The time duration of one cycle of data. Interval can be a number of days (0 indicating an indefinite interval) or DAY, WEEK, MONTH, YEAR.
The allowed interval values depend on the Origin specification:
Origin
Interval
DAY
1 (day)
Day of the week
WEEK
Date
All allowed values
DISP
Specifies whether the SMF file accumulates (DISP=MOD) data or does not accumulate (DISP=OLD) data over the interval.
DISP=MOD
New cycles commence at the start of an interval, and continuously append new data to the SMF file until the end of the interval. For example, a daily SMF file is created at the start of the day and is continuously updated during the day by the SMF dump process. The most recent generation of the SMF file contains data for the current interval (today). DISP=MOD cycles cover the current interval (up until today).
DISP=OLD
New cycles are created at the end of the interval. For example, a weekly SMF file that is created at the end of the week from the daily SMF files for that week. The most recent generation contains data for the previous interval (last week), not the current interval (this week). Note that a weekly SMF file could also be defined as DISP=MOD if it is being built on a daily basis. DISP=OLD cycles do not cover the current interval. Other cyclic (or Daily) SMF Files are required in this case.
Line Actions: The valid line actions for the Cyclic SMF Files view are:
Display the selection list of line actions
I
Insert a blank row for entry of a related file
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
X
Reverse Exclude Status (CICS PA omits excluded files from report requests)
S
Show a list of the data sets that belong to the GDG base or that match the data set name for this SMF file