LOGGER - System Logger report and extract

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.

Information Information

Feedback


Timestamp icon Last updated: Thursday, 7 November 2013


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