The LOGGER operand requests the System Logger report or extract.
The command format for the System Logger report is:
The command format for the System Logger extract is:
The options are:
- OUTPUT
- Controls the report output DDname. See OUTPUT for further information. If not
specified, CICS PA assigns
a DDname in the format xxxxnnnn where nnnn is the report sequence
number 0001-9999 to uniquely identify the output, and xxxx
is:
- LOGR for the System Logger report.
- LOEX for the Recap report for the System Logger
extract.
- FLOAT
- Write numeric fields in the extract in S390 FLOAT
format.
- EXTERNAL
- Specifies the DDname for the work data set used by the external
sort facility. If not specified, CICS PA assigns
an External Work File from a pool of External Work Files with DDnames
in the format CPAXWnnn where nnn is the sequence number 001-999. See EXTERNAL for further information.
- SUMMARY
- Requests the System Logger Logstream Summary and Structure Summary
reports. This is the default.
To present a single summary
of records for the entire reporting period, omit the optional SUMMARYINTERVAL suboperand
(this is the default). To summarize records at intervals within the
reporting period, specify SUMMARYINTERVAL with 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 SUMMARYINTERVAL,
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.
- LIST
- Requests the System Logger List report, a detailed list of Logstream
writes, Logstream deletes, and Logstream events.
Specify ALTER to
also report Structure Alter events. These apply to Structures, not
individual Logstreams, and are reported with a Logstream name of *ALTER*.
By default, the List report entries are printed in Logstream
or Structure name sequence according to the SORT operand. However,
by specifying TIMESEQ, the entries are printed in Logstream
or Structure name sequence within each Interval expiry period.
- INTERVAL
- Specifies
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.
- SORT
- Specifies the sort sequence for the List and Summary reports.
Specify LOGSTREAM to sort by Logstream name, MVS™ ID, Structure name, then time stamp.
This is the default.
Specify STRUCTURE to sort by Structure
name, Logstream name, MVS ID,
then time stamp.
- LOGSTREAM
- Optional
filter on Logstream name. Specify a name or pattern enclosed in quotes.
Masking characters % and * are allowed. The percent
(%) is for a single character substitution and the asterisk (*) is
for many or none. For example:
- LOGSTREAM('TEST.DFHLOG')
- must match exactly
- LOGSTREAM('PROD.*')
- can match PROD.DFHLOG
- LOGSTREAM('PROD.MVSA%')
- can match PROD.MVSA1, but not PROD.MVSA1LOG
- STRUCTURE
- Optional filter on Structure name. Specify a name
or pattern enclosed in quotes. Masking characters % and * are
allowed. For example:
- STRUCTURE('TEST.DFHLOG')
- must match exactly
- STRUCTURE('PROD.*')
- can match PROD.DFHLOG
- STRUCTURE('PROD.MVSA%')
- can match PROD.MVS1, but not PROD.MVS1LOG
- TITLE1, TITLE2
- Controls the report title (left and right half of subheading line).
See TITLE1 and TITLE2 for further information.
- SELECT(LOGGER(INCLUDE|EXCLUDE
- Specifies
what data to include or exclude from the report or extract based on
data field values. See Using SELECT statements for
an explanation and examples.