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:
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:
CICS PA uses the System Selection in JCL generation to build the INput(SMFIN001,SMFIN002,SMFIN003,...) operand and corresponding //SMFINnnn DD statements.
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.
CICS PA uses the System Selection in JCL generation to build the INput(SMFIN001,SMFIN002,SMFIN003,...) operand and corresponding //SMFINnnn DD statements.
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.
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.
The default report is the Summary.
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 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.
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.
Line Actions: Valid line actions are:
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:These options generate the LOGSTREAM('name.or.pattern') and STRUCTURE('name.or.pattern') operands.
This option generates the TITLE1('left-half') and TITLE2('right-half') operands.