Option 4 Take-up from SMF File from the Shared System Definitions Menu provides the facility to take-up system and file information from one SMF File.
Data Take-up from SMF File is a two-step process. First the system details are extracted from the file, then they are used to automatically update your Shared System Definitions. Successful completion of the first step generates a Recap report that provides information about all the systems contained on the SMF Files.
Because log streams can contain very large amounts of
data, you can specify a time interval to limit the number of SMF records
that must be processed. SMF Interval is mandatory for log streams
but optional for data sets. To further improve the performance of
take-up processing, the panel also includes options to specify Image
and System types.
If system definition take-up finds CICS TS and CICS TG systems with the same APPLID, it creates a single CICS system definition. System definitions taken up from SMF 111 records have a blank VRM field value (this field is for CICS TS versions, not CICS TG versions). To help distinguish CICS TS systems from CICS TG systems, definitions taken up from SMF 111 records have the description "CICS TG system added by Take-up".
File Options Help -------------------------------------------------------------------System Definitions Take-Up
Command ===> _____________________________________________________ Specify the DSN
or Log stream
for system take-up. Data Set Name . . 'CICSPA.LOGGER.SMFDATA1'______________________
Log Stream . . . ________________________________________ RETPD _____
Required Definitions: Connect files to: / Systems 2 1. System / Files 2. Image
System Selection: ─────── SMF Interval ───────
![]()
Image . . ________ + YYYY/MM/DD HH:MM:SS.TH
![]()
Group . . ________ + From __________ ___________
![]()
Type . . _ CICS _ DB2 To __________ ___________
![]()
_ MQ _ Logger
![]()
Recap Report: Enter "/" to select option
![]()
DDname . . . SDTU0001 / Edit JCL before submit
F1=Help F3=Exit F6=Resize F12=Cancel
The Connect files to setting is only applicable when the Files option is selected. This setting specifies the type of systems the Daily SMF File is to be connected to:
The System option generates the FILESYSTEM keyword. This option ensures that, while the daily SMF file is defined to multiple systems, only SMF files that actually contain data for this system are connected to this system.
The Image option generates the FILEIMAGE keyword. This option ensures that the SMF File is only defined once, and is shared by all systems that belong to the Image.
For more information, see Example: choosing between System and Image.
These fields generate the SMFSTART and SMFSTOP operands.
Consider the following example to help you choose between the System option (FILESYSTEM) and the Image option (FILEIMAGE).
The SYSTEMS option will define the three CICS systems: CICS1, CICS2 and CICS3, and one image MVS1.
FILEIMAGE defines both SMF files to image MVS1. All three CICS systems are eligible to use both files because each system belongs to image MVS1. The drawback is that CICS3 has no data on generation 0, and CICS1 has no data on generation –1. But at report submission time, CICS PA has no way of knowing which image file has data for the selected system, so both files are selected. For example, reporting against CICS1 will select both files, even though generation –1 contains no relevant data.
FILESYSTEM defines the SMF file to image MVS1, and also defines it to each CICS system that has data on the file. CICS1 has one daily SMF file definition only, generation 0. Now at report submission time, CICS PA will select only generation 0. The drawback is that the file is defined to multiple systems. But this is not really a problem because daily SMF file maintenance is handled automatically by HDB housekeeping which deletes expired daily SMF file definitions, and the dialog itself which ignores expired daily SMF files.
CICSPA SMFSTART(YYYY/MM/DD,hh:mm:ss.nn),
SMFSTOP(YYYY/MM/DD,hh:mm:ss.nn)
CICSPA IN(ddname|logstream),
[MVSID(mvsids),]
TAKEUP(SHARED, analyze SMF file contents
[SYSTEMS,] load systems
[FILEIMAGE|FILESYSTEM,] load files, connect to either image or system
[TYPE(CICS,|DB2,|MQ,|LOGGER),]
[RETPD(0-65536),]
[OUTPUT(ddname)]) DDname for Recap report output