System Logger report

The System Logger report processes System Logger (SMF 88) records to provide information on the System Logger logstreams and coupling facility structures that are used by CICS® Transaction Server for logging, recovery and backout operations. The report can assist with measuring the effects of tuning changes and identifying Logstream or Structure performance problems.

You can request two reports:

  1. System Logger List. This report shows information on Logstream writes, deletes, and events, as well as Structure Alter events for each SMF recording interval.
  2. System Logger Summary. This report summarizes Logstream and Structure statistics so you can measure Logger performance over a longer period of time.

These reports, when used in conjunction with the CICS Logger reports produced from the standard CICS statistics reporting utilities, provide a comprehensive analysis of the logstream activity for all your CICS systems.

To request a report, enter line action S against the System Logger System Report on the Report Set panel. If reports of this type have been previously specified, the list of System Logger Reports is displayed. Otherwise, the System Logger Report panel is displayed for you to define your first report of this type.

Figure 1. System Logger Reports
   File  Filter  Edit  Systems  Options  Help
 ------------------------------------------------------------------------------
                        SAMPLE - System Logger Reports             Row 1 from 1
 Command ===> ________________________________________________ Scroll ===> ____
 
         ---- System Selection -----             Selection
 /  Exc  Logger +  Image +  Group +   Output     Criteria
 _       CICSP001  MVS1____ ________  LOGR0001     NO
 ********************************* End of list *********************************
 

This panel displays the list of System Logger Reports in this Report Set. You can select (edit), delete, or include/exclude any report, insert new ones, or rearrange them (move/copy).

The options are:

System Selection
System Selection identifies the System Logger(s) and associated SMF files you want to report against. Any combination of Logger, Image, or Group can be specified but must be defined in System Definitions. You can use Prompt (F4) to select from a list. To link directly to System Definitions, select Systems in the action bar.
Specify either:
  • A Logger.
  • A Logger for a particular Image. This identifies a particular System Logger when there is more than one with the same ID.
  • An Image. CICS PA will report on all systems running on this Image using the SMF files defined for the Image.
  • A Logger and Image combination plus a Group. This is useful to uniquely identify a system when there is more than one of the same name defined in System Definitions.
  • A Group alone. CICS PA will report on all System and Image combinations in the Group to produce a single consolidated report.

CICS PA uses the System Selection in JCL generation to build the INput(SMFIN001,SMFIN002,SMFIN003,...) operand and corresponding //SMFINnnn DD statements.

Output
CICS PA provides a default Report Output DDname in the format LOGRnnnn where nnnn is 0001-9999.

The line actions are the same as on similar Reports list panels. See Performance List report.

To display the System Logger Report panel, enter line action S against the System Logger Performance Report on the Report Set panel, then if the list of previously specified reports is displayed, enter line action S against a particular report in the list.

Figure 2. System Logger Report
   File  Systems  Options  Help
 ------------------------------------------------------------------------------
                         SAMPLE - System Logger Report
 Command ===> _________________________________________________________________
 
 System Selection:                       Report Output:
  Logger . . CICSP001  +                  DDname . . . . . . . . . LOGR0001
  Image  . . MVS1____  +
  Group  . . ________  +
 
Reports Required:                       Ordering Options:                   
 _  List                                 1  1. Sort by Logstream Name       
    _  Include ALTER records                2. Sort by Structure Name       
    _  Sort by Time                                                         
 /  Summary                             SMF Options:                        
    Interval  . . . _____  (hh:mm)       Recording Interval . . __  (mins)  
                                                                            
Report Format:                                                              
 Title  . . ________________________________________________________________
            ________________________________________________________________
                                                                            
Selection Criteria:                                                         
 _  Logger                                                                 
    Logstream Name . . . __________________________                           
    Structure Name . . . ________________                                     

Use this panel to specify report options for the System Logger report. The report format is fixed. The only mandatory options are the DDname for the report output and the Sort order. You can let the other options default. Note that you cannot control the number of print lines per page for the System Logger Report. In addition to filtering by Logstream or Structure name or both, you can also filter records from processing by specifying selection criteria.

The options are:
System Selection
System Selection identifies the System Logger(s) and associated SMF files you want to report against. Any combination of Logger, Image, or Group can be specified but must be defined in System Definitions. You can use Prompt (F4) to select from a list. To link directly to System Definitions, select Systems in the action bar.
Specify either:
  • A Logger.
  • A Logger for a particular Image. This identifies a particular System Logger when there is more than one with the same ID.
  • An Image. CICS PA will report on all systems running on this Image using the SMF files defined for the Image.
  • A Logger and Image combination plus a Group. This is useful to uniquely identify a system when there is more than one of the same name defined in System Definitions.
  • A Group alone. CICS PA will report on all System and Image combinations in the Group to produce a single consolidated report.

CICS PA uses the System Selection in JCL generation to build the INput(SMFIN001,SMFIN002,SMFIN003,...) operand and corresponding //SMFINnnn DD statements.

Report Output DDname
The DDname for the report output which CICS PA uses when generating the JCL to run the Report Set. The DDname is mandatory and should be unique to separate the output of multiple reports.

CICS PA assigns a default DDname LOGRnnnn where nnnn is a sequential number 0001-9999 to ensure each report has a unique DDname.

This option generates the OUTPUT(ddname) operand.

Reports Required
Enter / to select the reports you want produced.
  • Select List to request the System Logger List report, a list of all Logger interval records in the SMF File. This selection generates the LIST operand.

    You can also select Include ALTER records to include Structure Alter events in the report. These apply to Structures, not individual Logstreams, and are reported with a Logstream name of *ALTER*. This selection generates the LIST(ALTER) operand.

    By default, the List report entries are printed in Logstream or Structure name sequence, depending on the Report Option selected. However, by selecting the Sort by Time option, the entries are printed in Logstream or Structure name sequence within each Interval expiry period. This selection generates the LIST(TIMESEQ) operand.

  • Select Summary to request the System Logger Logstream Summary and Structure Summary reports. (A summary of ALTER activity is not included.) This selection generates the SUMMARY operand.

    The default report is the Summary.

    Summary Interval
    To present a single summary of records for the entire reporting period, leave this field blank (this is the default). To summarize records at intervals within the reporting period, enter a multiple of the SMF reporting interval, from 00:01 to 23:59. For example, if the SMF reporting interval was 5 minutes at the time that the logger records were written, then you can generate a System Logger Summary report that summarizes the logger records at any multiple of 5 minutes: 05:00, 10:00, 15:00 etc.

    If you specify a Summary Interval, then ensure that the value you specify is an exact multiple of the SMF reporting interval. Otherwise, each of the summaries in the report might not be calculated from the same number of records.

    This option appends a SUMMARYINTERVAL(hh:mm) suboperand to the SUMMARY operand.

Ordering Options
The sort sequence for the System Logger List and Summary reports.

Select option 1 to sort by Logstream name, MVS™ ID, Structure name, then time stamp. This is the default. This selection generates a SORT(LOGSTREAMNAME) operand.

Select option 2 to sort by Structure name, Logstream name, MVS ID, then time stamp. This selection generates a SORT(STRUCTURENAME) operand.

SMF Options: Recording Interval
The SMF global recording interval as specified in the INTVAL parameter of the SMFPRMnn PARMLIB member.

Specify an interval from 1 to 60 minutes. If not specified, CICS PA uses the recording interval in effect on the reporting system. The interval value is used by CICS PA for rate per second calculations in the System Logger Summary reports. If the interval used by CICS PA does not match the data, the total interval and rate calculations will be incorrect.

This option generates the INTERVAL(minutes) operand.

Selection Criteria
To specify Selection Criteria to filter the System Logger records on time period and other field values, enter S next to Logger.

Line Actions: Valid line actions are:

Display the menu of line actions.
S
Select to display the subpanel where Selection Criteria for this extract can be specified. See Specifying Selection Criteria for a discussion on how to do this.
A
Activate the Selection Criteria so they are generated for this extract when the Report Set is submitted. Selection Criteria can only be activated if one or more Select Statements are specified and not all are excluded. An asterisk * indicates they are active.
D
Deactivate the Selection Criteria. Any you have specified here will not be used.

CICS PA JCL generation translates Selection Criteria to the SELECT(LOGGER operand.

Optionally, specify the Logstream Name and Structure Name patterns to be reported. Masking characters % and * are allowed. Examples of possible patterns are:
TEST.DFHLOG
which must match exactly
PROD.*
which can match PROD.DFHLOG
PROD.MVSA%
which can match PROD.MVSA1, but not PROD.MVSA1LOG

These options generate the LOGSTREAM('name.or.pattern') and STRUCTURE('name.or.pattern') operands.

Title
Title of the report. Specify up to 128 characters of text to describe the report. CICS PA concatenates the two lines of 64 exactly as entered to make one line which prints at the top of each page of the report below the heading. The default is blank (no title).

This option generates the TITLE1('left-half') and TITLE2('right-half') operands.


Information Information

Feedback


Timestamp icon Last updated: Friday, 8 February 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic//syslogr.htm