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 . . . ________
VRM . :
Description . . . . . . ** New CICS system **_______________
System View:
2 1.
Attributes
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, so these examples 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