Take-up from SMF File

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.

Take-up of Shared Systems from an SMF File optionally performs the following functions:
  1. Defines new shared systems, including CICS®, DB2®, MQ, Logger, and Images
  2. Defines Daily SMF Files, and associates them to either Systems with data on the file or its MVS™ Image

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".

Figure 1. Shared System Definitions: Take-Up from SMF File
   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

Take-up options

The take-up options are:
Data Set Name
The name of an SMF data set from which you want to extract System details for automatic take-up into your System Definitions. Normal ISPF data set conventions apply. Data Set Name and Log Stream are mutually exclusive. This option generates the IN keyword.
Log Stream
The name of an SMF log stream from which you want to extract System details for automatic take-up into your System Definitions. The first qualifier must be IFASMF. The log stream name must not be enclosed in quotes. Data Set Name and Log Stream are mutually exclusive. This option generates the IN keyword.
RETPD
The log stream retention period, specified in days (0-65536). This value is used to calculate a start date for determining what records are candidates for take-up processing.
Required Definitions
The following options apply to both SMF files and log streams.
Systems
Select Systems to take-up all the CICS systems and related subsystems with data on the SMF File are defined to shared system definitions. Existing system definitions are not replaced. This option generates the SYSTEMS keyword.
Files
Select Files to take-up the specified SMF File. The specified SMF File is registered as a Daily SMF File and connected to the systems that have SMF records on the file.

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:

1. System
Connects the Daily SMF file to all systems with SMF records on the file, including CICS, DB2, MQ, and Logger, as well as the MVS Image that owns the file.

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.

2. Image
Connects the Daily SMF file only to the MVS Image that owns the file. CICS and other subsystems that belong to the Image can request the selection of their SMF files from the Image if they do not have their own Daily SMF Files.

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.

System Selection
System Selection is used to filter the records processed by take-up in order to minimize the processing time. These options apply to both log streams and data sets.
Image
Use to specify the image (MVSID) for which SMF records will be processed by take-up. Records for all other images will be ignored. Only one image name can be specified. Wildcard characters are not supported. Mutually exclusive with Group.
Group
Specifies a group containing one or more image definitions. Used when records for more than one image are required for take-up. Mutually exclusive with Image. Only systems whose Type=Image in the group are used. Other types are ignored. Group is not allowed when the DASDONLY profile option is selected.
Types
System types to be taken up. This option is used to generate a list of SMF record codes.
SMF Interval
The interval of SMF records to process from the log stream or data set. SMF Interval is mandatory for log streams but optional for data sets.

These fields generate the SMFSTART and SMFSTOP operands.

Example: choosing between System and Image

Consider the following example to help you choose between the System option (FILESYSTEM) and the Image option (FILEIMAGE).

Take-up is run against two daily SMF files for Image MVS1:
  1. DAILY.SMF(0) contains data for CICS systems CICS1 and CICS2
  2. DAILY.SMF(-1) contains data for CICS systems CICS2 and CICS3

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.

TAKEUP command syntax

The take-up command is:
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

Information Information

Feedback


Timestamp icon Last updated: Thursday, 7 November 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic//users-guide/shrsdtakeup.htm