The LOGGER operand requests the System Logger report or extract.
The command format for the System Logger report is:
CICSPA LOGGER(
[OUTPUT(ddname),]
[EXTERNAL(ddname),]
[SUMMARY[(SUMMARYINTERVAL(hh:mm))],]
[LIST[(ALTER,TIMESEQ)],]
[INTERVAL(minutes),]
[SORT(LOGSTREAM|STRUCTURE),]
[TITLE1('...up to 64 characters...'),]
[TITLE2('...up to 64 characters...'),]
[SELECT(LOGGER(INCLUDE|EXCLUDE(field1(values1),...), ...))]
[LOGSTREAM('name.or.pattern'),]
[STRUCTURE('name.or.pattern'),])
The command format for the System Logger extract is:
CICSPA LOGGER(
[OUTPUT(ddname),]
[DDNAME(ddname),]
[DELIMIT('field-delimiter'),]
[LABELS|NOLABELS,]
[FLOAT,]
[SELECT(LOGGER(INCLUDE|EXCLUDE(field1(values1),...), ...))]
[LOGSTREAM('name.or.pattern'),]
[STRUCTURE('name.or.pattern'),])
The DDname can be up to 8 alphanumeric characters, with the first non-numeric. The CICS PA dialog assigns DDnames in the format CPAOEXnn where nn is the extract sequence number 01-99. (See the sample JCL in JCL for generating CICS PA reports and extracts (part 1 of 2)).
NOLABELS indicates that CICS PA is not to write a field labels record to the extract data set.
Specify FLOAT format if you plan to import the extract into a DB2® table. When the DB2 Load Utility is used, it will interpret all numerical fields reliably and consistently in FLOAT format.
If FLOAT is not specified, the numeric fields are written in a mixture of integer, real and exponential using character digits. This is the default and is suitable when importing the extract data into a PC spreadsheet tool.
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.
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.
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.
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.