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:
- System Logger List. This report shows information on Logstream writes, deletes, and events, as well as Structure Alter events for each SMF recording interval.
- 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.
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.
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.
- 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.
- 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.
- 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.