List report
The following command produces a System Logger List report like
that shown in Figure 1.
CICSPA NOAPPLID,
LOGGER(OUTPUT(LOGR0001),
EXTERNAL(CPAXW001),
LIST,
SORT(LOGSTREAM))
Figure 1. System Logger
List report
CICS Performance Analyzer
System Logger report - List
LOGR0001 Printed at 12:34:56 02/15/2015 Data from 14:00:00:01 5/27/2010 to 14:30:00:12 5/27/2010 Page 1
Logstream name Structure name MVSID Group Flag Interval expired at Level
IYOT1.DFHLOG LOG_JG MV55 PROD Staging 09:00:00.00 6/20/2004 SP7.0.4
----------- IXGWRITES ---------- ---------------- DELETIONS -----------------
Bytes Count Count Bytes Bytes
Writn to With Without After Int Stor
Total Average Interim DASD DASD Offload w/o DASD
Count Bytes Bytes Storage Write Write w. DASD Write
-------- -------- -------- -------- -------- -------- -------- --------
11248 4348827 386 6768128 0 9327 0 3348643
---------------------------------------------------- EVENTS --------------------------------------------------------
Demand Demand Minimum Maximum Staging
Staging DASD Staging Entry Struct Init'd Block Block DS Async
Offloads Threshld Shifts Full Full Full Offloads Length Length Buf Full
-------- -------- -------- -------- -------- -------- -------- -------- -------- --------
3 0 0 0 0 0 0 116 1422 0
----------------------- EVENTS ------------------------- --------------- DASD Writes ----------------
Struct Struct
Rebuilds Rebuilds Total
Type1 Type2 Type3 Init'd Complt'd Count Bytes Average Waits
-------- -------- -------- -------- -------- -------- -------- -------- --------
11216 32 0 0 0 0 0 0 0
____________________________________________________________________________________________________________________________________
Logstream name Structure name Flag MVSID Level
*ALTER RECORD* LOG_JG Staging MV55 SP7.0.2
------------ STRUCTURE ALTER -----------------
SMF record time stamp 19:15:00:23 10/07/2009
Current Current Targeted Struct Log Log
Bytes Average Average Size Data Streams
Written Offloads Bufsz Bufsz (Blocks) Writes Connectd
-------- -------- -------- -------- -------- -------- --------
0 2 768 768 5056 0 0
The following fields are shown on the System Logger List report:
- Logstream Name
- The name of the logstream.
- Structure Name
- The name of the structure.
- MVSID
- MVS™ System ID.
- Group
- GROUP value for this logstream. Either PROD (production) or TEST.
- Flag
- Staging. If the SMF88LFT flag is set, this logstream used
the staging data set during this interval.
Disconnect. If SMF88LDS is on, this SMF record was generated as a result of a logstream disconnect.
- Interval expired at
- The time of day when the current SMF interval expired. Note: When you run the Logger report on a system with a different time zone setting to that of the SMF data, you must specify the ZONE operand to convert the System Logger time stamps from GMT to local time. By default, CICS PA will use the reporting system's time zone settings and the Logger report time stamps will not reflect the local time of the data. Specify ZONE to match the time zone of the SMF data and the Logger report time stamps will reflect the local time of the data.
- Level
- MVS Release level.
Information on IXGWRITES:
- Count
- The number of IXGWRITE requests.
- Total Bytes
- Bytes written by IXGWRITE requests.
- Average Bytes
- The average number of bytes written by IXGWRITE requests.
- Bytes Writn to Interim Storage
- The number of bytes written to interim storage.
Information on DELETIONS:
- Count With DASD Write
- The number of deletes from interim storage written to DASD.
- Count Without DASD Write
- Number of deletes from interim storage without having been written to the log data set.
- Bytes After Offload w. DASD
- Bytes deleted after data was offloaded to DASD log data sets. If SMF88SIB is high and the SMF88SAB is low, CICS® is successfully using interim storage to avoid the I/O incurred by offloading to DASD log data sets.
- Bytes Int Stor w/o DASD Write
- Count of bytes deleted instead of being written to DASD. Due to CICS tail trimming, that is, deletion of records which are no longer required for recovery. It shows how successfully CICS avoids offloads for data that it intends to delete from interim storage.
Information on EVENTS:
- Offloads
- Number of times the log stream was offloaded.
- Staging Threshld
- Number of times system logger detected a Staging Data Set Threshold Hit condition (HIGHOFFLOAD reached) for the staging data set.
- Demand DASD Shifts
- Number of log stream DASD shifts (additional log data set allocates) initiated by this system. For DFHLOG and DFHSHUNT this value should be small, otherwise too much data is being offloaded. (the LS_SIZE parameter for the IXCMIAPU logstream definition utility should be checked).
- Staging Full
- Number of times staging data set was full. The cause of any non-zero condition should be investigated.
- Entry Full
- Number of times all log streams connected to the structure are offloaded by IXLOGR due to 90% of the structure's list entries being full.
- Struct Full
- Number of times a structure full condition was reached. The cause of any non-zero condition should be investigated.
- Demand Init'd Offloads
- Number of demand initiated offloads.
- Staging DS Async Buf Full
- Number of times the system logger detected a Staging Data Set Async Buffer Full condition for this log stream on this system for this SMF interval.
- Minimum Block Length
- Minimum block length. If set to 7FFFFFFF then there was no activity for this interval.
- Maximum Block Length
- Maximum block length.
- Type1
- Type 1 CF event. Normal write. Indicates that, after the write completed, the percentage of resource in use by the structure was less than the high offload threshold, meaning that system logger is using the coupling facility successfully. This number should be high.
- Type2
- Type 2 CF event. Indicates that, after the write completed, the percentage of the logstream in use was greater than or equal to the high off load threshold. This can happen at the point where the offload value is reached or the offload is already in progress.
- Type3
- Type 3 CF event. Indicates that a given log stream is close to consuming 90% of the coupling facility resource allocated to it. A type-3 completion can occur if there is a failure which prevents system logger from promptly moving data from the coupling facility structure to DASD log data sets or if the system logger configuration is tuned incorrectly. For example, system logger's access to its DASD log data sets would be slowed if those data sets reside on the same device as some other heavily-used data sets. A type-3 can also occur if many log streams are defined to share the same structure, because each newly defined log stream causes system logger to dynamically repartition storage among the existing logstreams. If a log stream has a large proportion of type-3 completions, system logger is getting dangerously close to the STRUCTURE FULL condition.
- Struct Rebuilds Init'd
- Number of structure rebuild events initiated for this log stream, as seen by this system. Excessive structure rebuilds should be investigated. Structures are rebuilt in the event of logstream connectivity failure in accordance with the REBUILDPERCENT parameter of the IXCMIAPU utility.
- Struct Rebuilds Compl'd
- Number of structure rebuild events completed for this log stream, as seen by this system. Excessive structure rebuilds should be investigated. Structures are rebuilt in the event of logstream connectivity failure in accordance with the REBUILDPERCENT parameter of the IXCMIAPU utility.
Information on DASD Writes:
- Count
- No. of DASD write requests.
- Total Bytes
- Total bytes written to DASD (offload data sets).
- Average
- Average number of bytes written to DASD (offload data sets).
- Waits
- No. of times System Logger had to suspend processing before writing to DASD because a previous DASD write request had not completed.
Information on STRUCTURE ALTER:
- SMF record time stamp
- The time of day when this SMF record was written.
- Current Bytes Written
- Current WRITTEN-Bytes-Structure. Count of bytes written to the structure on this system.
- Offloads
- The number of offloads that occurred for this structure.
- Current Average Bufsz
- Current allocated average buffer size for the structure.
- Targeted Average Bufsz
- Targeted average buffer size. Average buffer size System Logger attempted to achieve, by altering the element to entry ratio.
- Struct Size (Blocks)
- Structure Size. Represented in the number of 4K blocks.
- Log Data Writes
- Total number of log data writes at the time of the recording interval.
- Log Streams Connectd
- Total number of log streams connected to the structure on this system at the time of the recording interval.